0.0.21 • Published 6 years ago
@alicd/crui-task-sorter v0.0.21
category: Components type: UI Views component: Overlay chinese: 排序面板
english: TaskSorter
可以对序列数据进行排序、删除等操作,并且提供了设置设置按钮的插槽,一般用于表格列设置(排序或者移除某些列的展示等)。
API
TaskSorter
| 成员 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| dataSource | 列表数据数据源(value 属性为唯一标识,不能出现重复)。 | [{ text: string, value: any}] | [ ] |
| disabled | 是否禁用条目的删除功能 | boolean | false |
| draggable | 是否启用条目的拖动重排序功能 | boolean | true |
| visible | 是否显示弹层, 如果此属性为 false,弹层不会被渲染 | boolean | false |
| title | 设定弹层标题 | string 或 number | "排序设置" |
| width | 设定弹层宽度 | number | 300 |
| height | 设定弹层高度 | number | 500 |
| onOk | 点击确定按钮触发的事件 | (data: object[]) => void | 默认不执行任何操作 |
| onCancel | 点击取消按钮触发的事件 | (e: object[]) => void | 默认不执行任何操作 |
| loading | 设置弹层载入状态 | boolean | false |
| showTitle | 是否显示标题 | boolean | true |
| showFooter | 是否显示弹层底部的按钮栏 | boolean | true |
| hasMask | 是否显示遮罩 | boolean | true |
| onDragStart | 用户开始进行拖动重排时触发的事件 | (params: { event: Event, node: OrderNode }) => void | 默认不执行任何操作 |
| onDragEnter | 数据条目刚刚拖动到另一条目上时触发的条件 | (params: { event: Event, node: OrderNode }) => void | 默认不执行任何操作 |
| onDragOver | 数据条目拖动过程中,当指针悬浮于另一条目上时,持续触发这一事件 | (params: { event: Event, node: OrderNode }) => void | 默认不执行任何操作 |
| onDragLeave | 数据条目拖动过程中指针离开另一条目时触发的条件 | (params: { event: Event, node: OrderNode }) => void | 默认不执行任何操作 |
| onDrop | 拖动重排结束时触发的事件 | (params: { event: Event, dragNode: OrderNode, dragNodesKeys: number, node: OrderNode, dropPosition: number, dropToGap: boolean }) => boolean | 默认不执行任何操作 |
| canDrop | 某一数据条目是否可被拖动到另一数据条目之上 | (params: { dragNode: OrderNode, dragNodesKeys: number, node: OrderNode, dropPosition: number, dropToGap: boolean }) => boolean | 默认始终返回 true |
| onChange | 数据条目被重排或删除后触发的事件 | (data: object[]) => void | 默认不执行任何操作 |
| className | 自定义类名 | string | N/A |
| canCloseByEsc | 是否支持 esc 按键关闭弹层 | boolean | true |
| canCloseByOutSideClick | 点击弹层外的区域是否关闭弹层 | boolean | true |
| canCloseByMask | 点击遮罩区域是否关闭弹层 | boolean | true |
| animation | 配置动画的播放方式 | object 或 boolean | { "in": "expandInDown", "out": "expandOutUp" } |
| target | 配置弹层定位的参照元素 | any | Position.VIEWPORT |
| align | 弹层相对于target的定位, 详见开发指南的定位部分 | string 或 boolean | "cc cc" |
| offset | 弹层相对于target定位的微调 | number[2] | [0, 0] |
| beforeClose | 弹层关闭前触发的事件 | () => void | 默认不执行任何操作 |
| onClose | 弹层关闭后触发的事件 | () => void | 默认不执行任何操作 |
| afterClose | 弹层关闭后触发的事件, 如果有动画,则在动画结束后触发 | () => void | 默认不执行任何操作 |
| beforeOpen | 弹层打开前触发的事件 | () => void | 默认不执行任何操作 |
| onOpen | 弹层打开后触发的事件 | () => void | 默认不执行任何操作 |
| afterOpen | 弹层打开后触发的事件, 如果有动画,则在动画结束后触发 | () => void | 默认不执行任何操作 |
| onRequestClose | 弹层请求关闭触发的事件。参数: reason: string 弹层关闭的来源 e: Event DOM 事件 | (reason: string, e: Event) => void | 默认不执行任何操作 |
| beforePosition | 弹层定位完成前触发的事件 | () => void | 默认不执行任何操作 |
| onPosition | 弹层定位完成后触发的事件。参数: config: object 定位的参数 node: object 定位的元素 | (config: object, node: object) => void | 默认不执行任何操作 |
| autoFocus | 弹层打开的时候是否让里面的元素自动获取焦点 | boolean | false |
| cache | 隐藏时是否保留子节点 | boolean | false |
| safeNode | 安全节点,当点击 document 的时候, 如果包含该节点则不会关闭弹层, 如果是函数需要返回 ref, 如果是字符串则是该DOM的 id, 也可以直接传入DOM节点 | any | N/A |
| wrapperClassName | 弹层的根节点的样式类 | string | N/A |
| container | 指定渲染组件的容器 | any | N/A |
| shouldUpdatePosition | 强制更新定位信息 | boolean | N/A |
| needAdjust | 是否自动调整定位的位置 | boolean | N/A |
| disableScroll | 是否禁用页面滚动 | boolean | true |
| prefix | 样式类名的品牌前缀 | string | "next-" |
| showDelete | 是否展示条目前面的删除图表, 设置为 false 则无法删除 | boolean | true |
TaskSorter.Setting
用于设置任务面板右上角的元素。
0.0.21
6 years ago