vue-y-tree
v0.1.3
Published
yet another flexible tree component for vue
Downloads
11
Readme
vue-y-tree
Yet another tree component for vue
Demo
Install
vue-y-tree
is a UMD
module, it means:
- you can use it as an npm package
- or you can load it directly in browser, and access it with the global variable
VueTree
npm install vue-y-tree
Usage
<body style="background: #fff">
<div>selected: {{ text }}</div>
<hr/>
<tree :tree="tree" :display-args="args" @tree-select="onSelect"></tree>
</body>
// directly used in browser
// var yTree = VueTree.yTree;
var yTree = require('vue-y-tree').yTree;
new Vue({
el: 'body',
components: {
tree: yTree
},
methods: {
onSelect: function (data) {
this.text = data;
}
},
data: function () {
return {
text: 'none',
tree: {
value: 'level 1',
children: [
{
value: 'level 2 A'
},
{
value: 'level 2 B',
children: [
{ value: 'level 3 A'},
{ value: 'level 3 B'},
{ value: 'level 3 C'}
]
}
]
},
args: {
valueToString: x => x
}
}
}
})
Tips
Two vue components are exported in vue-y-tree
:
- xTree
- the more general tree component, including recursive render, fold/unfold and select, but without any css
- yTree
- wrap
xTree
with a little more fancy display
- wrap
xTree
is implemented with flexibility. It is all about how to interact with a tree, but it doesn't care how to display your tree node. You can pass in your own component to display whatever exists in your tree data (checkout the dom tree demo).
Use yTree
if you just want to display normal text in each tree node, while it is recommended to use xTree
if you have a complex data structure and want to customize the display.
Props
xTree
Name | type | required | default | Description ----- | ----- | ----- | ----- | ----- tree | Object | true | | tree data to be rendered childrenName | String | false | 'children' | the children key in the tree data valueName | String | false | 'value' | the children key in the tree data idName | String | false | | the key to determine whether one node is selected, could be omitted. If omitted, all nodes will be assigned a unique id. isFold | Boolean | false | false | whether a tree is folded in the first place isSelected | Boolean | false | false | where a tree is selected in the first place displayComponent | Object | false | | the Component to display tree value displayArgs | Object | false | | extra args to be passed to displayComponent extraClass | String | false | | extra class to be added on the root element, use it for your own css treeStyle | Object | false | {} | customized inline style for the tree
displayComponent
Your customized displayComponent
will get the following props:
Name | type | Description ----- | ----- | ----- | ----- | ----- value | Object, String | the value to be displayed toggleFold | Function | (no args) the method to fold/unfold the whole tree select | Function | (no args) the method to select the tree node isRoot | Boolean | whether the node is a root node or not isFold | Boolean | whether the node is folded or not isSelected | Boolean | whether the node is selected or not hasChildren | Boolean | whether the node has children or not args | Object | the extra args passed from xTree's displayArgs
yTree
props of yTree
is almost the same as xTree, expect that there is no more displayComponent
. yTree has already set the displayComponent
for you, all you need is to pass in the displayArgs
. so, let's get some insights of the displayArgs
for yTree
.
var displayArgs = {
// a function turning tree value to string text to display
valueToString: function (value) {
return some_function(value);
},
// a display component that accept tree value as props
valueToDisplay: component
}
valueToDisplay
Your customized valueToDisplay
will get the following props:
Name | type | Description ----- | ----- | ----- | ----- | ----- value | Object, String | the value to be displayed select | Function | (no args) the method to select the tree node isRoot | Boolean | whether the node is a root node or not isFold | Boolean | whether the node is folded or not isSelected | Boolean | whether the node is selected or not hasChildren | Boolean | whether the node has children or not
Dev
# install dependencies
npm install
# serve with hot reload at localhost:8080
npm run dev
# build for production with minification
npm run build
Licence
MIT