52人参与 • 2026-08-26 • 正则表达式


表单是应用收集用户信息的主要方式。无论是登录注册、个人信息填写、搜索筛选,还是设置配置,都离不开表单组件。而表单的核心挑战是数据校验——如何确保用户输入的数据格式正确、内容合法。
harmonyos arkui 提供了丰富的表单组件(textinput、textarea、checkbox、radio、switch 等),结合正则表达式可以实现强大的数据校验能力。本文将以一个清爽蓝白风格的表单页面为主线,深入讲解表单开发与数据校验的核心技能。
| 组件 | 用途 | 关键属性 |
|---|---|---|
| textinput | 单行文本输入 | type、placeholder |
| textarea | 多行文本输入 | placeholder、maxlength |
| search | 搜索输入 | hint、searchbutton |
| passwordinput | 密码输入 | showpasswordicon |
| 组件 | 用途 | 关键属性 |
|---|---|---|
| checkbox | 复选 | select、selectedcolor |
| radio | 单选 | value、checked |
| switch | 开关 | ison、selectedcolor |
| slider | 滑块 | min、max、value |
| datepicker | 日期选择 | start、end |
| 组件 | 用途 |
|---|---|
| button | 普通按钮 |
| loadingprogress | 加载按钮 |
textinput({ placeholder: '请输入用户名', text: this.username })
.width('100%')
.height(46)
.onchange((v: string) => {
this.username = v;
})代码说明:
textinput 构造参数:placeholder 占位提示,text 绑定当前值。.onchange 回调:输入内容变化时触发,参数是当前输入值。textinput({ placeholder: '邮箱' })
.type(inputtype.email) // 邮箱键盘
textinput({ placeholder: '手机号' })
.type(inputtype.phonenumber) // 数字键盘
textinput({ placeholder: '密码' })
.type(inputtype.password) // 密码输入
textinput({ placeholder: '数字' })
.type(inputtype.number) // 数字键盘代码说明:
type 属性控制键盘类型和输入限制:
inputtype.email:邮箱键盘,带 @ 符号。inputtype.phonenumber:数字键盘。inputtype.password:密码输入,内容打码显示。inputtype.number:纯数字键盘。textinput({ placeholder: '输入' })
.maxlength(20) // 最大长度
.enabled(true) // 是否可用
.showcounter(true) // 显示字数统计
.enterkeytype(enterkeytype.done) // 回车键类型
.onsubmit(() => { // 提交回调
console.info('提交');
})
正则表达式(regular expression)是一种描述字符串匹配模式的工具。它用特殊的语法定义"什么样的字符串是合法的",然后用来校验、搜索、替换文本。
| 模式 | 含义 | 示例 |
|---|---|---|
^...$ | 匹配整个字符串 | ^abc$ 匹配 “abc” |
\d | 数字 | \d{11} 匹配 11 位数字 |
\w | 字母/数字/下划线 | \w+ 匹配单词 |
[a-z] | 小写字母 | [a-z]+ |
[0-9] | 数字 | [0-9]{3} |
{n,m} | 重复 n 到 m 次 | {3,12} |
+ | 至少 1 次 | \d+ |
* | 0 次或多次 | \w* |
? | 0 次或 1 次 | a? |
| ` | ` | 或 |
(?=...) | 正向预查 | (?=.*\d) 必须含数字 |
// 用户名:3-12 位字母/数字/下划线
const usernameregex = /^[a-za-z0-9_]{3,12}$/;
// 邮箱
const emailregex = /^[\w.-]+@[\w-]+(\.[\w-]+)+$/;
// 手机号:11 位大陆手机号
const phoneregex = /^1[3-9]\d{9}$/;
// 密码:6-16 位,必须包含字母和数字
const passwordregex = /^(?=.*[a-za-z])(?=.*\d)[a-za-z\d]{6,16}$/;
// 身份证号
const idcardregex = /^\d{17}[\dxx]$/;
// url
const urlregex = /^(https?|ftp):\/\/[^\s/$.?#].[^\s]*$/;代码说明:
^ 和 $ 锚定字符串的开始和结束,确保整个字符串匹配。(?=.*[a-za-z]) 是正向预查,表示"后面必须包含字母"。(?=.*\d) 表示"后面必须包含数字"。下面我们实现一个完整的表单校验页面,包含用户名、邮箱、手机号、密码四个字段的实时校验。
interface rulerow {
field: string;
rule: string;
example: string;
}
代码说明:
rulerow 接口描述校验规则表格中的一行数据,包含字段名、规则和示例。
@entry
@component
struct formpage {
@state username: string = '';
@state email: string = '';
@state phone: string = '';
@state password: string = '';
@state usernameerr: string = '';
@state emailerr: string = '';
@state phoneerr: string = '';
@state passworderr: string = '';
@state rules: rulerow[] = [
{ field: '用户名', rule: '3-12 位字母/数字/下划线', example: 'atom_code' },
{ field: '邮箱', rule: '标准邮箱格式', example: 'a@b.com' },
{ field: '手机号', rule: '11 位大陆手机号', example: '13800138000' },
{ field: '密码', rule: '6-16 位含字母和数字', example: 'abc123' }
];代码说明:
rules 数组存储校验规则表格数据。validateusername(v: string): void {
this.username = v;
this.usernameerr = /^[a-za-z0-9_]{3,12}$/.test(v) ? '' : '用户名需 3-12 位字母/数字/下划线';
}
validateemail(v: string): void {
this.email = v;
this.emailerr = /^[\w.-]+@[\w-]+(\.[\w-]+)+$/.test(v) ? '' : '邮箱格式不正确';
}
validatephone(v: string): void {
this.phone = v;
this.phoneerr = /^1[3-9]\d{9}$/.test(v) ? '' : '手机号格式不正确';
}
validatepassword(v: string): void {
this.password = v;
this.passworderr = /^(?=.*[a-za-z])(?=.*\d)[a-za-z\d]{6,16}$/.test(v) ? '' : '密码需 6-16 位且包含字母和数字';
}代码说明:
四个校验方法结构一致,核心逻辑是:
this.username = v 将输入值保存到状态。.test(v) 方法测试输入值是否匹配正则表达式,返回布尔值。onchange 回调中调用,实现输入即校验的实时反馈。submit(): void {
this.validateusername(this.username);
this.validateemail(this.email);
this.validatephone(this.phone);
this.validatepassword(this.password);
const ok = !this.usernameerr && !this.emailerr && !this.phoneerr && !this.passworderr;
if (ok) {
promptaction.showtoast({ message: '✓ 校验通过,提交成功' });
} else {
promptaction.showtoast({ message: '✗ 存在校验错误,请检查' });
}
}
代码说明:
submit 方法在点击提交按钮时执行:
@builder
formfield(label: string, placeholder: string, value: string, error: string, oninput: (v: string) => void) {
column({ space: 6 }) {
text(label)
.fontsize(13)
.fontweight(fontweight.medium)
.fontcolor('#2f3542')
.alignself(itemalign.start)
textinput({ placeholder: placeholder, text: value })
.width('100%')
.height(46)
.backgroundcolor('#f5f7fa')
.borderradius(10)
.placeholdercolor('#a0a8b4')
.border({ width: 1, color: error ? '#ff4757' : '#e1e6ed' })
.onchange((v: string) => { oninput(v); })
text(error)
.fontsize(11)
.fontcolor('#ff4757')
.alignself(itemalign.start)
.height(16)
}
.width('100%')
.alignitems(horizontalalign.start)
}代码说明:
formfield 是表单字段的通用构建器,通过参数化实现复用:
label:字段标签。placeholder:输入占位提示。value:当前输入值。error:错误信息。oninput:输入回调函数(作为参数传入)。.border({ width: 1, color: error ? '#ff4757' : '#e1e6ed' }) 根据是否有错误切换边框颜色,有错误显示红色边框。text(error) 显示错误信息,.height(16) 固定高度,即使无错误也占位,避免布局跳动。oninput 参数是函数类型,在 onchange 中调用,实现了构建器的通用性。build() {
scroll() {
column({ space: 16 }) {
// 顶部标题
column() {
text('form')
.fontsize(12)
.fontcolor('#b3d4ff')
.letterspacing(8)
text('表单与校验')
.fontsize(26)
.fontweight(fontweight.bold)
.fontcolor(color.white)
.margin({ top: 6 })
text('正则表达式 · 实时校验')
.fontsize(12)
.fontcolor('#b3d4ff')
.margin({ top: 6 })
}
.width('100%')
.padding({ top: 48, bottom: 30 })
.backgroundcolor('#3b82f6')
// 表单区
column({ space: 4 }) {
this.formfield('用户名', '请输入用户名', this.username, this.usernameerr, (v: string) => { this.validateusername(v); })
this.formfield('邮箱', '请输入邮箱', this.email, this.emailerr, (v: string) => { this.validateemail(v); })
this.formfield('手机号', '请输入手机号', this.phone, this.phoneerr, (v: string) => { this.validatephone(v); })
this.formfield('密码', '请输入密码', this.password, this.passworderr, (v: string) => { this.validatepassword(v); })
}
.width('100%')
.padding(20)
.backgroundcolor(color.white)
.borderradius(16)
.shadow({ radius: 8, color: '#22000000', offsety: 4 })
// 大号提交按钮
button('提交表单')
.width('100%')
.height(52)
.fontsize(17)
.fontweight(fontweight.bold)
.fontcolor(color.white)
.lineargradient({
angle: 90,
colors: [['#3b82f6', 0], ['#6366f1', 1]]
})
.borderradius(26)
.shadow({ radius: 14, color: '#553b82f6', offsety: 4 })
.onclick(() => { this.submit(); })代码说明:
表单区通过 formfield 构建器生成四个字段,每个字段传入对应的状态、错误信息和校验回调。提交按钮使用蓝紫渐变、大圆角,形成醒目的 cta(行动召唤)按钮。
// 校验规则表格
column() {
text('校验规则速查')
.fontsize(14)
.fontweight(fontweight.bold)
.fontcolor('#3b82f6')
.alignself(itemalign.start)
.margin({ bottom: 8 })
row() {
text('字段').layoutweight(1).fontsize(12).fontweight(fontweight.bold).fontcolor('#3b82f6')
text('规则').layoutweight(2).fontsize(12).fontweight(fontweight.bold).fontcolor('#3b82f6')
text('示例').layoutweight(1).fontsize(12).fontweight(fontweight.bold).fontcolor('#3b82f6')
}
.width('100%')
.padding(10)
.backgroundcolor('#eff6ff')
foreach(this.rules, (row: rulerow) => {
row() {
text(row.field).layoutweight(1).fontsize(12).fontcolor('#2f3542')
text(row.rule).layoutweight(2).fontsize(11).fontcolor('#555555')
text(row.example).layoutweight(1).fontsize(11).fontcolor('#3b82f6').fontfamily('monospace')
}
.width('100%')
.padding(10)
.border({ width: { bottom: 1 }, color: '#eff6ff' })
})
}
.width('100%')
.padding(16)
.backgroundcolor('#f8fbff')
.borderradius(14)
.border({ width: 1, color: '#dce9fb' })
代码说明:
校验规则速查表是一个带表头的三列表格:
foreach 渲染,示例列使用蓝色等宽字体。layoutweight 控制(1:2:1)。正则表达式容易出错,建议先在测试工具中验证,再应用到代码中。
除了格式校验,还要处理必填字段的空值校验:
validaterequired(v: string): string {
if (!v.trim()) {
return '该字段不能为空';
}
return '';
}
原因:正则表达式错误,或 .test() 使用不当。
解决:先在测试工具验证正则,确认 .test() 参数正确。
原因:错误信息高度不固定,导致布局变化。
解决:给错误提示设置固定高度(如 .height(16))。
原因:没有设置 .type(inputtype.password)。
解决:设置密码输入类型。
本文深入讲解了 harmonyos 表单与校验技术,通过一个清爽蓝白风格的表单页面实战演示了输入组件、正则校验、实时反馈和提交处理等核心能力。
核心要点回顾:
.test() 方法校验输入值。onchange 中触发,提交时统一验证。@builder 参数化表单字段,实现复用。表单是收集用户信息的关键,掌握校验技术能构建可靠、友好的表单体验。下一篇我们将讲解 harmonyos 数据可视化(canvas 绘图)。
到此这篇关于基于harmonyos的表单与校验功能(输入验证与正则表达式)的文章就介绍到这了,更多相关harmonyos表单与校验内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
您想发表意见!!点此发布评论
版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。
发表评论