• 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**系统能力：** SystemCapability.ArkUI.ArkUI.Full
18
19**参数：**
20
21| 参数名 | 类型                                          | 必填 | 说明                                                         |
22| ------ | --------------------------------------------- | ---- | ------------------------------------------------------------ |
23| value  | [Visibility](ts-appendix-enums.md#visibility) | 是   | 控制当前组件显示或隐藏。根据具体场景需要可使用[条件渲染](../../../quick-start/arkts-rendering-control-ifelse.md)代替。<br/>默认值：Visibility.Visible |
24
25
26## 示例
27
28```ts
29// xxx.ets
30@Entry
31@Component
32struct VisibilityExample {
33  build() {
34    Column() {
35      Column() {
36        // 隐藏不参与占位
37        Text('None').fontSize(9).width('90%').fontColor(0xCCCCCC)
38        Row().visibility(Visibility.None).width('90%').height(80).backgroundColor(0xAFEEEE)
39
40        // 隐藏参与占位
41        Text('Hidden').fontSize(9).width('90%').fontColor(0xCCCCCC)
42        Row().visibility(Visibility.Hidden).width('90%').height(80).backgroundColor(0xAFEEEE)
43
44        // 正常显示，组件默认的显示模式
45        Text('Visible').fontSize(9).width('90%').fontColor(0xCCCCCC)
46        Row().visibility(Visibility.Visible).width('90%').height(80).backgroundColor(0xAFEEEE)
47      }.width('90%').border({ width: 1 })
48    }.width('100%').margin({ top: 5 })
49  }
50}
51```
52
53![visibility.png](figures/visibility.png)
54