如何在 HarmonyOS NEXT 使用 @Styles 装饰器？

摘要

在鸿蒙 NEXT 开发中，@Styles 装饰器是一种非常有用的方法，用于定义可重用的样式。这使得开发者可以将多条样式设置提炼成一个方法，以便在多个组件中复用，从而提高代码的可维护性和可读性。以下是 @Styles 装饰器的详细用法和应用场景案例。

@Styles装饰器的使用说明

1.仅支持通用属性和事件：当前 @Styles 仅适用于通用属性和事件，不支持特定于某个组件的属性或事件。
2.不支持参数：@Styles 方法不能带有参数。例如，以下是一个错误的使用示例：

@Styles function globalStyles(value: number) {
     .width(value)
   }

正确的做法是不带参数：

@Styles function globalStyles() {
     .width(150)
     .height(100)
     .backgroundColor(Color.Pink)
   }

3.定义位置：@Styles 可以定义在组件内或全局。在全局定义时，需要在方法名前添加 function 关键字；在组件内定义时，则不需要。

// 全局定义
   @Styles function globalStyles() {
     .width(150)
     .height(100)
     .backgroundColor(Color.Pink)
   }

   // 组件内定义
   @Component
   struct FancyComponent {
     @Styles myStyle() {
       .width(200)
       .height(100)
       .backgroundColor(Color.Yellow)
     }
   }

4.访问组件内部状态：定义在组件内的 @Styles 可以通过 this 访问组件的常量和状态变量，并可以在 @Styles 里通过事件来改变状态变量的值。

@Component
   struct MyComponent {
     @State heightValue: number = 100
     @Styles myStyle() {
       .height(this.heightValue)
       .backgroundColor(Color.Yellow)
       .onClick(() => {
         this.heightValue = 200
       })
     }
   }

5.优先级：组件内 @Styles 的优先级高于全局 @Styles。框架会优先查找当前组件内的 @Styles，如果找不到，则会全局查找。

案例

以下是一个使用 @Styles 装饰器的示例，展示了如何在全局和组件内定义样式，并在组件中使用这些样式。

// 定义全局样式
@Styles function globalStyles() {
  .width(150)
  .height(100)
  .backgroundColor(Color.Pink)
}

@Entry
@Component
struct StyleUse {
  @State heightValue: number = 100
  // 定义组件内样式
  @Styles myStyle() {
    .width(200)
    .height(this.heightValue)
    .backgroundColor(Color.Yellow)
    .onClick(() => {
      this.heightValue = 200
    })
  }

  build() {
    Column({ space: 10 }) {
      // 使用全局样式
      Text('FancyA').globalStyles().fontSize(30)
      // 使用组件内样式
      Text('FancyB').myStyle().fontSize(30)
    }
  }
}

如何使用 @Styles 装饰器来优化组件代码？

1.识别重复的样式代码

2.定义 @Styles 方法

将这些重复的样式代码提炼到一个或多个 @Styles 方法中。

• 组件内样式：如果样式仅在单个组件中使用，可以在该组件内部定义 @Styles 方法。
• 全局样式：如果样式在多个组件中使用，可以定义为全局 @Styles 方法。

3.应用 @Styles 方法

4.使用状态和事件

优化示例

有一个应用，其中多个页面都有需要显示警告信息的 Text 组件，警告信息的样式在所有页面中都是一致的：红色、加粗、字体大小为16。

步骤1：定义全局 @Styles 方法

// 定义全局警告样式
@Styles function warningStyle() {
  .fontSize(16)
  .fontWeight(FontWeight.Bold)
  .fontColor(Color.Red)
}

步骤2：在组件中使用 @Styles 方法

@Entry
@Component
struct WarningMessage {
  build() {
    Column() {
      // 使用全局警告样式
      Text('这是一条警告信息').warningStyle()
    }
  }
}

总结

通过使用 @Styles 装饰器，你可以将样式逻辑从组件的业务逻辑中分离出来，使得代码更加清晰和易于管理。这不仅减少了代码的重复，也使得样式的修改和维护变得更加集中和高效。