Rivets.js is a declarative data binding facility that plays well with existing frameworks such as Backbone.js, Spine.js and Stapes.js. It aims to be lightweight (2.3KB minified and gzipped), extensible, and configurable to work with any event-driven model.
Rivets.js keeps your UI and model data in sync for you, so you can spend less time manually tying into the DOM and more time on your actual data and application logic.
Out-of-the-box it’s got:
- One-way and two-way binding to/from DOM elements.
- Computed properties with dependent attributes.
- Formatters to allow mutatating values through piping.
- A powerful custom bindings API for building your own binding routines.
- Easy debugging and manual bidirectional syncing of bindings.
Getting Started and Documentation
Building and Testing
Make sure to run npm install so that you have all the development dependencies. To have the test suite run as part of the build process, you'll also need to have PhantomJS installed.
Rivets.js uses grunt as the build tool. Run
grunt build from within the project root to compile + minify the source into /lib, or just run
grunt to have it watch the source file for changes — it will compile + minify into /lib and run the test suite whenever the source file is saved.
Rivets.js uses Jasmine as the testing framework. You can run the test suite with
grunt spec or by opening /spec/index.html.
- Ensure the bug can be reproduced on the latest master release.
- Open an issue on GitHub and include an isolated JSFiddle demonstration of the bug. The more information you provide, the easier it will be to validate and fix.
- Fork the repository and create a topic branch.
- Be sure to associate commits to their corresponding issue using
[Closes #1]if the commit resolves the issue.
- Make sure not to commit any changes under
lib/as they will surely cause merge conflicts with other's changes. Files under
lib/are only committed when a new build is released.
- Include tests for your changes and make them pass.
- Push to your fork and submit a pull-request with an explanation and reference to the issue number(s).