鴻蒙ArkUI實(shí)例：【自定義組件】

組件是 OpenHarmony 頁(yè)面最小顯示單元，一個(gè)頁(yè)面可由多個(gè)組件組合而成，也可只由一個(gè)組件組合而成，這些組件可以是ArkUI開(kāi)發(fā)框架自帶系統(tǒng)組件，比如 Text 、 Button 等，也可以是自定義組件，本節(jié)筆者簡(jiǎn)單介紹一下自定義組件的語(yǔ)法規(guī)范。

定義組件

自定義一個(gè)組件，首先要定義好名稱，盡量做到見(jiàn)名知意，比如定義一個(gè)標(biāo)題欄組件，筆者把它命名為 TitleBar ，為了讓系統(tǒng)知道這是一個(gè)組件，需要使用 @Component 修飾符和 struct 關(guān)鍵字修飾，格式：【@Component struct + 組件名稱】，如下所示：

@Component struct TitleBar {
  build() {
    // 省略
  }
}

@Entry @Component struct Index {
  build() {
    // 省略
  }
}

• struct ：表示 TitleBar 是一個(gè)結(jié)構(gòu)體，使用 struct 關(guān)鍵字必須實(shí)現(xiàn) build() 方法，否則編譯器報(bào)錯(cuò)：Require build function for struct 。
• @Component ：表示 TitleBar 這個(gè)結(jié)構(gòu)體具有組件化的能力，也就是說(shuō)它可以成為一個(gè)獨(dú)立的組件。
• @Entry ：表示當(dāng)前組件是頁(yè)面的總?cè)肟?，?jiǎn)單理解就是頁(yè)面的根節(jié)點(diǎn)，一個(gè)頁(yè)面有且僅有一個(gè) @Entry 修飾符，只有被 @Entry 修飾的組件或者子組件才會(huì)在頁(yè)面上顯示。

審核編輯 黃宇