tbtree
v0.4.0
Published
A tree control for twitter bootstrap.
Downloads
4
Readme
TBTree
A tree control for twitter bootstrap.
WARNING:This plugin is very much "alpha" and contains a number of hard-coded things that will change over time. Use at your own risk!
Dependencies
- Twitter Bootstrap
- jQuery
- underscore.js
- require.js (optional)
Features
- displays data from an object literal as an expandable/collapsable tree
- fires a custom event whenever a list item is clicked
- looks like a Twitter Bootstrap control!
More features coming soon.
Usage
Assuming you have some data in a regular object literal structure:
var books = {
'Science Fiction': [
{
title: 'Dune',
author: 'Frank Herbert',
rating: '5/5'
},
{
title: "Ender's Game",
author: 'Orson Scott Card',
rating: '5/5'
}
]
}
and assuming you have some DOM element where you want your tree to appear:
<div id="book-tree"></div>
the tree is initialized in code (probably in a jquery ready()
callback) like this:
var tree = tbtree('#book-tree').load(books);
The only event currently supported is 'highlighted', which may be subscribed to like this:
tree.on('highlighted', function (e) {
// where 'e' is a custom object
// that will have some data related
// to the list item that was selected
console.log(e.path);
});
Of course, you can always subscribe to events via jQuery like normal:
$('#book-tree').on('click', 'li', function (e) {
// a list element was clicked
});