鸿蒙HarmonyOS实战-ArkTS语言（基本语法）_arkts基本语法_鸿蒙arkts语言

先自我介绍一下，小编浙江大学毕业，去过华为、字节跳动等大厂，目前阿里P7

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新HarmonyOS鸿蒙全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上鸿蒙开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以添加V获取：vip204888 （备注鸿蒙）

正文

}
}

class Dog extends Animal {
bark() {
console.log(“Woof! Woof!”);
}
}

let dog = new Dog(“Bobby”);
dog.move(10); // 输出 “Bobby moved 10m.”
dog.bark(); // 输出 “Woof! Woof!”

2.5 类的访问修饰符

TypeScript的类可以通过访问修饰符来控制类的属性和方法的访问权限。有三个访问修饰符可以使用：public、private和protected。默认情况下，都是public。

public：公共的，任何外部或内部都可以访问。

private：私有的，只有类的内部可以访问，外部无法访问。

protected：受保护的，只有类的内部和其子类可以访问，外部无法访问。

class Person {
protected name: string;
constructor(name: string) {
this.name = name;
}
protected sayHello() {
console.log(Hello, I'm ${this.name}.);
}
}

class Student extends Person {
constructor(name: string) {
super(name);
}
public sayHelloToTeacher(teacher: Person) {
console.log(Hello, ${teacher.name}, I'm ${this.name}.);
}
}

let tom = new Student(“Tom”);
let bob = new Person(“Bob”);
tom.sayHelloToTeacher(bob); // 输出 “Hello, Bob, I’m Tom.”
bob.sayHello(); // 报错：属性 ‘sayHello’ 受保护，只能在类 ‘Person’ 及其子类中访问。

以上只是举例一些TS的基础语法，TS内容远不止这些不懂的可以去学学TS。

3.ArkTS的基本组成

• 装饰器：用于装饰类、结构、方法以及变量，并赋予其特殊的含义。如上述示例中@Entry、@Component和@State都是装饰器，@Component表示自定义组件，@Entry表示该自定义组件为入口组件，@State表示组件中的状态变量，状态变量变化会触发UI刷新。
• UI描述：以声明式的方式来描述UI的结构，例如build()方法中的代码块。
• 自定义组件：可复用的UI单元，可组合其他组件，如上述被@Component装饰的struct Hello。
• 系统组件：ArkUI框架中默认内置的基础和容器组件，可直接被开发者调用，比如示例中的Column、Text、Divider、Button。
• 属性方法：组件可以通过链式调用配置多项属性，如fontSize()、width()、height()、backgroundColor()等。
• 事件方法：组件可以通过链式调用设置多个事件的响应逻辑，如跟随在Button后面的onClick()。
  系统组件、属性方法、事件方法具体使用可参考基于ArkTS的声明式开发范式。

除此之外，ArkTS扩展了多种语法范式来使开发更加便捷：

• @Builder/@BuilderParam：特殊的封装UI描述的方法，细粒度的封装和复用UI描述。
• @Extend/@Style：扩展内置组件和封装属性样式，更灵活地组合内置组件。
• stateStyles：多态样式，可以依据组件的内部状态的不同，设置不同样式。

4.自定义组件

@Component
struct HelloComponent {
@State message: string = ‘Hello, World!’;

build() {
// HelloComponent自定义组件组合系统组件Row和Text
Row() {
Text(this.message)
.onClick(() => {
// 状态变量message的改变驱动UI刷新，UI从’Hello, World!‘刷新为’Hello, ArkUI!’
this.message = ‘Hello, ArkUI!’;
})
}
}
}

@Entry
@Component
struct ParentComponent {
build() {
Column() {
Text(‘ArkUI message’)
HelloComponent({ message: ‘Hello, World!’ });
Divider()
HelloComponent({ message: ‘你好!’ });
}
}
}

• struct：自定义组件基于struct实现，struct + 自定义组件名 +
  {…}的组合构成自定义组件，不能有继承关系。对于struct的实例化，可以省略new。
• build()函数：build()函数用于定义自定义组件的声明式UI描述，自定义组件必须定义build()函数。
• @Entry：@Entry装饰的自定义组件将作为UI页面的入口。在单个UI页面中，最多可以使用@Entry装饰一个自定义组件。@Entry可以接受一个可选的LocalStorage的参数。

4.1 build()函数规范

1、根节点唯一

@Entry
@Component
struct MyComponent {
build() {
// 根节点唯一且必要，必须为容器组件
Row() {
ChildComponent()
}
}
}

@Component
struct ChildComponent {
build() {
// 根节点唯一且必要，可为非容器组件
Image(‘test.jpg’)
}
}

2、不允许声明本地变量、打印、作用域

build() {
// 反例：不允许声明本地变量
let a: number = 1;
// 反例：不允许console.info
console.info(‘print debug log’);
// 反例：不允许本地作用域
{
…
}
}

3、不允许调用没有用@Builder装饰的方法，允许系统组件的参数是TS方法的返回值。

@Component
struct ParentComponent {
doSomeCalculations() {
}

calcTextValue(): string {
return ‘Hello World’;
}

@Builder doSomeRender() {
Text(Hello World)
}

build() {
Column() {
// 反例：不能调用没有用@Builder装饰的方法
this.doSomeCalculations();
// 正例：可以调用
this.doSomeRender();
// 正例：参数可以为调用TS方法的返回值
Text(this.calcTextValue())
}
}
}

4、不允许switch和表达式

build() {
Column() {
// 反例：不允许使用switch语法
switch (expression) {
case 1:
Text(‘…’)
break;
case 2:
Image(‘…’)
break;
default:
Text(‘…’)
break;
}
// 反例：不允许使用表达式
(this.aVar > 10) ? Text(‘…’) : Image(‘…’)
}
}

5.页面和自定义组件生命周期

页面生命周期，即被@Entry装饰的组件生命周期，提供以下生命周期接口：

• onPageShow：页面每次显示时触发。
• onPageHide：页面每次隐藏时触发一次。
• onBackPress：当用户点击返回按钮时触发。

组件生命周期，即一般用@Component装饰的自定义组件的生命周期，提供以下生命周期接口：

• aboutToAppear：组件即将出现时回调该接口，具体时机为在创建自定义组件的新实例后，在执行其build()函数之前执行。
• aboutToDisappear：在自定义组件即将析构销毁时执行。

// Index.ets
import router from ‘@ohos.router’;

@Entry
@Component
struct MyComponent {
@State showChild: boolean = true;

// 只有被@Entry装饰的组件才可以调用页面的生命周期
onPageShow() {
console.info(‘Index onPageShow’);
}
// 只有被@Entry装饰的组件才可以调用页面的生命周期
onPageHide() {
console.info(‘Index onPageHide’);
}

// 只有被@Entry装饰的组件才可以调用页面的生命周期
onBackPress() {
console.info(‘Index onBackPress’);
}

// 组件生命周期
aboutToAppear() {
console.info(‘MyComponent aboutToAppear’);
}

// 组件生命周期
aboutToDisappear() {
console.info(‘MyComponent aboutToDisappear’);
}

build() {
Column() {
// this.showChild为true，创建Child子组件，执行Child aboutToAppear
if (this.showChild) {
Child()
}
// this.showChild为false，删除Child子组件，执行Child aboutToDisappear
Button(‘create or delete Child’).onClick(() => {
this.showChild = false;
})
// push到Page2页面，执行onPageHide
Button(‘push to next page’)
.onClick(() => {
router.pushUrl({ url: ‘pages/Page2’ });
})
}

}
}

@Component
struct Child {
@State title: string = ‘Hello World’;
// 组件生命周期
aboutToDisappear() {
console.info(‘[lifeCycle] Child aboutToDisappear’)
}
// 组件生命周期
aboutToAppear() {
console.info(‘[lifeCycle] Child aboutToAppear’)
}

build() {
Text(this.title).fontSize(50).onClick(() => {
this.title = ‘Hello ArkUI’;
})
}
}

6.装饰函数

6.1 @Builder装饰器

@Builder主要是定义页面UI

6.1.1 装饰指向

1、自定义组件内自定义构建函数

@Builder MyBuilderFunction(){ … }
#使用
this.MyBuilderFunction(){ … }

2、MyGlobalBuilderFunction()

@Builder function MyGlobalBuilderFunction(){ … }
#使用
MyGlobalBuilderFunction()

6.1.2 参数传递

1、按引用传递参数

@Builder function ABuilder(KaTeX parse error: Can't use function '$' in math mode at position 64: …arByReference: $̲{.paramA1} `)
}
}
@Entry
@Component
struct Parent {
@State label: string = ‘Hello’;
build() {
Column() {
// 在Parent组件中调用ABuilder的时候，将this.label引用传递给ABuilder
ABuilder({ paramA1: this.label })
Button(‘Click me’).onClick(() => {
// 点击“Click me”后，UI从“Hello”刷新为“ArkUI”
this.label = ‘ArkUI’;
})
}
}
}

2、按值传递参数

@Builder function ABuilder(paramA1: string) {
Row() {
Text(UseStateVarByValue: ${paramA1} )
}
}
@Entry
@Component
struct Parent {
label: string = ‘Hello’;
build() {
Column() {
ABuilder(this.label)
}
}
}

6.2 @BuilderParam装饰器

@BuilderParam用来装饰指向@Builder方法的变量，开发者可在初始化自定义组件时对此属性进行赋值，为自定义组件增加特定的功能。

6.2.1 装饰指向

1、本地初始化@BuilderParam

@Builder function GlobalBuilder0() {}

@Component
struct Child {
@Builder doNothingBuilder() {};

@BuilderParam aBuilder0: () => void = this.doNothingBuilder;
@BuilderParam aBuilder1: () => void = GlobalBuilder0;
build(){}
}

2、初始化子组件@BuilderParam

@Component
struct Child {
@BuilderParam aBuilder0: () => void;

build() {
Column() {
this.aBuilder0()
}
}
}

@Entry
@Component
struct Parent {
@Builder componentBuilder() {
Text(Parent builder )
}

build() {
Column() {
Child({ aBuilder0: this.componentBuilder })
}
}
}

this都是器其本身，不会存在传递。

6.2.2 使用场景

1、参数化传递

@Builder function GlobalBuilder1(KaTeX parse error: Expected '}', got 'EOF' at end of input: …ring }) { Text(.label)
.width(400)
.height(50)
.backgroundColor(Color.Blue)
}

