主题
ScriptInput 脚本输入框
使用
基础用法
自定义模式切换按钮
调用toggleMode
方法可切换输入框模式, 通过手动改变show-mode-switch
属性可控制切换模式功能是否显示。
自定义下拉框按钮
调用showPopper
方法可控制下拉框显示与隐藏, 通过手动改变show-popper-switch
属性可控制按钮是否显示。
自定义脚本key
设置script-key
属性可自定义Key值。
树形列表
使用use-tree
属性可开启树形列表模式, 并通过tree-config
属性传入树形数据配置。
前后插槽
可以在输入框中前置或后置一个元素,通常是标签或按钮。 可通过 slot 来指定在 Input 中分发的前置或者后置的内容。
密码输入框
设置show-password
属性为true
即可开启密码输入框模式。
唯一值模式
设置only-one-input
属性为true
即可开启只允许输入一个值。
禁用状态
设置disabled
属性为true
即可禁用输入框。
文本校验
设置check-content-type
属性为true
即可限制输入框只能输入content-type
指定类型。
content-type
可以选择string(是否是字符串)
、boolean(是否是布尔值)
、number(是否是数字)
、tooltip(变量名是否合规)
等值
自定义高度
禁用选项重复选择
设置option-repeatable
属性为false
即可禁止同一选项多次选择。
禁止编辑
设置readonly
属性为true
即可禁止手动编辑内容,可通过输入框右侧下拉列表选择。
API
ScriptInput Props
参数名 | 描述 | 类型 | 默认值 |
---|---|---|---|
modelValue | 绑定的数据 | string | number | - |
placeholder | 输入框占位符 | string | - |
disabled | 是否禁用 | boolean | false |
options | 选项列表 | object | - |
useTree | 是否使用树形结构 | boolean | false |
show-popper-switch | 是否显示下拉按钮 | boolean | true |
show-mode-switch | 是否显示模式切换按钮 | boolean | true |
default-mode | 默认模式 | enum | string |
height | 输入框高度 | string | - |
only-one-input | 是否只允许输入一个值 | boolean | false |
resize | 是否允许调整输入框大小 | boolean | true |
show-password | 是否显示密码输入框 | boolean | false |
tree-config | 树形结构配置,参考KTreeTable组件treeConfig配置 | object | - |
props | 输入框属性 | object | - |
script-key | 脚本key | string | - |
check-content-type | 是否检查变量名 | boolean | false |
content-type | 文本类型 | enum | - |
option-repeatable | 标签是否可重复选择 | boolean | true |
max-height | 最大高度 | string | - |
max | 可输入的最大值,仅在content-type为limit时有效 | number | - |
min | 可输入的最小值,仅在content-type为limit时有效 | number | - |
tag-closable | 标签是否可关闭 | boolean | false |
search-config | 下拉列表搜索配置 | object | - |
teleported | 是否将列表弹出层放置于body下 | boolean | true |
readonly | 输入框是否只读 | boolean | false |
ScriptInput Events
事件名 | 描述 | 类型 |
---|---|---|
change | 值改变时触发 | Function |
input | 输入时触发 | Function |
focus | 获得焦点时触发 | Function |
blur | 失去焦点时触发 | Function |
select | 选项被选中时触发 | Function |
ScriptInput Methods
方法名 | 描述 | 类型 |
---|---|---|
clear | 清空输入框内容 | Function |
showPopper | 显示下拉框 | Function |
hidePopper | 隐藏下拉框 | Function |
toggleMode | 切换模式 | Function |
setStringMode | 切换为字符串模式 | Function |
getCurrentMode | 获取当前模式 | Function |
setCurrentMode | 设置当前模式 | Function |
isStringMode | 是否为字符串模式 | Function |
focus | 获得焦点 | Function |
blur | 失去焦点 | Function |
setPasswordMode | 设置密码模式 | Function |
togglePasswordMode | 切换密码模式 | Function |
ScriptInput Slots
插槽名 | 描述 | 参数 |
---|---|---|
prepend | 前置内容插槽 | - |
append | 后置内容插槽 | - |