ant-design-vue/components/tree/index.en-US.md

76 lines
5.6 KiB
Markdown
Raw Normal View History

2018-04-13 10:58:58 +00:00
## API
### Tree props
| Property | Description | Type | Default |
| -------- | ----------- | ---- | ------- |
2018-09-29 07:24:47 +00:00
| treeData | treeNode of tree, please use `treeNodes` before v1.1.4 | array | - |
2018-04-13 10:58:58 +00:00
| autoExpandParent | Whether to automatically expand a parent treeNode | boolean | true |
| checkable | Adds a `Checkbox` before the treeNodes | boolean | false |
| checkedKeys(v-model) | (Controlled) Specifies the keys of the checked treeNodes (PS: When this specifies the key of a treeNode which is also a parent treeNode, all the children treeNodes of will be checked; and vice versa, when it specifies the key of a treeNode which is a child treeNode, its parent treeNode will also be checked. When `checkable` and `checkStrictly` is true, its object has `checked` and `halfChecked` property. Regardless of whether the child or parent treeNode is checked, they won't impact each other. | string\[] \| number\[] \| {checked: string\[] \| number\[], halfChecked: string\[] \| number\[]} | \[] |
2018-04-13 10:58:58 +00:00
| checkStrictly | Check treeNode precisely; parent treeNode and children treeNodes are not associated | boolean | false |
| defaultCheckedKeys | Specifies the keys of the default checked treeNodes | string\[] \| number\[] | \[] |
2018-04-13 10:58:58 +00:00
| defaultExpandAll | Whether to expand all treeNodes by default | boolean | false |
| defaultExpandedKeys | Specify the keys of the default expanded treeNodes | string\[] \| number\[] | \[] |
2018-04-13 10:58:58 +00:00
| defaultExpandParent | auto expand parent treeNodes when init | bool | true |
| defaultSelectedKeys | Specifies the keys of the default selected treeNodes | string\[] \| number\[] | \[] |
2018-04-13 10:58:58 +00:00
| disabled | whether disabled the tree | bool | false |
| draggable | Specifies whether this Tree is draggable (IE > 8) | boolean | false |
| expandedKeys(.sync) | (Controlled) Specifies the keys of the expanded treeNodes | string\[] \| number\[] | \[] |
2018-04-13 10:58:58 +00:00
| filterTreeNode | Defines a function to filter (highlight) treeNodes. When the function returns `true`, the corresponding treeNode will be highlighted | function(node) | - |
| loadData | Load data asynchronously | function(node) | - |
| loadedKeys | (Controlled) Set loaded tree nodes. Need work with `loadData` | string\[] \| number\[] | \[] |
2018-04-13 10:58:58 +00:00
| multiple | Allows selecting multiple treeNodes | boolean | false |
| selectedKeys(.sync) | (Controlled) Specifies the keys of the selected treeNodes | string\[] \| number\[] | - |
2018-04-13 10:58:58 +00:00
| showIcon | Shows the icon before a TreeNode's title. There is no default style; you must set a custom style for it if set to `true` | boolean | false |
2019-04-10 05:28:07 +00:00
| switcherIcon | customize collapse/expand icon of tree node | slot(vnode) | - |
2018-04-13 10:58:58 +00:00
| showLine | Shows a connecting line | boolean | false |
2018-04-14 13:09:35 +00:00
### Events
| Events Name | Description | Arguments |
| --- | --- | --- |
2018-09-28 13:31:58 +00:00
| check | Callback function for when the onCheck event occurs | function(checkedKeys, e:{checked: bool, checkedNodes, node, event}) |
2019-02-22 13:49:06 +00:00
| dragend | Callback function for when the onDragEnd event occurs | function({event, node}) |
| dragenter | Callback function for when the onDragEnter event occurs | function({event, node, expandedKeys}) |
| dragleave | Callback function for when the onDragLeave event occurs | function({event, node}) |
| dragover | Callback function for when the onDragOver event occurs | function({event, node}) |
| dragstart | Callback function for when the onDragStart event occurs | function({event, node}) |
2018-09-28 13:31:58 +00:00
| drop | Callback function for when the onDrop event occurs | function({event, node, dragNode, dragNodesKeys}) |
| expand | Callback function for when a treeNode is expanded or collapsed | function(expandedKeys, {expanded: bool, node}) |
| load | Callback function for when a treeNode is loaded | function(loadedKeys, {event, node}) |
| rightClick | Callback function for when the user right clicks a treeNode | function({event, node}) |
| select | Callback function for when the user clicks a treeNode | function(selectedKeys, e:{selected: bool, selectedNodes, node, event}) |
2018-04-13 10:58:58 +00:00
### TreeNode props
2018-04-14 13:09:35 +00:00
One of the Tree `treeNode` prop for describing the tree's node, TreeNode has the same API.
2018-04-13 10:58:58 +00:00
| Property | Description | Type | Default |
| -------- | ----------- | ---- | ------- |
2018-04-14 13:09:35 +00:00
| class | className | string | - |
| style | style | string\|object | - |
2018-04-13 10:58:58 +00:00
| disableCheckbox | Disables the checkbox of the treeNode | boolean | false |
| disabled | Disables the treeNode | boolean | false |
2018-04-14 13:09:35 +00:00
| icon | customize icon. When you pass component, whose render will receive full TreeNode props as component props | slot\|slot-scope | - |
2018-04-13 10:58:58 +00:00
| isLeaf | Determines if this is a leaf node(effective when `loadData` is specified) | boolean | false |
| key | Used with (default)ExpandedKeys / (default)CheckedKeys / (default)SelectedKeys. P.S.: It must be unique in all of treeNodes of the tree! | string \| number | internal calculated position of treeNode |
2018-04-13 10:58:58 +00:00
| selectable | Set whether the treeNode can be selected | boolean | true |
2018-04-14 13:09:35 +00:00
| title | Title | string\|slot\|slot-scope | '---' |
| slots | When using treeNodes, you can use this property to configure the properties that support the slot, such as `slots: { title: 'XXX'}` | object | - |
| scopedSlots | When using treeNodes, you can use this property to configure the properties that support the slot-scope, such as `scopedSlots: { title: 'XXX'}` | object | - |
| on | When using treeNodes, you can use this property to configure the events, such as `on: { click: () => {}}` | object | - |
2018-04-13 10:58:58 +00:00
2018-09-28 13:31:58 +00:00
### DirectoryTree props
| Property | Description | Type | Default |
| --- | --- | --- | --- |
| expandAction | Directory open logic, optional `false` `'click'` `'doubleclick'` | string | click |
2019-04-10 05:28:07 +00:00
## FAQ
### How to hide file icon when use showLine?
File icon realize by using switcherIcon. You can overwrite the style to hide it