README
方块式可视化列表
block-list
方块式可视化列表
API
| 参数名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| dataSource | 数据源，dataSource 中存在 backIconType 时，展示 Icon 组件为背景图 | Array | - |
| primaryKey | 唯一标识 | string | id |
| size | 指定方块大小 可选值 small, medium, large |
Enum/Number | 'medium' |
| selectedKeys | （用于受控）当前选中节点 key 的数组 | Array | - |
| defaultSelectedKeys | （用于非受控）默认选中节点 key 的数组 | Array | - |
| onSelect | 选中或取消选中节点时触发的回调函数，回传 keys,infos | Function | - |
| highlightKeys | 高亮色块 | Array | - |
| labelRender | 色块内文本 render | Function | (block) => block.label |
| disabled | 是否全局禁用色块选择 | Boolean | false |
| disabledRender | 色块是否禁用选择 render | Function | (block) => block.disabled |
| boxProps | Box 组件属性透传 | Object | - |
| tagProps | Tag.Selectable 组件属性透传 | Object | - |
| isSearch | 是否处于搜索模式，一般是有关键字或过滤条件时传为 true，该模式下所有色块变透明，highlightKeys 对应的色块高亮；否则所有色块无透明和高亮效果 | Boolean | false |
change log
-- 2021.09.01
---- 1. 还原上一次处理（色块全部高亮时，禁用的色块透明度为 0.5），即禁用色块高亮效果与其他色块一致，无特殊处理；
-- 2021.08.31
---- 1. dataSource 数据中增加 backIconType 字段，存在该字段时，组件中设置 Icon 组件的 type，且作为背景图显示；
---- 2. 背景图的大小目前为固定的 27px;
---- 3. 禁用的色块去掉背景颜色的设置，只保留鼠标手势和事件禁用；
---- 4. IP 地址功能中对禁用的色块，应同时设置 backIconType 和 disabled；
---- 5. 去掉色块 4px 的圆角，使用 tag 组件本身的 2px 的圆角；
---- 6. 更新“受控展示”demo 中的颜色色值；
---- 7. 色块全部高亮时，禁用的色块透明度为 0.5；
---- 8. 色块选中的样式修改，tag 组件选中三角的背景色改为白色，对勾颜色使用父级色块的颜色；
-- 2021.08.23
---- 1. 修改框选时遮罩的计算逻辑，兼容多层级定位布局；
---- 2. 兼容内滚出现滚动条时的框选；
-- 2021.08.20
---- 1. 添加 disabled 属性与 demo 样例，可全局设置或在 dataSource 中单项设置；
---- 2. 被 disabled 的色块组件内部不会做处理，保持原 disabled 设置与选中的项进行回调；
-- 2021.08.10
---- 1. 处理清空场景下，传 selectedKeys=[]不生效的问题；
---- 2. 主动修改 selectedKeys 时，不回调 onChange 事件，防止循环调用；
---- 3. 重复选择相同 key 时，不响应 onChange 事件
-- 2021.08.04
---- 1. 添加鼠标滑选特效；
---- 2. 取消 selectMode 参数，点击为单选，ctrl/command 按住单击为多选，鼠标按住拖动为滑选；
---- 3. 取消 boxProps 参数，内部取消了 Box 组件；
---- 4. 取消 onSelect 方法回调时的第二个参数，原因为：内部实现方法改动，暂无法获取当前节点数据，后续版本再支持；
---- 5. 由于增加了鼠标滑选操作，单击时如果鼠标抖动会认为是滑选操作，可能会引起选中又取消的现象；