跳到主要内容

邮箱输入

适用场景

用于输入邮箱地址

基础能力说明

  1. 该组件可绑定数据模型中的文本字段,实现邮箱地址的录入提交

  2. 常见场景实践说明

    1. 实现通过变量获取和改变表单值 查阅文档
    2. 清空表单内容 查阅文档
    3. 表单组件隐藏时,提交对应表单数据 查阅文档
    4. 利用表单组件搭建列表的筛选或搜索功能 查阅文档

扩展场景说明

属性介绍

组件接收的外部传入的属性

属性名
属性标识
类型
说明
字段绑定namestring

提交表单时会将组件值提交保存到所配置的字段中

示例:"formEmail"

字段标题labelstring

组件标题位置的显示内容

示例:"邮箱"

显示标题labelVisibleboolean

显示组件的标题

示例:true

邮箱内容valuestring

邮箱输入框中的默认值

示例:""

必填requiredboolean

启用后该组件强制必填,值不可为空

示例:false

必填标识requiredFlagboolean

启用后,组件若要求必填,则会显示必填星号标记

示例:true

必填校验提示requiredMsgstring

启用必填,但组件值为空时的提示信息

示例:"该项为必填项"

占位符placeholderstring

用于说明组件用途或注意事项的提示文字

示例:"请输入邮箱"

获取焦点focusboolean

启用后,打开页面时,该组件的输入框将自动获取焦点(多组件启用时,仅最下方的组件生效)

示例:false

是否禁用disabledboolean

是否禁用输入/选择,启用后组件强制显示为只读效果

示例:false

最大长度maxLengthnumber

允许输入的最大字符数量

示例:140

布局方式layoutstring

设置当前组件的标题和输入选择区域为左右布局或上下布局,如选择“自动”,则跟随父级表单容器的配置

示例:""

组件宽度(PC端)sizestring

示例:"full"

显示清空按钮clearableboolean

启用后,输入框有值时,右侧将显示清空按钮,点击后可清空输入框中的值

示例:true

事件介绍

组件暴露的事件,可以监听组件的事件来触发一些外部的动作

事件名
事件code
事件出参 event.detail
适用情况
说明
输入改变change兼容三端

-

失焦blur兼容三端

-

聚焦focus兼容三端

-

确认confirm兼容三端

-

清除内容clear兼容三端

-