ts-universal-attributes-flex-layout.md 4.4 KB
Newer Older
Z
zengyawen 已提交
1
# Flex布局
Z
zengyawen 已提交
2

H
geshi  
HelloCrease 已提交
3
>  **说明:**
H
HelloCrease 已提交
4 5 6
>  - 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
>  - 仅当父组件是 Flex、Column、Row 时生效。
Z
zengyawen 已提交
7 8


Z
zengyawen 已提交
9 10
## 属性

H
HelloCrease 已提交
11 12
| 名称         | 参数说明                                     | 描述                                       |
| ---------- | ---------------------------------------- | ---------------------------------------- |
X
xiexiyun 已提交
13
| flexBasis  | number \| string                         | 设置组件在父容器主轴方向上的基准尺寸。<br/>默认值:'auto'(表示组件在主轴方向上的基准尺寸为组件原本的大小)。<br/>不支持百分比设置。 |
H
HelloCrease 已提交
14
| flexGrow   | number                                   | 设置父容器的剩余空间分配给此属性所在组件的比例。<br/>默认值:0       |
15
| flexShrink | number                                   | 设置父容器压缩尺寸分配给此属性所在组件的比例。<br/>父容器为Row、Column时,默认值:0<br/> 父容器为flex时,默认值:1       |
H
HelloCrease 已提交
16
| alignSelf  | [ItemAlign](ts-appendix-enums.md#itemalign) | 子组件在父容器交叉轴的对齐格式,覆盖Flex布局容器中alignItems默认配置。<br/>默认值:ItemAlign.Auto |
Z
zengyawen 已提交
17

Z
zengyawen 已提交
18 19

## 示例
Z
zengyawen 已提交
20

H
geshi  
HelloCrease 已提交
21 22
```ts
// xxx.ets
Z
zengyawen 已提交
23 24 25 26 27 28 29
@Entry
@Component
struct FlexExample {
  build() {
    Column({ space: 5 }) {
      Text('flexBasis').fontSize(9).fontColor(0xCCCCCC).width('90%')
      // 基于主轴基准尺寸
T
second  
tianyu 已提交
30
      // flexBasis()值可以是'auto',表示基准尺寸是元素本来的大小 ,也可以是长度设置,相当于.width()/.height()
Z
zengyawen 已提交
31 32
      Flex() {
        Text('flexBasis(100)')
W
wangshuainan 已提交
33 34 35 36 37
          .flexBasis('100')
          .height(100)
          .lineHeight(70)
          .backgroundColor(0xF5DEB3)
          .textAlign(TextAlign.Center)
Z
zengyawen 已提交
38
        Text('flexBasis("auto")')
W
wangshuainan 已提交
39 40 41 42 43 44
          .flexBasis('auto')
          .width('60%')
          .height(100)
          .lineHeight(70)
          .backgroundColor(0xD2B48C)
          .textAlign(TextAlign.Center)
Z
zengyawen 已提交
45 46 47 48 49 50 51
      }.width('90%').height(120).padding(10).backgroundColor(0xAFEEEE)

      Text('flexGrow').fontSize(9).fontColor(0xCCCCCC).width('90%')
      // 剩余空间所占比例
      // flexGrow()剩余空间分配给该元素的比例
      Flex() {
        Text('flexGrow(2)')
W
wangshuainan 已提交
52 53 54 55 56
          .flexGrow(2)
          .height(100)
          .lineHeight(70)
          .backgroundColor(0xF5DEB3)
          .textAlign(TextAlign.Center)
Z
zengyawen 已提交
57
        Text('flexGrow(1)')
W
wangshuainan 已提交
58 59 60 61 62
          .flexGrow(1)
          .height(100)
          .lineHeight(70)
          .backgroundColor(0xD2B48C)
          .textAlign(TextAlign.Center)
Z
zengyawen 已提交
63 64 65 66 67 68 69
      }.width('90%').height(120).padding(10).backgroundColor(0xAFEEEE)

      Text('flexShrink').fontSize(9).fontColor(0xCCCCCC).width('90%')
      // flexShrink()此属性所在的组件的比例
      // text1比例是0,其他都是默认值1,放不下时直接等比例缩放后两个,第一个不缩放
      Flex({ direction: FlexDirection.Row }) {
        Text('flexShrink(0)')
W
wangshuainan 已提交
70 71 72 73 74 75
          .flexShrink(0)
          .width('50%')
          .height(100)
          .lineHeight(70)
          .backgroundColor(0xF5DEB3)
          .textAlign(TextAlign.Center)
Z
zengyawen 已提交
76
        Text('no flexShrink')
W
wangshuainan 已提交
77 78 79 80 81
          .width('40%')
          .height(100)
          .lineHeight(70)
          .backgroundColor(0xD2B48C)
          .textAlign(TextAlign.Center)
Z
zengyawen 已提交
82
        Text('flexShrink(2)')
W
wangshuainan 已提交
83 84 85 86 87 88
          .flexShrink(2)
          .width('40%')
          .height(100)
          .lineHeight(70)
          .backgroundColor(0xF5DEB3)
          .textAlign(TextAlign.Center)
Z
zengyawen 已提交
89 90 91 92 93 94 95 96
      }.width('90%').height(120).padding(10).backgroundColor(0xAFEEEE)

      Text('alignSelf').fontSize(9).fontColor(0xCCCCCC).width('90%')
      // alignSelf()覆盖Flex布局容器中alignItems默认配置
      Flex({ direction: FlexDirection.Row, alignItems: ItemAlign.Center }) {
        Text('no alignSelf,height:80').width('33%').height(80)
          .backgroundColor(0xF5DEB3).textAlign(TextAlign.Center)
        Text('alignSelf stretch')
W
wangshuainan 已提交
97 98 99 100 101 102
          .alignSelf(ItemAlign.Stretch)
          .width('33%')
          .height(80)
          .lineHeight(70)
          .backgroundColor(0xD2B48C)
          .textAlign(TextAlign.Center)
Z
zengyawen 已提交
103 104 105 106 107 108 109 110
        Text('no alignSelf,height:100').width('34%').height(100)
          .backgroundColor(0xF5DEB3).textAlign(TextAlign.Center)
      }.width('90%').height(120).padding(10).backgroundColor(0xAFEEEE)
    }.width('100%').margin({ top: 5 })
  }
}
```

Z
zengyawen 已提交
111
![zh-cn_image_0000001219744197](figures/zh-cn_image_0000001219744197.png)