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 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 \| 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 68 69横屏状态 70 71 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 105 106