• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 基本语法概述
2<!--Kit: ArkUI-->
3<!--Subsystem: ArkUI-->
4<!--Owner: @jiyujia926-->
5<!--Designer: @s10021109-->
6<!--Tester: @TerryTsao-->
7<!--Adviser: @zhang_yixin13-->
8
9在初步了解ArkTS语言后,本指南将以具体的示例来说明ArkTS的基本组成。
10
11如下图所示,点击“按钮”时,文本内容从“Hello World”变为“Hello ArkUI”。
12
13  **图1** 示例效果图  
14
15![Video_2023-03-06_152548](figures/Video_2023-03-06_152548.gif)
16
17本示例中,ArkTS的基本组成如下所示。
18
19  **图2** ArkTS的基本组成  
20
21![arkts-basic-grammar](figures/arkts-basic-grammar.png)
22
23> **说明:**
24>
25> 自定义变量不能与基础通用属性/事件名重复。
26
27- 装饰器: 用于装饰类、结构、方法以及变量,并赋予其特殊的含义。如上述示例中\@Entry、\@Component和\@State都是装饰器,[@Component](arkts-create-custom-components.md#component)表示自定义组件,[@Entry](arkts-create-custom-components.md#entry)表示该自定义组件为入口组件,[@State](arkts-state.md)表示组件中的状态变量,状态变量变化会触发UI刷新。
28
29- [UI描述](arkts-declarative-ui-description.md):以声明式的方式来描述UI的结构,例如build()方法中的代码块。
30
31- [自定义组件](arkts-create-custom-components.md):可复用的UI单元,可组合其他组件,如上述被\@Component装饰的struct Hello。
32
33- 系统组件:ArkUI框架中默认内置的基础和容器组件,可以直接调用,例如示例中的Column、Text、Divider、Button。
34
35- [属性方法](../../reference/apis-arkui/arkui-ts/ts-component-general-attributes.md):组件可以通过链式调用配置多项属性,如fontSize()、width()、height()、backgroundColor()等。
36
37- [事件方法](../../reference/apis-arkui/arkui-ts/ts-component-general-events.md):组件可以通过链式调用设置多个事件的响应逻辑,如跟随在Button后面的onClick()。
38
39除此之外,ArkTS扩展了多种语法范式来使开发更加便捷:
40
41- [@Builder](arkts-builder.md)/[@BuilderParam](arkts-builderparam.md):特殊的封装UI描述的方法,细粒度的封装和复用UI描述。
42
43- [@Extend](arkts-extend.md)/[@Styles](arkts-style.md):扩展系统组件和封装属性样式,更灵活地组合系统组件。
44
45- [stateStyles](arkts-statestyles.md):多态样式,可以依据组件的内部状态的不同,设置不同样式。