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