A DOM Builder plugin for jQuery
_ ____ __ _ __ __ (_) __ \__ _____ _______ __ / /_ __ __(_) /____/ / / / / / / / / / _ \/ ___/ / / / / __ \/ / / / / // __ / / / /_/ / /_/ / __/ / / /_/ /_ / /_/ / /_/ / / // /_/ / __/ /\___\_\__,_/\___/_/ \__, /(_)_.___/\__,_/_/_/ \__,_/ v1_0_2 /___/ /____/ -----------------------------------------------------------------------
A DOM Node builder for jQuery in the spirit of Scriptaculous Builder.node
- Flexible syntax enables chaining and nesting of DOM nodes and bindings, inline assignments.
- Elminates the need to re-query the DOM for dynamically created nodes.
- Uses standard CSS conventions for classNames, ids, attributes.
- Works well in IE 6+ and all modern browsers. Contains no browser version sniffing, only capability testing.
- Good set of tests that can be run from either browsers or node.js.
- MIT Licensed.
var $b = $build;var elem = $b"#usernameWrapper"$b"label[for=username]" "Enter your username"$b"input#username[type=text]"$b"button[type=button]" "Save"clickalert"hey";;
This generates a jQuery wrapped DOM node in the elem variable with the HTML content:
Enter your usernameSave
Additionally, the button element has a click handler bound to to it.
The return of each call to $.build is a jQuery object, which makes all kinds of fun function chaining possible. This is an overly simple example, though, and doesn't show much of the power and flexibility of the syntax. For more in-depth code samples and use cases see the examples and tests folders.
##Using in the browser
- Make sure you have jQuery inlcuded on your page
- Include a
- The jQuery.build function can be accessed from then on.
For an example, see
##Using inside of Node.js
This can be run server-side in node.js when used with a dom implmentation like jsdom. Take a look at the tests for an example of doing this.
You can install with
npm install jquery.build
You can run the tests with
##License: Copyright (c) 2011 Ian Taylor
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.