背景

在項目中使用 AGUI 或 HarmonyOS 的自定義組件時，我們經常會用到 attributeModifier 來動態修改組件的屬性，比如顏色、圓角、邊框等等。
不過不少同學在嘗試實現“按壓態背景變化”時，會遇到一個常見問題：顏色怎麼點也不變。

比如下面這段代碼：

class MyButtonModifier implements AttributeModifier<ButtonAttribute> {
  applyNormalAttribute(instance: ButtonAttribute): void {
    instance.backgroundColor(Color.Blue);
  }
  applyPressedAttribute(instance: ButtonAttribute): void {
    instance.backgroundColor(Color.Red);
  }
}

理論上，這個 Modifier 應該能讓按鈕在常態下是藍色，按下去變成紅色。但運行後會發現，顏色壓根沒變。
那問題出在哪？下面我們來一點點拆解。

問題分析：為什麼 applyPressedAttribute 不生效？

AGUI 或鴻蒙的組件系統裏，attributeModifier 並不是所有組件都天然支持交互態（如 pressed、focused、disabled）。
尤其是 Button 這樣的組件，它的交互態生效與否，取決於以下幾個前提條件：

1. 組件需要具備可點擊行為（例如綁定 onClick 或者設置 stateEffect(true)）；
2. 屬性修改器需要與組件實例關聯到正確的生命週期；
3. 部分系統樣式會覆蓋自定義樣式（特別是系統主題 Button）。

也就是説，如果你只是單純地給按鈕加了一個 attributeModifier，但沒有明確告訴系統這個組件要響應按壓事件，它就不會主動進入 pressed 狀態。

換句話説，applyPressedAttribute 根本沒被觸發。

實戰演示：完整的 Demo

下面是一段可運行的示例代碼，我們通過一個簡單的按鈕驗證按壓態是否能正確觸發。

@Entry
@Component
struct ModifierDemo {
  build() {
    Column() {
      Button('點我看看效果')
        // 綁定 Modifier
        .attributeModifier(new MyButtonModifier())
        // 讓按鈕具有可點擊行為
        .onClick(() => {
          console.log('Button clicked');
        })
        // 確保按鈕支持狀態變化效果
        .stateEffect(true)
        .margin({ top: 50 })
        .width('60%')
        .height(50)
        .fontSize(18)
        .fontColor(Color.White)
    }
  }
}

// 自定義 Modifier
class MyButtonModifier implements AttributeModifier<ButtonAttribute> {
  applyNormalAttribute(instance: ButtonAttribute): void {
    instance.backgroundColor(Color.Blue);
  }

  applyPressedAttribute(instance: ButtonAttribute): void {
    instance.backgroundColor(Color.Red);
  }
}

代碼解析

• .attributeModifier(new MyButtonModifier())
  用我們自定義的 Modifier 來修改組件的屬性。
• .stateEffect(true)
  這是關鍵。它告訴系統按鈕要響應狀態變化，否則 applyPressedAttribute 不會觸發。
• .onClick()
  保證這個組件確實是“可交互”的。如果沒有點擊行為，有時候 pressed 狀態也不會生效。

運行這段代碼後，你會看到按鈕在常態下是藍色，一旦按下變成紅色，鬆開又變回藍色。

常見坑位總結

在實際開發中，這類問題特別容易踩坑。下面幾個是我在項目中經常遇到的點：

1. 忘了設置 .stateEffect(true)
   這是最常見原因。沒有它，applyPressedAttribute() 根本不會執行。
2. 使用了系統主題按鈕
   有些主題自帶按壓態，可能會覆蓋掉你自定義的背景色。如果是這種情況，建議改成基礎容器組件（如 Text 或 Column）+ 自定義交互邏輯。
3. Modifier 寫在錯誤組件上
   如果你的 Modifier 不是綁定在最終觸發點擊事件的組件上，按壓態也不會生效。
4. 屬性層級衝突
   比如按鈕外層又包了一層容器，並且這個容器也定義了背景色或動畫，會讓視覺上“看不出”顏色變了。

延伸：如何實現更多交互態（例如禁用態）

如果項目裏除了按壓態，還想自定義禁用態或懸浮態（hover），其實也可以在同一個 Modifier 裏實現，比如：

class AdvancedButtonModifier implements AttributeModifier<ButtonAttribute> {
  applyNormalAttribute(instance: ButtonAttribute): void {
    instance.backgroundColor(Color.Blue);
  }

  applyPressedAttribute(instance: ButtonAttribute): void {
    instance.backgroundColor(Color.Red);
  }

  applyDisabledAttribute(instance: ButtonAttribute): void {
    instance.backgroundColor(Color.Gray);
    instance.opacity(0.6);
  }
}

然後在組件中動態控制：

Button('提交')
  .attributeModifier(new AdvancedButtonModifier())
  .enabled(false) // 禁用態

這樣就能讓你的按鈕在不同交互狀態下呈現完全不同的樣式。

總結

如果你遇到了“applyPressedAttribute 不生效”的問題，核心要點是：

1. 按鈕必須是可交互的（綁定點擊事件）；
2. 必須顯式啓用 .stateEffect(true)；
3. 確認 Modifier 綁定正確，並未被系統主題覆蓋。

掌握了這三點，你的自定義按鈕效果就能輕鬆跑起來。