1.先看我们要做什么
这次做一个简单的昵称预览页。在输入框中输入昵称,下面的文字跟着变化;点击“清空”,输入框和预览文字一起恢复。
这个例子只需要一个页面,不需要联网,也不用申请权限。刚接触鸿蒙的同学,可以先跟着做出来,再看每一段代码负责什么。
2.找到项目中的 Index.ets 文件
使用 DevEco Studio 创建一个 ArkTS 的 Empty Ability 工程,使用 Stage 模型。已经有练习工程的,也可以直接打开默认首页。
默认文件位置:entry/src/main/ets/pages/Index.ets。如果你的模块不叫 entry,就到对应模块的 src/main/ets/pages 目录下找。
本文使用状态管理 V1 的 @Component + @State 写法,适合学习这一套基础语法。若模板中使用的是 @ComponentV2,这次练习请完整替换为下方示例,不要只把 @State 插进 V2 组件里。建议在 HarmonyOS API 12 或以上的 ArkTS 工程中练习,并使用与工程 SDK 配套的设备或模拟器。
3.先准备一个变量,用来记录输入的昵称
在 Index 里面、build 方法外面,定义 nickname。下面的完整代码中,对应的是这一行:
@State nickname: string = ''
这里分开看就很好理解了:
- nickname:变量名字,用来存放当前输入的内容。
- string:说明这个变量保存的是字符串。
- '':默认没有输入,所以初始值是空字符串。
- @State:让界面能够跟着这个变量的变化更新。
后面的输入框和预览文字都会用到这个变量。
4.把输入框和预览文字连接起来
TextInput 负责接收输入,Text 负责显示结果。
TextInput 的 text 参数读取 this.nickname;用户输入时,onChange 会拿到新的内容,我们再把这个内容赋给 this.nickname。
也就是:输入内容 → onChange → 修改 nickname → 更新预览文字。
注意:只写 text: this.nickname,并不等于已经把用户输入回写到变量。本例通过 onChange 明确完成这一步。
预览部分增加一个小判断:如果昵称去掉首尾空格后为空,就显示“还没有输入昵称”;否则显示“你好,xxx”。这里的 trim() 只用于判断和展示,不会在每次输入时强行修改输入框里的原始内容。
5.增加一个清空按钮,下面是完整代码
将 Index.ets 原来的示例内容整体替换成下面的代码。不要把两套 @Entry 和 Index 同时留在一个文件中。
代码示例:
@Entry
@Component
struct Index {
// 记录输入框当前的内容,变化后刷新关联的界面
@State nickname: string = ''
build() {
Column({ space: 20 }) {
Text('昵称预览')
.fontSize(26)
.fontWeight(FontWeight.Bold)
// text 把状态显示到输入框,onChange 把输入回写到状态
TextInput({
text: this.nickname,
placeholder: '请输入你的昵称'
})
.width('100%')
.height(48)
.onChange((value: string) => {
this.nickname = value
})
// 空内容和正常内容,分别显示不同提示
Text(this.nickname.trim().length === 0
? '还没有输入昵称'
: '你好,' + this.nickname.trim())
.fontSize(20)
.fontColor('#333333')
.width('100%')
.textAlign(TextAlign.Center)
.padding(20)
.backgroundColor('#F2F6FF')
.borderRadius(12)
Button('清空')
.width('100%')
.height(44)
.onClick(() => {
// 只需要修改状态,输入框和预览文字就会一起更新
this.nickname = ''
})
}
.width('100%')
.height('100%')
.padding({ top: 60, left: 24, right: 24 })
.backgroundColor(Color.White)
}
}
Column 是纵向布局,里面的标题、输入框、预览文字和按钮会从上往下排列。space: 20 表示相邻子组件之间留出间距。
width、height、padding 等属性主要负责样式。刚开始学习时,先重点看 nickname、onChange 和 onClick 这三个位置。
6.运行后,按下面几步检查效果
在 DevEco Studio 中运行到匹配工程 SDK 的模拟器或真机,打开首页。
预期效果:
- 刚打开页面:输入框为空,下面显示“还没有输入昵称”。
- 输入“小明”:下面显示“你好,小明”。
- 继续修改昵称:下面的文字同步变化。
- 点击“清空”:输入框恢复为空,下面也恢复默认提示。
- 只输入几个空格:下面仍然显示“还没有输入昵称”。
这几个操作都符合预期,就说明输入、状态更新和界面显示这条流程已经接通了。
7.如果效果不对,先检查这几个地方
输入框能输入,下面的文字却不变?
先检查 nickname 前面有没有 @State,再检查 onChange 中有没有写 this.nickname = value,以及 Text 读取的是不是同一个 this.nickname。
点击清空,预览变了,输入框却没清空?
检查 TextInput 参数里有没有 text: this.nickname。清空按钮修改的是状态,输入框也需要读取这个状态,才能跟着更新。
关闭应用再打开,昵称为什么没了?
这个例子只演示当前组件里的状态,没有保存到本地。@State 本身不是持久化存储。需要重新打开后还保留昵称时,可以再学习 Preferences。
复制代码后提示装饰器不匹配?
检查组件是否写成了 @ComponentV2。本文整套示例使用 @Component 和 @State,不要混着复制;使用 V2 的页面应按 V2 的规则管理状态。
做到这里,一个最基础的输入交互就完成了。可以自己再加一个“填入示例”按钮,点击后把 nickname 改成“鸿蒙新同学”,观察输入框和预览文字是否一起变化。
参考资料:









































苏公安网备 32011402010933号