应用/搭建用户界面/小程序端组件/单行输入
单行输入
更新于: 2026-06-24 15:44:40
单行输入组件用于接收用户的单行文本输入,适用于需要简短回答的场景,例如搜索框、密码输入、电话号码等。
单行输入组件支持丰富的属性设置,例如常用设置、位置设置、尺寸设置、样式设置、变换设置、状态设置和可见性设置。
|
属性 |
说明 |
|---|---|
|
标签 |
配置是否显示单行输入组件的标签,标签可以为单行输入组件提供文字描述,使用户能够更直观地理解单行输入组件的状态或功能。 |
|
标签内容 |
配置单行输入组件的标签内容,支持配置静态内容和动态绑定数据,详情请参见设置组件内容参数。 |
|
占位文案 |
配置单行输入的占位文案,占位文案是一种提示性文本,它出现在输入字段中但不会显示在最终提交的数据里。 |
|
字符上限 |
配置单行输入组件的字符上限,字符上限是一个限制用户在单行输入框中可以输入的最大字符数的功能。默认关闭字符上限,你可以打开开关,并根据实际需求设置字符上限数值。 |
|
默认值 |
配置单行输入组件的默认值。 |
|
组件布局 |
配置标签与输入框的布局方式,支持上下布局和左右布局。 |
|
垂直对齐 |
配置单行输入组件的垂直对齐方式。
|
|
输入区颜色 |
配置单行输入框背景的显示颜色。 |
|
输入区边框 |
配置单行输入组件背景的边框颜色、边框的粗细和边框的样式。 |
单行输入组件提供三种位置类型选项,以灵活配置组件在界面中的位置。
|
属性 |
说明 |
|---|---|
|
宽度 |
配置单行输入组件的宽度值,支持以下宽度设置方式:
|
|
高度 |
配置单行输入组件的高度值,支持以下高度设置方式:
|
|
尺寸限制 |
配置单行输入组件的尺寸限制,支持配置最大高度、最小高度、最大宽度、最小宽度。 |
|
属性 |
说明 |
|---|---|
|
填充 |
配置单行输入组件背景的显示颜色。 |
|
圆角 |
配置单行输入组件背景的圆角,支持单独设置四个角的圆角。 |
|
内边距 |
配置单行输入组件背景的内边距,可以单独设置四个方向的内边距。 |
|
外边距 |
配置单行输入组件背景的外边距,可以单独设置四个方向的外边距。 |
|
边框 |
配置单行输入组件背景的边框样式。支持如下设置方式:
|
|
阴影 |
配置单行输入组件背景的阴影样式,增强组件的立体感。支持如下设置方式:
|
|
图层模糊 |
配置单行输入组件的模糊效果。数值越大,模糊效果越明显。 |
|
溢出 |
配置单行输入组件溢出相关设置,支持以下溢出方式:
|
丰富界面视觉效果的参数。
|
属性 |
说明 |
|---|---|
|
缩放 |
配置单行输入组件大小的缩放比例。 |
|
旋转 |
配置单行输入组件围绕中心点旋转的角度。 |
|
位移 |
配置单行输入组件在水平和垂直方向上的移动距离。 |
|
倾斜 |
配置单行输入组件在水平和垂直方向上的倾斜角度。 |
控制单行输入组件禁用态、加载态、点击态和出现态的视觉效果参数。
|
属性 |
说明 |
|---|---|
|
禁用态 |
配置单行输入组件的禁用状态。具体配置说明如下:
|
|
加载态 |
配置单行输入组件的加载状态。具体配置说明如下:
|
|
点击效果 |
配置单行输入组件的点击态效果。具体配置说明如下: |
|
出场效果 |
设置单行输入组件在界面中出现时的动画效果。目前支持设置为淡入、缩放、模糊、水平翻转、垂直翻转、从下滑入、从上滑入、从左滑入、从右滑入等动画效果。 |
控制单行输入组件隐藏或显示的参数,支持在特定条件下隐藏单行输入组件。
Input1,当你将单行输入组件的可见性设置为{{ Input1.value}}后,在单行输入组件中输入文本时,{{ Input1.value}}值为 true,单行输入组件将被隐藏。通过配置单行输入组件的事件,可以为单行输入组件添加丰富的交互功能,以增强用户体验和界面的互动性。
|
事件项 |
说明 |
|---|---|
|
事件类型 |
支持以下事件类型:
|
|
组件方法 |
支持以下方法:
|