文档开发者中心
我的

HarmonyOS 实现输入框实时预览的超详细保姆级教程

浏览50发布于2026-09-28 06:57北京

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 的模拟器或真机,打开首页。

预期效果:

  1. 刚打开页面:输入框为空,下面显示“还没有输入昵称”。
  2. 输入“小明”:下面显示“你好,小明”。
  3. 继续修改昵称:下面的文字同步变化。
  4. 点击“清空”:输入框恢复为空,下面也恢复默认提示。
  5. 只输入几个空格:下面仍然显示“还没有输入昵称”。

这几个操作都符合预期,就说明输入、状态更新和界面显示这条流程已经接通了。

7.如果效果不对,先检查这几个地方

输入框能输入,下面的文字却不变?

先检查 nickname 前面有没有 @State,再检查 onChange 中有没有写 this.nickname = value,以及 Text 读取的是不是同一个 this.nickname。

点击清空,预览变了,输入框却没清空?

检查 TextInput 参数里有没有 text: this.nickname。清空按钮修改的是状态,输入框也需要读取这个状态,才能跟着更新。

关闭应用再打开,昵称为什么没了?

这个例子只演示当前组件里的状态,没有保存到本地。@State 本身不是持久化存储。需要重新打开后还保留昵称时,可以再学习 Preferences。

复制代码后提示装饰器不匹配?

检查组件是否写成了 @ComponentV2。本文整套示例使用 @Component 和 @State,不要混着复制;使用 V2 的页面应按 V2 的规则管理状态。

做到这里,一个最基础的输入交互就完成了。可以自己再加一个“填入示例”按钮,点击后把 nickname 改成“鸿蒙新同学”,观察输入框和预览文字是否一起变化。

参考资料:

收藏
0
回复
2
分享
全部评论
authorIcon
匿名用户
很不错,学习学习
回复于2026-10-17 00:36北京
authorIcon
匿名用户
学习了,很有意义
回复于2026-10-05 09:21陕西
写评论
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。
发表
我要写文章
目录 收起
1.先看我们要做什么
2.找到项目中的 Index.ets 文件
3.先准备一个变量,用来记录输入的昵称
4.把输入框和预览文字连接起来
5.增加一个清空按钮,下面是完整代码
6.运行后,按下面几步检查效果
7.如果效果不对,先检查这几个地方
了解社区公约,与您携手共创和谐专业的开发者社区。