1# 显隐控制
2
3控制组件是否可见。
4
5>  **说明：**
6>
7> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
8
9## visibility
10
11visibility(value: Visibility)
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  | [Visibility](ts-appendix-enums.md#visibility) | 是   | 控制当前组件显示或隐藏。根据具体场景需要可使用[条件渲染](../../../quick-start/arkts-rendering-control-ifelse.md)代替。<br/>默认值：Visibility.Visible |
26
27
28## 示例
29
30 该示例通过visibility配置不同的值实现不同的显隐控制效果。
31
32```ts
33// xxx.ets
34@Entry
35@Component
36struct VisibilityExample {
37  build() {
38    Column() {
39      Column() {
40        // 隐藏不参与占位
41        Text('None').fontSize(9).width('90%').fontColor(0xCCCCCC)
42        Row().visibility(Visibility.None).width('90%').height(80).backgroundColor(0xAFEEEE)
43
44        // 隐藏参与占位
45        Text('Hidden').fontSize(9).width('90%').fontColor(0xCCCCCC)
46        Row().visibility(Visibility.Hidden).width('90%').height(80).backgroundColor(0xAFEEEE)
47
48        // 正常显示，组件默认的显示模式
49        Text('Visible').fontSize(9).width('90%').fontColor(0xCCCCCC)
50        Row().visibility(Visibility.Visible).width('90%').height(80).backgroundColor(0xAFEEEE)
51      }.width('90%').border({ width: 1 })
52    }.width('100%').margin({ top: 5 })
53  }
54}
55```
56
57![visibility.png](figures/visibility.png)
58