ts-container-row.md 2.7 KB
Newer Older
Z
zengyawen 已提交
1 2
# Row

Z
zengyawen 已提交
3 4
沿水平方向布局容器。

T
third  
tianyu 已提交
5 6 7
>  **说明:**
>
>  该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
Z
zengyawen 已提交
8

Z
zengyawen 已提交
9 10

## 子组件
Z
zengyawen 已提交
11 12 13

可以包含子组件。

Z
zengyawen 已提交
14 15 16

## 接口

T
third  
tianyu 已提交
17 18 19
Row(value?:{space?:  number | string })

**参数:**
Z
zengyawen 已提交
20

T
third  
tianyu 已提交
21 22 23
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| space | string&nbsp;\|&nbsp;number | 否 | 横向布局元素间距。<br/>默认值:0 |
Z
zengyawen 已提交
24 25 26 27


## 属性

T
third  
tianyu 已提交
28 29
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
S
sienna1128 已提交
30 31
| alignItems | [VerticalAlign](ts-appendix-enums.md#verticalalign) | 设置子组件在垂直方向上的对齐格式。当子组件与父组件高度一样时无效。<br/>默认值:VerticalAlign.Center |
| justifyContent<sup>8+</sup> | [FlexAlign](ts-appendix-enums.md#flexalign) | 设置子组件在水平方向上的对齐格式。当子组件与父组件宽度一样时无效。<br/>FlexAlign.Start |
Z
zengyawen 已提交
32 33 34


## 示例
Z
zengyawen 已提交
35

H
geshi  
HelloCrease 已提交
36 37
```ts
// xxx.ets
Z
zengyawen 已提交
38 39 40 41 42
@Entry
@Component
struct RowExample {
  build() {
    Column({ space: 5 }) {
S
sienna1128 已提交
43
      // 设置子组件水平方向的间距为5
Z
zengyawen 已提交
44
      Text('space').fontSize(9).fontColor(0xCCCCCC).width('90%')
S
sienna1128 已提交
45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
      Row({ space: 5 }) {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').height(107).border({ width: 1 })

      // 设置子元素垂直方向对齐方式
      Text('alignItems(Bottom)').fontSize(9).fontColor(0xCCCCCC).width('90%')
      Row() {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').alignItems(VerticalAlign.Bottom).height('15%').border({ width: 1 })

      Text('alignItems(Center)').fontSize(9).fontColor(0xCCCCCC).width('90%')
      Row() {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').alignItems(VerticalAlign.Center).height('15%').border({ width: 1 })

      // 设置子元素水平方向对齐方式
      Text('justifyContent(End)').fontSize(9).fontColor(0xCCCCCC).width('90%')
      Row() {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').border({ width: 1 }).justifyContent(FlexAlign.End)

      Text('justifyContent(Center)').fontSize(9).fontColor(0xCCCCCC).width('90%')
      Row() {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').border({ width: 1 }).justifyContent(FlexAlign.Center)
Z
zengyawen 已提交
75 76 77 78 79
    }.width('100%')
  }
}
```

S
sienna1128 已提交
80
![row](figures/row.png)