• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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```ts
31// xxx.ets
32@Entry
33@Component
34struct VisibilityExample {
35  build() {
36    Column() {
37      Column() {
38        // 隐藏不参与占位
39        Text('None').fontSize(9).width('90%').fontColor(0xCCCCCC)
40        Row().visibility(Visibility.None).width('90%').height(80).backgroundColor(0xAFEEEE)
41
42        // 隐藏参与占位
43        Text('Hidden').fontSize(9).width('90%').fontColor(0xCCCCCC)
44        Row().visibility(Visibility.Hidden).width('90%').height(80).backgroundColor(0xAFEEEE)
45
46        // 正常显示，组件默认的显示模式
47        Text('Visible').fontSize(9).width('90%').fontColor(0xCCCCCC)
48        Row().visibility(Visibility.Visible).width('90%').height(80).backgroundColor(0xAFEEEE)
49      }.width('90%').border({ width: 1 })
50    }.width('100%').margin({ top: 5 })
51  }
52}
53```
54
55![visibility.png](figures/visibility.png)
56