1# Blank 2<!--Kit: ArkUI--> 3<!--Subsystem: ArkUI--> 4<!--Owner: @zju_ljz--> 5<!--Designer: @lanshouren--> 6<!--Tester: @liuli0427--> 7<!--Adviser: @HelloCrease--> 8 9空白填充组件，在容器主轴方向上，空白填充组件具有自动填充容器空余部分的能力。仅当父组件为[Row](ts-container-row.md)/[Column](ts-container-column.md)/[Flex](ts-container-flex.md)时生效。 10 11> **说明：** 12> 13> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 14 15 16## 子组件 17 18无 19 20 21## 接口 22 23Blank(min?: number | string) 24 25创建空白填充组件。 26 27从API version 10开始： 28 - Blank在父容器[Row](ts-container-row.md)、[Column](ts-container-column.md)、[Flex](ts-container-flex.md)主轴方向上未设置大小时会自动拉伸、压缩，设置了大小或容器自适应子节点大小时不会自动拉伸、压缩。 29 - Blank设置主轴方向大小（size）与min时约束关系为max(min, size)。 30 - Blank在父容器交叉轴上设置大小时不会撑满父容器交叉轴，交叉轴不设置大小时alignSelf默认值为ItemAlign.Stretch，会撑满容器交叉轴。 31 32**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 33 34**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用 35 36**系统能力：** SystemCapability.ArkUI.ArkUI.Full 37 38**参数：** 39 40| 参数名 | 类型 | 必填 | 说明 | 41| -------- | -------- | -------- | -------- | 42| min | number \| string | 否 | 空白填充组件在容器主轴上的最小大小。<br/>默认值：0，number类型单位为vp, string类型可以显式指定[像素单位](ts-pixel-units.md)，如'10px'。不指定像素单位时，默认单位vp，如'10'，等同于10vp。<br />非法值：按默认值处理。<br/>**说明：** <br/>不支持设置百分比。负值使用默认值。当最小值大于容器可用空间时，使用最小值作为自身大小并超出容器。 | 43 44## 属性 45 46除支持[通用属性](ts-component-general-attributes.md)外，还支持以下属性： 47 48### color 49 50color(value: ResourceColor) 51 52设置空白填充的填充颜色，支持[attributeModifier](ts-universal-attributes-attribute-modifier.md#attributemodifier)动态设置属性方法。 53 54**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 55 56**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用 57 58**系统能力：** SystemCapability.ArkUI.ArkUI.Full 59 60**参数：** 61 62| 参数名 | 类型 | 必填 | 说明 | 63| -------- | -------- | -------- | -------- | 64| value | [ResourceColor](ts-types.md#resourcecolor) | 是 | 空白填充的填充颜色。<br/>默认值：Color.Transparent <br />非法值：按默认值处理。 | 65 66## 事件 67 68支持[通用事件](ts-component-general-events.md)。 69 70## 示例 71 72### 示例1（占满空余空间） 73 74Blank组件在横竖屏占满空余空间效果。 75 76```ts 77// xxx.ets 78@Entry 79@Component 80struct BlankExample { 81 build() { 82 Column() { 83 Row() { 84 Text('Bluetooth').fontSize(18) 85 Blank() 86 Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 }) 87 }.width('100%').backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 }) 88 }.backgroundColor(0xEFEFEF).padding(20) 89 } 90} 91``` 92 93竖屏状态 94 95 96 97横屏状态 98 99 100 101 102### 示例2（填充固定宽度） 103 104Blank组件的父组件未设置宽度时，min参数的使用效果。 105 106```ts 107// xxx.ets 108@Entry 109@Component 110struct BlankExample { 111 build() { 112 Column({ space: 20 }) { 113 // Blank父组件不设置宽度时，Blank失效，可以通过设置min最小宽度填充固定宽度 114 Row() { 115 Text('Bluetooth').fontSize(18) 116 Blank().color(Color.Yellow) 117 Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 }) 118 }.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 }) 119 120 Row() { 121 Text('Bluetooth').fontSize(18) 122 // 设置最小宽度为160 123 Blank('160').color(Color.Yellow) 124 Toggle({ type: ToggleType.Switch }).margin({ top: 14, bottom: 14, left: 6, right: 6 }) 125 }.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 }) 126 127 }.backgroundColor(0xEFEFEF).padding(20).width('100%') 128 } 129} 130``` 131Blank父组件未设置宽度时，子组件间无空白填充，使用min参数设置填充尺寸 132 133 134 135
