• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 透明度设置
2
3设置组件的透明度。
4
5>  **说明：**
6>
7>  从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
8
9## opacity
10
11opacity(value: number | Resource)
12
13设置组件的不透明度。
14
15**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。
16
17**系统能力：** SystemCapability.ArkUI.ArkUI.Full
18
19**参数：**
20
21| 参数名 | 类型                                                 | 必填 | 说明                                                         |
22| ------ | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
23| value  | number&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 是   | 元素的不透明度，取值范围为0到1，1表示不透明，0表示完全透明, 达到隐藏组件效果，但是在布局中占位。 <br> 默认值：1 <br/>**说明：** <br/> 子组件会继承父组件的透明度，并与自身的透明度属性叠加。如：父组件透明度为0.1，子组件设置透明度为0.8，则子组件实际透明度为0.1*0.8=0.08。 |
24
25
26## 示例
27
28```ts
29// xxx.ets
30@Entry
31@Component
32struct OpacityExample {
33  build() {
34    Column({ space: 5 }) {
35      Text('opacity(1)').fontSize(9).width('90%').fontColor(0xCCCCCC)
36      Text().width('90%').height(50).opacity(1).backgroundColor(0xAFEEEE)
37      Text('opacity(0.7)').fontSize(9).width('90%').fontColor(0xCCCCCC)
38      Text().width('90%').height(50).opacity(0.7).backgroundColor(0xAFEEEE)
39      Text('opacity(0.4)').fontSize(9).width('90%').fontColor(0xCCCCCC)
40      Text().width('90%').height(50).opacity(0.4).backgroundColor(0xAFEEEE)
41      Text('opacity(0.1)').fontSize(9).width('90%').fontColor(0xCCCCCC)
42      Text().width('90%').height(50).opacity(0.1).backgroundColor(0xAFEEEE)
43      Text('opacity(0)').fontSize(9).width('90%').fontColor(0xCCCCCC)
44      Text().width('90%').height(50).opacity(0).backgroundColor(0xAFEEEE)
45    }
46    .width('100%')
47    .padding({ top: 5 })
48  }
49}
50```
51
52![opacity.png](figures/opacity.png)
53