在鸿蒙应用开发中,组件化是提升代码复用性和可维护性的关键。ArkUI作为HarmonyOS的声明式UI框架,提供了强大的组件化能力,但很多开发者仍然停留在基础组件的使用层面。本文将从实际项目出发,分享ArkUI组件化开发的核心实践。
## 一、自定义组件的封装原则
ArkUI的自定义组件(@Component)是组件化的基础。好的封装应该遵循单一职责和接口清晰两个原则:
```typescript
@Component
export struct PriceCard {
@Prop price: number = 0
@Prop discount: number = 0
@Prop unit: string = '\''¥'\''
private onBuy?: () => void
build() {
Row() {
Text(this.unit + this.price.toFixed(2))
.fontSize(20).fontWeight(FontWeight.Bold)
.fontColor(this.discount > 0 ? '\''#E84026'\'' : '\''#182431'\'')
if (this.discount > 0) {
Text(this.unit + (this.price * (1 - this.discount / 100)).toFixed(2))
.fontSize(14).fontColor('\''#999'\'')
.decoration({ type: TextDecorationType.LineThrough })
}
Button('\''购买'\'')
.onClick(() => this.onBuy?.())
}.justifyContent(FlexAlign.SpaceBetween)
}
}
```
关键点:使用@Prop实现单向数据流,通过回调函数暴露交互接口,保持组件内部状态的封闭性。
## 二、状态管理的分层策略
多组件协作时,状态管理是核心挑战。ArkUI提供了@State、@Link、@Prop、@Provide和@Consume等装饰器,合理分层是关键:
- **@State**:组件私有状态,只在当前组件内可变
- **@Prop**:父到子的单向传递,子组件只读
- **@Link**:父子双向同步,适合表单类场景
- **@Provide/@Consume**:跨层级传递,避免逐层prop drilling
```typescript
@Component
export struct CartPage {
@Provide cartItems: CartItem[] = []
@Provide totalCount: number = 0
build() {
Column() {
CartList() // 内部通过@Consume获取cartItems
CartSummary() // 内部通过@Consume获取totalCount
}
}
}
```
## 三、组件库的组织与按需加载
项目规模增大后,建议将通用组件抽取为独立模块。在HarmonyOS中,可以通过HSP(Harmony Shared Package)实现组件库的动态共享:
1. 创建HSP模块,将通用组件放入其中
2. 在oh-package.json5中声明依赖
3. 使用动态import实现按需加载,减少主包体积
```typescript
// 动态加载图表组件
import('\''./chartmodule/ChartComponent'\'').then(module => {
this.chartModule = module
})
```
## 四、实战建议
组件化开发不是一蹴而就的。建议从页面级组件拆分开始,逐步提取可复用的业务组件,最终沉淀为团队共享的组件库。每个组件都应有清晰的使用文档和类型定义,这是组件可持续复用的基石。
## 一、自定义组件的封装原则
ArkUI的自定义组件(@Component)是组件化的基础。好的封装应该遵循单一职责和接口清晰两个原则:
```typescript
@Component
export struct PriceCard {
@Prop price: number = 0
@Prop discount: number = 0
@Prop unit: string = '\''¥'\''
private onBuy?: () => void
build() {
Row() {
Text(this.unit + this.price.toFixed(2))
.fontSize(20).fontWeight(FontWeight.Bold)
.fontColor(this.discount > 0 ? '\''#E84026'\'' : '\''#182431'\'')
if (this.discount > 0) {
Text(this.unit + (this.price * (1 - this.discount / 100)).toFixed(2))
.fontSize(14).fontColor('\''#999'\'')
.decoration({ type: TextDecorationType.LineThrough })
}
Button('\''购买'\'')
.onClick(() => this.onBuy?.())
}.justifyContent(FlexAlign.SpaceBetween)
}
}
```
关键点:使用@Prop实现单向数据流,通过回调函数暴露交互接口,保持组件内部状态的封闭性。
## 二、状态管理的分层策略
多组件协作时,状态管理是核心挑战。ArkUI提供了@State、@Link、@Prop、@Provide和@Consume等装饰器,合理分层是关键:
- **@State**:组件私有状态,只在当前组件内可变
- **@Prop**:父到子的单向传递,子组件只读
- **@Link**:父子双向同步,适合表单类场景
- **@Provide/@Consume**:跨层级传递,避免逐层prop drilling
```typescript
@Component
export struct CartPage {
@Provide cartItems: CartItem[] = []
@Provide totalCount: number = 0
build() {
Column() {
CartList() // 内部通过@Consume获取cartItems
CartSummary() // 内部通过@Consume获取totalCount
}
}
}
```
## 三、组件库的组织与按需加载
项目规模增大后,建议将通用组件抽取为独立模块。在HarmonyOS中,可以通过HSP(Harmony Shared Package)实现组件库的动态共享:
1. 创建HSP模块,将通用组件放入其中
2. 在oh-package.json5中声明依赖
3. 使用动态import实现按需加载,减少主包体积
```typescript
// 动态加载图表组件
import('\''./chartmodule/ChartComponent'\'').then(module => {
this.chartModule = module
})
```
## 四、实战建议
组件化开发不是一蹴而就的。建议从页面级组件拆分开始,逐步提取可复用的业务组件,最终沉淀为团队共享的组件库。每个组件都应有清晰的使用文档和类型定义,这是组件可持续复用的基石。






































苏公安网备 32011402010933号