$dom was coded by Keith Clark and was once available at http://www.keithclark.co.uk/$dom/.
The project is currently in maintainance mode. No new code is currently developed. However, since the library was developed with standards in mind, it's future-compatible and should work in all current browsers.
Which version to download ?
dollardom.js is always the most up to date version. I consider that is
is pretty good quality, which means that I still find bugs myself, but
that I feel it can be used on real web sites or web applications. Please
report any bug you find.
I'll try to keep
dollardom.min.js (minified with
uglifyjs) in sync but
take attention to the timestamp to be sure.
If you want animation support, include either both
or their concatened/minified version
Please note however that nowadays, you should consider doing simple
animations with CSS transitions. For your more complex needs you can also
have a look to SVG.
If you want try the new jQuery-like simpler chaining API, you can use
Since it is newer than the normal API, it
could have some bugs. Please consider this syntax beta-quality.
A debug version is also available:
dollardom-full.debug.js. Using this
version during development makes you certain you use dollardom
correctly, because otherwise you'll get exceptions.
Please note that this version is not yet finished and some
$dom functions are not checked yet.
I used $dom in a project and wanted to fix one bug. Moreover Keith Clark stopped maintaining this code and I felt it is still useful nowadays.
I asked him where I could find the original source code (since only the minified/obfuscated code was available on his website) and he kindly sent it to me.
Why $dom ? There are lots of other very good libraries outthere
That's right. For big projects, you can use jQuery, Dojo, ExtJS, Mootools, etc. For mobile projects, there are jQuery Mobile, jqtouch, Sencha touch, Zepto.js, xui.js. But please read further.
$dom features the following strong points:
- it's small: 2.3 kB for the minified/gzipped version (compare with jQuery's size: 30kB)
- it's general: it's not mobile-only or desktop-only. It's perfect for mobile-first or responsive design, which should run on a variety of very different devices.
- the syntax is clean. Compare:
$("<div id='myDiv' class='class1 class2'>"); // jQuery
$dom.create("div#myDiv.class1.class2"); // $dom.
- it doesn't include the features you don't need, e.g. Array iteration
reduce, etc.) or Ajax. There are perfectly good polyfills outthere.
- Good documentation
- Permissive BSD-like license
- there is a debugging version to help you use the library correctly.
It has also of course some weak points, because we can't have it all:
- it is certainly slower than alternatives like jQuery. However, on real websites, we should never have 10000 nodes. If you have, then this is not the right tool. We will never support such use cases.
- it can't animate to relative value units like
- the syntax is not jQuery-compatible, which means you have to learn a new syntax. I suggest you have a look to the $dom chaining API which is cleaner and simpler than the legacy API.
Is there an alternative ?
ender.js could be a good alternative with its modular approach. One of our goals is to integrate better with this tool.
The build script needs uglifyjs and node.
On Debian-like systems, these could most probably be installed with the command :
aptitude install libnode-uglify
- write more tests
- document the chaining API
- write more examples
- support attribute selector
- add more assertion to the debug version
- add the files to integrate with ender.