• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Blank
2
3空白填充组件,在容器主轴方向上,空白填充组件具有自动填充容器空余部分的能力。仅当父组件为Row/Column/Flex时生效。
4
5>  **说明:**
6>
7>  该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
8
9
10## 子组件
11
1213
14
15## 接口
16
17Blank(min?: number | string)
18
19从API version 10开始:
20 - Blank在父容器Row、Column、Flex主轴方向上未设置大小时会自动拉伸、压缩,设置了大小或容器自适应子节点大小时不会自动拉伸、压缩。
21 - Blank设置主轴方向大小(size)与min时约束关系为max(min, size)。
22 - Blank在父容器交叉轴上设置大小时不会撑满父容器交叉轴,交叉轴不设置大小时alignSelf默认值为ItemAlign.Stretch,会撑满容器交叉轴。
23
24从API version 9开始,该接口支持在ArkTS卡片中使用。
25
26**参数:**
27
28| 参数名 | 参数类型 | 必填 | 参数描述 |
29| -------- | -------- | -------- | -------- |
30| min | number&nbsp;\|&nbsp;string | 否 | 空白填充组件在容器主轴上的最小大小。<br/>默认值:0<br/>**说明:** <br/>不支持设置百分比。负值使用默认值。当最小值大于容器可用空间时,使用最小值作为自身大小并超出容器。 |
31
32## 属性
33
34除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
35
36| 名称 | 参数类型 | 描述 |
37| -------- | -------- | -------- |
38| color | [ResourceColor](ts-types.md#resourcecolor) | 设置空白填充的填充颜色。<br/><br/>默认值:Color.Transparent<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
39
40## 事件
41
42支持[通用事件](ts-universal-events-click.md)。
43
44## 示例
45
46### 示例1
47Blank组件在横竖屏占满空余空间效果。
48```ts
49// xxx.ets
50@Entry
51@Component
52struct BlankExample {
53  build() {
54    Column() {
55      Row() {
56        Text('Bluetooth').fontSize(18)
57        Blank()
58        Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 })
59      }.width('100%').backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 })
60    }.backgroundColor(0xEFEFEF).padding(20)
61  }
62}
63```
64
65竖屏状态
66
67![zh-cn_image_0000001219662649](figures/zh-cn_image_0000001219662649.gif)
68
69横屏状态
70
71![zh-cn_image_0000001174104388](figures/zh-cn_image_0000001174104388.gif)
72
73
74### 示例2
75Blank组件的父组件未设置宽度时,min参数的使用效果。
76
77```ts
78// xxx.ets
79@Entry
80@Component
81struct BlankExample {
82  build() {
83    Column({ space: 20 }) {
84      // blank父组件不设置宽度时,Blank失效,可以通过设置min最小宽度填充固定宽度
85      Row() {
86        Text('Bluetooth').fontSize(18)
87        Blank().color(Color.Yellow)
88        Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 })
89      }.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 })
90
91      Row() {
92        Text('Bluetooth').fontSize(18)
93        // 设置最小宽度为160
94        Blank('160').color(Color.Yellow)
95        Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 })
96      }.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 })
97
98    }.backgroundColor(0xEFEFEF).padding(20).width('100%')
99  }
100}
101```
102Blank父组件未设置宽度时,子组件间无空白填充,使用min参数设置填充尺寸
103
104![blankmin](figures/blankmin.png)
105
106