Dynamic Tags 动态标签
把标签变得可以输入。
基础用法
最大标签数量
自定义渲染tag
自定义触发元素
API
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model | 受控模式下的值 | enum | [] |
max | tag 的最大数量 | number | - |
tag-class | 自定义标签的类名 | string | - |
tag-style | 自定义标签的样式 | string | Object | - |
tag-props | 内部 r-tag 组件的属性 | TagProps | - |
render-tag | 自定义渲染 tag | enum | - |
disabled | 按钮是否禁用 | boolean | false |
icon | 按钮图标名称或图片链接,等同于 Icon 组件的 name 属性 | string/component | - |
input-class | 自定义输入框的类名 | string | - |
input-style | 自定义输入框的样式 | string | Object | - |
input-props | 内部 r-input 组件的属性 | InputProps | - |
create | 根据输入的值创造对应的选项 | enum | label => label |
Slots
名称 | 说明 | 参数 |
---|---|---|
input | 自定义输入元素,由用户填充 | - |
trigger | 触发输入标签的组件或元素 | (info: { disabled: boolean }) |
方法
通过 ref 可以获取到 Dynamic Tags 实例并调用实例方法,详见组件实例方法。
方法名 | 说明 | 参数 |
---|---|---|
activate | 显示输入框 | - |
deactivate | 隐藏输入框 | - |
submit | 确定tag显示的值 | (externalValue?: string) => void |
类型定义
组件导出以下类型定义:
ts
import type {
DynamicTagsProps,
DynamicTagsExpose,
DynamicTagsThemeVars
} from 'ryxon'
主题定制
样式变量
组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。
名称 | 默认值 | 描述 |
---|---|---|
--r-dynamic-tags-height | 24px | - |
--r-dynamic-tags-input-width | 100px | - |