IconPicker
分组的图标网格,单选,点一项回调:插入形状的形状库、「裁剪为形状」这类界面。每组一个标题加一个图标开关组,组经 aria-labelledby 指到标题;左右、Home / End 在组内移动,上下键按列跳、跨组也一样。
两组形状,每行 4 个
基础形状
箭头
v-model是当前选中的值;点当前选中的那项也会再报一次select(工具类场景是「重新拿起」),切换不切换都能拿到。- 各组的开关组带
standalone:选择器多半从工具条弹出,不带的话浮层里的项会被拉进工具条的漫游。 - 项上的
shortcut进悬停提示(矩形 R、椭圆 O),不拼进label。非 iconify 的缩略图(形状字形)由宿主用addCollection登记成自定义图标集,照样走XIcon。
API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
groups 必填 | IconPickerGroup[] | — | — |
label 必填 | string | — | 整个选择器的读屏名 |
columns | number | undefined | 10 | 每行几项,缺省 10 |
modelValue | string | undefined | — | — |
Emits
| 事件 | 载荷 | 说明 |
|---|---|---|
update:modelValue | [value: string | undefined] | — |
select | [value: string] | — |