鸿蒙5开发:手把手教你用 Ark-TS UI 做一个会 “动” 的计数器

今天咱们用鸿蒙 5 的 Ark-TS UI 做一个简单又有趣的计数器应用。点击按钮数字就会增加，而且界面还能自动更新。通过这个案例，你能轻松理解 Ark-TS UI 的核心玩法。

一、最终效果长什么样？

打开应用，你会看到一个大按钮，上面写着 “点击加 1”。每次点击按钮，按钮上方的数字就会变大。比如第一次点击变成 “1”，第二次变成 “2”，依此类推。整个过程不需要手动刷新页面，数字会自动变化。

二、完整代码长这样

@Entry

@Component

struct CounterApp {

// 用@State标记一个变量count，它的值变化时界面会自动更新

@State count: number = 0

build() {

// Column是一个垂直布局容器，里面的内容会从上到下排列

Column() {

// Text组件显示文字，这里显示当前的count值

Text(`当前计数：${this.count}`)

.fontSize(24) // 设置字体大小为24像素

.margin(20) // 给文本周围添加20像素的边距

// Button组件是一个按钮，点击时触发onClick事件

Button("点击加1")

.onClick(() => {

// 点击按钮时，count的值增加1

this.count++

})

.fontSize(18) // 按钮文字大小18像素

.padding(15) // 按钮内部的 padding 为15像素

.backgroundColor('#007DFF') // 按钮背景色为蓝色

.textColor('#FFFFFF') // 按钮文字颜色为白色

.cornerRadius(8) // 按钮圆角半径8像素

}

// 设置整个Column布局的宽度为屏幕宽度的100%

.width('100%')

// 设置整个布局的对齐方式为垂直和水平居中

.justifyContent(FlexAlign.Center)

.alignItems(HorizontalAlign.Center)

}

}

三、逐行代码拆解，零基础也能看懂

@Entry 和 @Component

@Entry 表示这个组件是应用的入口，程序从这里开始运行。

@Component 标记这是一个可复用的组件，里面包含界面和逻辑。

@State count: number = 0

@State 是 Ark-TS UI 的关键装饰器，它告诉系统：“这个变量count的值会影响界面，一旦它变化，界面要自动更新。”

这里初始化count为 0，也就是计数器的初始值。

build() 方法

这个方法定义了组件的界面结构。Ark-TS UI 通过声明式语法描述界面，就像 “画图纸” 一样。

Column() 布局容器

Column是一个垂直布局容器，里面的组件会从上到下排列。就像一个竖着的盒子，把内容依次装进去。

Text 组件显示计数

Text(当前计数：\({this.count}`)`：显示一行文字，`\){this.count}会实时替换为count` 变量的值。

.fontSize(24)：设置文字大小为 24 像素。

.margin(20)：给文本周围添加 20 像素的空白，让界面看起来不拥挤。

Button 组件实现点击功能

Button("点击加1")：创建一个按钮，显示文字 “点击加 1”。

.onClick(() => { this.count++ })：点击按钮时，执行this.count++，也就是让count的值加 1。

.fontSize(18)：按钮文字大小 18 像素。

.padding(15)：按钮内部的空白区域为 15 像素，让文字看起来不贴着边缘。

.backgroundColor('#007DFF')：按钮背景色设置为蓝色。

.textColor('#FFFFFF')：按钮文字颜色设置为白色。

.cornerRadius(8)：按钮四个角设置为圆角，半径 8 像素，让按钮看起来更圆润。

设置布局的整体样式

.width('100%')：让整个Column布局的宽度占满屏幕。

.justifyContent(FlexAlign.Center) 和 .alignItems(HorizontalAlign.Center)：让布局内的内容在垂直和水平方向都居中显示，这样按钮和文本会在屏幕正中间。

四、核心原理：为什么界面会自动更新？

Ark-TS UI 的秘密武器就是@State装饰器。当count的值变化时（比如点击按钮让count++），Ark-TS UI 会自动检测到这个变化，并重新渲染界面。你不需要手动操作界面元素，只需要关注数据逻辑，界面会 “自动听话”。

这种数据驱动界面的方式，让开发变得更简单。你只需要关心 “数据怎么变”，而不用操心 “界面怎么改”，Ark-TS UI 会帮你处理好一切。

五、晒为总结以下：从案例学 Ark-TS UI 的精髓

通过这个计数器案例，我们学到了 Ark-TS UI 的三个核心能力：

声明式语法：用简洁的代码描述界面结构，就像画图纸一样直观。

状态管理：@State让数据和界面自动联动，数据变，界面跟着变。

丰富的组件和样式：直接使用Text、Button等组件，通过链式调用快速设置样式，省去了复杂的 CSS 代码。

如果你想尝试鸿蒙 5 开发，Ark-TS UI 绝对是你入门的最佳选择。赶紧动手试试吧，下一个有趣的应用可能就出自你的代码！