@Component
struct Child {
label: string = ‘Child’
// 无参数类，指向的componentBuilder也是无参数类型
@BuilderParam aBuilder0: () => void;
// 有参数类型，指向的GlobalBuilder1也是有参数类型的方法
@BuilderParam aBuilder1: ($$ : { label : string}) => void;

build() {
Column() {
this.aBuilder0()
this.aBuilder1({label: ‘global Builder label’ } )
}
}
}

@Entry
@Component
struct Parent {
label: string = ‘Parent’

@Builder componentBuilder() {
Text(${this.label})
}

build() {
Column() {
this.componentBuilder()
Child({ aBuilder0: this.componentBuilder, aBuilder1: GlobalBuilder1 })
}
}
}

2、尾随闭包

// xxx.ets
@Component
struct CustomContainer {
@Prop header: string;
@BuilderParam closer: () => void

build() {
Column() {
Text(this.header)
.fontSize(30)
this.closer()
}
}
}

@Builder function specificParam(label1: string, label2: string) {
Column() {
Text(label1)
.fontSize(30)
Text(label2)
.fontSize(30)
}
}

@Entry
@Component
struct CustomContainerUser {
@State text: string = ‘header’;

build() {
Column() {
// 创建CustomContainer，在创建CustomContainer时，通过其后紧跟一个大括号“{}”形成尾随闭包
// 作为传递给子组件CustomContainer @BuilderParam closer: () => void的参数
CustomContainer({ header: this.text }) {
Column() {
specificParam(‘testA’, ‘testB’)
}.backgroundColor(Color.Yellow)
.onClick(() => {
this.text = ‘changeHeader’;
})
}
}
}
}

6.3 @Styles装饰器

@Styles装饰器主要是定义公共样式

6.3.1 装饰指向

1、全局

// 全局
@Styles function functionName() { … }

// 在组件内
@Component
struct FancyUse {
@Styles fancy() {
.height(100)
}
}

2、组件内

@Component
struct FancyUse {
@State heightValue: number = 100
@Styles fancy() {
.height(this.heightValue)
.backgroundColor(Color.Yellow)
.onClick(() => {
this.heightValue = 200
})
}
}

6.3.2 使用场景

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

向

1、全局

// 全局
@Styles function functionName() { … }

// 在组件内
@Component
struct FancyUse {
@Styles fancy() {
.height(100)
}
}

2、组件内

@Component
struct FancyUse {
@State heightValue: number = 100
@Styles fancy() {
.height(this.heightValue)
.backgroundColor(Color.Yellow)
.onClick(() => {
this.heightValue = 200
})
}
}

6.3.2 使用场景

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）
[外链图片转存中…(img-zUw7Yx4x-1713647730286)]

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！