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**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。
18
19**系统能力：** SystemCapability.ArkUI.ArkUI.Full
20
21**参数：**
22
23| 参数名 | 类型                                                 | 必填 | 说明                                                         |
24| ------ | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
25| 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。 |
26
27
28## 示例
29
30该示例主要显示通过opacity设置组件的不透明度。
31
32```ts
33// xxx.ets
34@Entry
35@Component
36struct OpacityExample {
37  build() {
38    Column({ space: 5 }) {
39      Text('opacity(1)').fontSize(9).width('90%').fontColor(0xCCCCCC)
40      Text().width('90%').height(50).opacity(1).backgroundColor(0xAFEEEE)
41      Text('opacity(0.7)').fontSize(9).width('90%').fontColor(0xCCCCCC)
42      Text().width('90%').height(50).opacity(0.7).backgroundColor(0xAFEEEE)
43      Text('opacity(0.4)').fontSize(9).width('90%').fontColor(0xCCCCCC)
44      Text().width('90%').height(50).opacity(0.4).backgroundColor(0xAFEEEE)
45      Text('opacity(0.1)').fontSize(9).width('90%').fontColor(0xCCCCCC)
46      Text().width('90%').height(50).opacity(0.1).backgroundColor(0xAFEEEE)
47      Text('opacity(0)').fontSize(9).width('90%').fontColor(0xCCCCCC)
48      Text().width('90%').height(50).opacity(0).backgroundColor(0xAFEEEE)
49    }
50    .width('100%')
51    .padding({ top: 5 })
52  }
53}
54```
55
56![opacity.png](figures/opacity.png)
57