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

API

ScriptInput 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

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后置内容插槽-