Skip to content

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即可禁止手动编辑内容,可通过输入框右侧下拉列表选择。

标签可关闭

设置tag-closable属性为true即可允许标签可关闭。

标签配置

设置tag-config属性可以配置标签的背景色、字体颜色、最大宽度等属性。

API

Props

参数名描述类型默认值
modelValue绑定的数据string | number-
placeholder输入框占位符string-
disabled是否禁用booleanfalse
options选项列表object-
useTree是否使用树形结构booleanfalse
show-popper-switch是否显示下拉按钮booleantrue
show-mode-switch是否显示模式切换按钮booleantrue
default-mode默认模式enumstring
height输入框高度string-
only-one-input是否只允许输入一个值booleanfalse
resize是否允许调整输入框大小booleantrue
show-password是否显示密码输入框booleanfalse
tree-config树形结构配置,参考KTreeTable组件treeConfig配置object-
props输入框属性object-
script-key脚本keystring-
check-content-type是否检查变量名booleanfalse
content-type文本类型enum-
option-repeatable标签是否可重复选择booleantrue
max-height最大高度string-
max可输入的最大值,仅在content-type为limit时有效number-
min可输入的最小值,仅在content-type为limit时有效number-
tag-closable 标签是否可关闭booleanfalse
search-config 下拉列表搜索配置object-
teleported 是否将列表弹出层放置于body下booleantrue
readonly 输入框是否只读booleanfalse
tag-config 标签配置object-

Events

事件名描述类型
change值改变时触发Function
input输入时触发Function
focus获得焦点时触发Function
blur失去焦点时触发Function
select选项被选中时触发Function

TagConfig

参数名描述类型默认值
maxWidth标签最大宽度number'auto'
color标签背景色string-
textColor文本颜色string-
showTooltip是否显示文本提示enum'overflow'

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

Slots

插槽名描述参数
prepend前置内容插槽-
append后置内容插槽-