组件是 OpenHarmony 页面最小显示单位,一个页面可由多个组件组合而成,也可只由一个组件组合而成,这些组件可以是ArkUI开发框架自带体系组件,比如 Text 、 Button 等,也可以是自界说组件,本节笔者简朴先容一下自界说组件的语法规范。
界说组件
自界说一个组件,首先要界说好名称,只管做到见名知意,比如界说一个标题栏组件,笔者把它命名为 TitleBar ,为了让体系知道这是一个组件,必要利用 @Component 修饰符和 struct 关键字修饰,格式:【@Component struct + 组件名称】,如下所示:
- @Component struct TitleBar {
- build() {
- // 省略
- }
- }
- @Entry @Component struct Index {
- build() {
- // 省略
- }
- }
复制代码
- struct:表现 TitleBar 是一个结构体,利用 struct 关键字必须实现 build() 方法,否则编译器报错:Require build function for struct 。
- @Component:表现 TitleBar 这个结构体具有组件化的能力,也就是说它可以成为一个独立的组件。
- @Entry:表现当前组件是页面的总入口,简朴理解就是页面的根节点,一个页面有且仅有一个 @Entry 修饰符,只有被 @Entry 修饰的组件或者子组件才会在页面上显示。
|