在鴻蒙（HarmonyOS）應用開發中，@Type 是 ArkUI 框架中用于 類型定義和類型檢查 的關鍵注解（裝飾器）。它的主要作用是為自定義組件的屬性提供明確的類型約束，確保數據傳遞的類型安全性。
核心作用解析：
以下是 @Type 的核心用途和典型場景：
1. 屬性類型聲明
在自定義組件的屬性上使用 @Type，明確指定該屬性允許的數據類型：
@Component
struct MyComponent {
@Type(String) message: string; // 聲明message必須是字符串類型
@Type(Number) count: number;// 聲明count必須是數字類型
@Type(Boolean) isActive: boolean; // 布爾類型
}
2. 類型安全校驗
當父組件向子組件傳遞數據時，系統自動進行類型檢查：
// 父組件使用
@Component
struct Parent {
build() {
Column() {
// ? 正確：類型匹配
MyComponent({ message: "Hello", count: 100 })// ? 編譯錯誤：count類型不匹配（應為number）
MyComponent({ message: "Hi", count: "100" })
}
}
}
3. 支持復雜類型
可嵌套定義對象或數組結構：
@Type({ name: String, age: Number })
userInfo: { name: string, age: number };@Type([String])
tags: string[]; // 字符串數組
4. 聯合類型支持
允許指定多個可能的類型：
@Type(String, Number)
id: string | number; // 支持string或number類型
5. 強制類型轉換
自動將輸入數據轉換為聲明的類型（在安全范圍內）：
@Type(Number) inputValue: number;// 調用時傳入字符串 "123"，自動轉為數字 123
MyComponent({ inputValue: "123" })
實際應用場景示例：
場景：用戶卡片組件
@Component
struct UserCard {
// 聲明復雜類型結構
@Type({
name: String,
age: Number,
hobbies: [String] // 字符串數組
})
user: {
name: string,
age: number,
hobbies: string[]
};build() {
Column() {
Text(this.user.name).fontSize(20)
Text(`Age: ${this.user.age}`).fontColor(Color.Gray)
ForEach(this.user.hobbies, (hobby) => {
Text(hobby).margin(5)
})
}
}
}
父組件調用時：
// ? 正確用法
UserCard({
user: {
name: "Alice",
age: 28,
hobbies: ["Hiking", "Photography"]
}
})// ? 錯誤：hobbies應為數組
UserCard({
user: {
name: "Bob",
age: 32,
hobbies: "Gaming" // 類型不匹配！
}
})
與其他裝飾器的對比：
| 裝飾器 | 作用 | 常見搭配 |
|---|---|---|
@Type | 類型定義 + 類型安全檢查 | 屬性聲明 |
@Prop | 單向數據綁定 | @Type + 狀態同步 |
@Link | 雙向數據綁定 | @Type + 狀態同步 |
@State | 組件內部狀態管理 | 通常不需要額外@Type |
最佳實踐：
- 強制使用：為所有自定義組件的
public屬性添加@Type - 精確類型：避免使用
any，優先明確具體類型 - 組合使用：與數據綁定裝飾器配合使用：
@Component
struct Sample {
@Type(String) @Prop message: string; // 類型+單向綁定
@Type(Number) @Link counter: number; // 類型+雙向綁定
}
關鍵總結：
@Type是鴻蒙 ArkUI 的類型系統核心，通過編譯時類型檢查顯著提升代碼健壯性，防止因類型錯誤導致的運行時崩潰，同時增強代碼可讀性和維護性。
