1# 弹性布局 (Flex) 2 3 4## 概述 5 6弹性布局([Flex](../reference/apis-arkui/arkui-ts/ts-container-flex.md))提供更加有效的方式对容器中的子元素进行排列、对齐和分配剩余空间。常用于页面头部导航栏的均匀分布、页面框架的搭建、多行数据的排列等。 7 8容器默认存在主轴与交叉轴,子元素默认沿主轴排列,子元素在主轴方向的尺寸称为主轴尺寸,在交叉轴方向的尺寸称为交叉轴尺寸。 9 10 11 12 **图1** 主轴为水平方向的Flex容器示意图 13 14 15 16 17## 基本概念 18 19- 主轴:Flex组件布局方向的轴线,子元素默认沿着主轴排列。主轴开始的位置称为主轴起始点,结束位置称为主轴结束点。 20 21- 交叉轴:垂直于主轴方向的轴线。交叉轴开始的位置称为交叉轴起始点,结束位置称为交叉轴结束点。 22 23 24## 布局方向 25 26在弹性布局中,容器的子元素可以按照任意方向排列。通过设置参数direction,可以决定主轴的方向,从而控制子元素的排列方向。 27 28 **图2** 弹性布局方向图 29 30 31 32- FlexDirection.Row(默认值):主轴为水平方向,子元素从起始端沿着水平方向开始排布。 33 34 35 ```ts 36 Flex({ direction: FlexDirection.Row }) { 37 Text('1').width('33%').height(50).backgroundColor(0xF5DEB3) 38 Text('2').width('33%').height(50).backgroundColor(0xD2B48C) 39 Text('3').width('33%').height(50).backgroundColor(0xF5DEB3) 40 } 41 .height(70) 42 .width('90%') 43 .padding(10) 44 .backgroundColor(0xAFEEEE) 45 ``` 46 47  48 49- FlexDirection.RowReverse:主轴为水平方向,子元素从终点端沿着FlexDirection. Row相反的方向开始排布。 50 51 52 ```ts 53 Flex({ direction: FlexDirection.RowReverse }) { 54 Text('1').width('33%').height(50).backgroundColor(0xF5DEB3) 55 Text('2').width('33%').height(50).backgroundColor(0xD2B48C) 56 Text('3').width('33%').height(50).backgroundColor(0xF5DEB3) 57 } 58 .height(70) 59 .width('90%') 60 .padding(10) 61 .backgroundColor(0xAFEEEE) 62 ``` 63 64  65 66- FlexDirection.Column:主轴为垂直方向,子元素从起始端沿着垂直方向开始排布。 67 68 69 ```ts 70 Flex({ direction: FlexDirection.Column }) { 71 Text('1').width('100%').height(50).backgroundColor(0xF5DEB3) 72 Text('2').width('100%').height(50).backgroundColor(0xD2B48C) 73 Text('3').width('100%').height(50).backgroundColor(0xF5DEB3) 74 } 75 .height(70) 76 .width('90%') 77 .padding(10) 78 .backgroundColor(0xAFEEEE) 79 ``` 80 81  82 83- FlexDirection.ColumnReverse:主轴为垂直方向,子元素从终点端沿着FlexDirection. Column相反的方向开始排布。 84 85 86 ```ts 87 Flex({ direction: FlexDirection.ColumnReverse }) { 88 Text('1').width('100%').height(50).backgroundColor(0xF5DEB3) 89 Text('2').width('100%').height(50).backgroundColor(0xD2B48C) 90 Text('3').width('100%').height(50).backgroundColor(0xF5DEB3) 91 } 92 .height(70) 93 .width('90%') 94 .padding(10) 95 .backgroundColor(0xAFEEEE) 96 ``` 97 98  99 100 101## 布局换行 102 103弹性布局分为单行布局和多行布局。默认情况下,Flex容器中的子元素都排在一条线(又称“轴线”)上。wrap属性控制当子元素主轴尺寸之和大于容器主轴尺寸时,Flex是单行布局还是多行布局。在多行布局时,通过交叉轴方向,确认新行排列方向。 104 105- FlexWrap. NoWrap(默认值):不换行。如果子元素的宽度总和大于父元素的宽度,则子元素会被压缩宽度。 106 107 108 ```ts 109 Flex({ wrap: FlexWrap.NoWrap }) { 110 Text('1').width('50%').height(50).backgroundColor(0xF5DEB3) 111 Text('2').width('50%').height(50).backgroundColor(0xD2B48C) 112 Text('3').width('50%').height(50).backgroundColor(0xF5DEB3) 113 } 114 .width('90%') 115 .padding(10) 116 .backgroundColor(0xAFEEEE) 117 ``` 118 119  120 121- FlexWrap. Wrap:换行,每一行子元素按照主轴方向排列。 122 123 124 ```ts 125 Flex({ wrap: FlexWrap.Wrap }) { 126 Text('1').width('50%').height(50).backgroundColor(0xF5DEB3) 127 Text('2').width('50%').height(50).backgroundColor(0xD2B48C) 128 Text('3').width('50%').height(50).backgroundColor(0xD2B48C) 129 } 130 .width('90%') 131 .padding(10) 132 .backgroundColor(0xAFEEEE) 133 ``` 134 135  136 137- FlexWrap. WrapReverse:换行,每一行子元素按照主轴反方向排列。 138 139 140 ```ts 141 Flex({ wrap: FlexWrap.WrapReverse}) { 142 Text('1').width('50%').height(50).backgroundColor(0xF5DEB3) 143 Text('2').width('50%').height(50).backgroundColor(0xD2B48C) 144 Text('3').width('50%').height(50).backgroundColor(0xF5DEB3) 145 } 146 .width('90%') 147 .padding(10) 148 .backgroundColor(0xAFEEEE) 149 ``` 150 151  152 153 154## 主轴对齐方式 155 156通过justifyContent参数设置子元素在主轴方向的对齐方式。 157 158 159 160 161- FlexAlign.Start(默认值):子元素在主轴方向起始端对齐, 第一个子元素与父元素边沿对齐,其他元素与前一个元素对齐。 162 163 164 ```ts 165 Flex({ justifyContent: FlexAlign.Start }) { 166 Text('1').width('20%').height(50).backgroundColor(0xF5DEB3) 167 Text('2').width('20%').height(50).backgroundColor(0xD2B48C) 168 Text('3').width('20%').height(50).backgroundColor(0xF5DEB3) 169 } 170 .width('90%') 171 .padding({ top: 10, bottom: 10 }) 172 .backgroundColor(0xAFEEEE) 173 ``` 174 175  176 177- FlexAlign.Center:子元素在主轴方向居中对齐。 178 179 180 ```ts 181 Flex({ justifyContent: FlexAlign.Center }) { 182 Text('1').width('20%').height(50).backgroundColor(0xF5DEB3) 183 Text('2').width('20%').height(50).backgroundColor(0xD2B48C) 184 Text('3').width('20%').height(50).backgroundColor(0xF5DEB3) 185 } 186 .width('90%') 187 .padding({ top: 10, bottom: 10 }) 188 .backgroundColor(0xAFEEEE) 189 ``` 190 191  192 193- FlexAlign.End:子元素在主轴方向终点端对齐,最后一个子元素与父元素边沿对齐,其他元素与后一个元素对齐。 194 195 196 ```ts 197 Flex({ justifyContent: FlexAlign.End }) { 198 Text('1').width('20%').height(50).backgroundColor(0xF5DEB3) 199 Text('2').width('20%').height(50).backgroundColor(0xD2B48C) 200 Text('3').width('20%').height(50).backgroundColor(0xF5DEB3) 201 } 202 .width('90%') 203 .padding({ top: 10, bottom: 10 }) 204 .backgroundColor(0xAFEEEE) 205 ``` 206 207  208 209- FlexAlign.SpaceBetween:Flex主轴方向均匀分配弹性元素,相邻子元素之间距离相同。第一个子元素和最后一个子元素与父元素边沿对齐。 210 211 212 ```ts 213 Flex({ justifyContent: FlexAlign.SpaceBetween }) { 214 Text('1').width('20%').height(50).backgroundColor(0xF5DEB3) 215 Text('2').width('20%').height(50).backgroundColor(0xD2B48C) 216 Text('3').width('20%').height(50).backgroundColor(0xF5DEB3) 217 } 218 .width('90%') 219 .padding({ top: 10, bottom: 10 }) 220 .backgroundColor(0xAFEEEE) 221 ``` 222 223  224 225- FlexAlign.SpaceAround:Flex主轴方向均匀分配弹性元素,相邻子元素之间距离相同。第一个子元素到主轴起始端的距离和最后一个子元素到主轴终点端的距离是相邻元素之间距离的一半。 226 227 228 ```ts 229 Flex({ justifyContent: FlexAlign.SpaceAround }) { 230 Text('1').width('20%').height(50).backgroundColor(0xF5DEB3) 231 Text('2').width('20%').height(50).backgroundColor(0xD2B48C) 232 Text('3').width('20%').height(50).backgroundColor(0xF5DEB3) 233 } 234 .width('90%') 235 .padding({ top: 10, bottom: 10 }) 236 .backgroundColor(0xAFEEEE) 237 ``` 238 239  240 241- FlexAlign.SpaceEvenly:Flex主轴方向元素等间距布局,相邻子元素之间的间距、第一个子元素与主轴起始端的间距、最后一个子元素到主轴终点端的间距均相等。 242 243 244 ```ts 245 Flex({ justifyContent: FlexAlign.SpaceEvenly }) { 246 Text('1').width('20%').height(50).backgroundColor(0xF5DEB3) 247 Text('2').width('20%').height(50).backgroundColor(0xD2B48C) 248 Text('3').width('20%').height(50).backgroundColor(0xF5DEB3) 249 } 250 .width('90%') 251 .padding({ top: 10, bottom: 10 }) 252 .backgroundColor(0xAFEEEE) 253 ``` 254 255  256 257 258## 交叉轴对齐方式 259 260容器和子元素都可以设置交叉轴对齐方式,且子元素设置的对齐方式优先级较高。 261 262 263### 容器组件设置交叉轴对齐 264 265可以通过Flex组件的alignItems参数设置子元素在交叉轴的对齐方式。 266 267 268- ItemAlign.Auto:使用Flex容器中默认配置。 269 270 271 ```ts 272 Flex({ alignItems: ItemAlign.Auto }) { 273 Text('1').width('33%').height(30).backgroundColor(0xF5DEB3) 274 Text('2').width('33%').height(40).backgroundColor(0xD2B48C) 275 Text('3').width('33%').height(50).backgroundColor(0xF5DEB3) 276 } 277 .size({ width: '90%', height: 80 }) 278 .padding(10) 279 .backgroundColor(0xAFEEEE) 280 ``` 281 282  283 284- ItemAlign.Start:交叉轴方向首部对齐。 285 286 287 ```ts 288 Flex({ alignItems: ItemAlign.Start }) { 289 Text('1').width('33%').height(30).backgroundColor(0xF5DEB3) 290 Text('2').width('33%').height(40).backgroundColor(0xD2B48C) 291 Text('3').width('33%').height(50).backgroundColor(0xF5DEB3) 292 } 293 .size({ width: '90%', height: 80 }) 294 .padding(10) 295 .backgroundColor(0xAFEEEE) 296 ``` 297 298  299 300- ItemAlign.Center:交叉轴方向居中对齐。 301 302 303 ```ts 304 Flex({ alignItems: ItemAlign.Center }) { 305 Text('1').width('33%').height(30).backgroundColor(0xF5DEB3) 306 Text('2').width('33%').height(40).backgroundColor(0xD2B48C) 307 Text('3').width('33%').height(50).backgroundColor(0xF5DEB3) 308 } 309 .size({ width: '90%', height: 80 }) 310 .padding(10) 311 .backgroundColor(0xAFEEEE) 312 ``` 313 314  315 316- ItemAlign.End:交叉轴方向底部对齐。 317 318 319 ```ts 320 Flex({ alignItems: ItemAlign.End }) { 321 Text('1').width('33%').height(30).backgroundColor(0xF5DEB3) 322 Text('2').width('33%').height(40).backgroundColor(0xD2B48C) 323 Text('3').width('33%').height(50).backgroundColor(0xF5DEB3) 324 } 325 .size({ width: '90%', height: 80 }) 326 .padding(10) 327 .backgroundColor(0xAFEEEE) 328 ``` 329 330  331 332- ItemAlign.Stretch:交叉轴方向拉伸填充,在未设置尺寸时,拉伸到容器尺寸。 333 334 335 ```ts 336 Flex({ alignItems: ItemAlign.Stretch }) { 337 Text('1').width('33%').backgroundColor(0xF5DEB3) 338 Text('2').width('33%').backgroundColor(0xD2B48C) 339 Text('3').width('33%').backgroundColor(0xF5DEB3) 340 } 341 .size({ width: '90%', height: 80 }) 342 .padding(10) 343 .backgroundColor(0xAFEEEE) 344 ``` 345 346  347 348- ItemAlign. Baseline:交叉轴方向文本基线对齐。 349 350 351 ```ts 352 Flex({ alignItems: ItemAlign.Baseline }) { 353 Text('1').width('33%').height(30).backgroundColor(0xF5DEB3) 354 Text('2').width('33%').height(40).backgroundColor(0xD2B48C) 355 Text('3').width('33%').height(50).backgroundColor(0xF5DEB3) 356 } 357 .size({ width: '90%', height: 80 }) 358 .padding(10) 359 .backgroundColor(0xAFEEEE) 360 ``` 361 362  363 364 365### 子元素设置交叉轴对齐 366 367子元素的[alignSelf](../reference/apis-arkui/arkui-ts/ts-universal-attributes-flex-layout.md#alignself)属性也可以设置子元素在父容器交叉轴的对齐格式,且会覆盖Flex布局容器中alignItems配置。如下例所示: 368 369```ts 370Flex({ direction: FlexDirection.Row, alignItems: ItemAlign.Center }) { // 容器组件设置子元素居中 371 Text('alignSelf Start').width('25%').height(80) 372 .alignSelf(ItemAlign.Start) 373 .backgroundColor(0xF5DEB3) 374 Text('alignSelf Baseline') 375 .alignSelf(ItemAlign.Baseline) 376 .width('25%') 377 .height(80) 378 .backgroundColor(0xD2B48C) 379 Text('alignSelf Baseline').width('25%').height(100) 380 .backgroundColor(0xF5DEB3) 381 .alignSelf(ItemAlign.Baseline) 382 Text('no alignSelf').width('25%').height(100) 383 .backgroundColor(0xD2B48C) 384 Text('no alignSelf').width('25%').height(100) 385 .backgroundColor(0xF5DEB3) 386 387}.width('90%').height(220).backgroundColor(0xAFEEEE) 388``` 389 390 391 392 393 394上例中,Flex容器中alignItems设置交叉轴子元素的对齐方式为居中,子元素自身设置了alignSelf属性的情况,覆盖父组件的alignItems值,表现为alignSelf的定义。 395 396 397### 内容对齐 398 399可以通过[alignContent](../reference/apis-arkui/arkui-ts/ts-container-flex.md#接口)参数设置子元素各行在交叉轴剩余空间内的对齐方式,只在多行的Flex布局中生效,可选值有: 400 401- FlexAlign.Start:子元素各行与交叉轴起点对齐。 402 403 404 ```ts 405 Flex({ justifyContent: FlexAlign.SpaceBetween, wrap: FlexWrap.Wrap, alignContent: FlexAlign.Start }) { 406 Text('1').width('30%').height(20).backgroundColor(0xF5DEB3) 407 Text('2').width('60%').height(20).backgroundColor(0xD2B48C) 408 Text('3').width('40%').height(20).backgroundColor(0xD2B48C) 409 Text('4').width('30%').height(20).backgroundColor(0xF5DEB3) 410 Text('5').width('20%').height(20).backgroundColor(0xD2B48C) 411 } 412 .width('90%') 413 .height(100) 414 .backgroundColor(0xAFEEEE) 415 ``` 416 417  418 419- FlexAlign.Center:子元素各行在交叉轴方向居中对齐。 420 421 422 ```ts 423 Flex({ justifyContent: FlexAlign.SpaceBetween, wrap: FlexWrap.Wrap, alignContent: FlexAlign.Center }) { 424 Text('1').width('30%').height(20).backgroundColor(0xF5DEB3) 425 Text('2').width('60%').height(20).backgroundColor(0xD2B48C) 426 Text('3').width('40%').height(20).backgroundColor(0xD2B48C) 427 Text('4').width('30%').height(20).backgroundColor(0xF5DEB3) 428 Text('5').width('20%').height(20).backgroundColor(0xD2B48C) 429 } 430 .width('90%') 431 .height(100) 432 .backgroundColor(0xAFEEEE) 433 ``` 434 435  436 437- FlexAlign.End:子元素各行与交叉轴终点对齐。 438 439 440 ```ts 441 Flex({ justifyContent: FlexAlign.SpaceBetween, wrap: FlexWrap.Wrap, alignContent: FlexAlign.End }) { 442 Text('1').width('30%').height(20).backgroundColor(0xF5DEB3) 443 Text('2').width('60%').height(20).backgroundColor(0xD2B48C) 444 Text('3').width('40%').height(20).backgroundColor(0xD2B48C) 445 Text('4').width('30%').height(20).backgroundColor(0xF5DEB3) 446 Text('5').width('20%').height(20).backgroundColor(0xD2B48C) 447 } 448 .width('90%') 449 .height(100) 450 .backgroundColor(0xAFEEEE) 451 ``` 452 453  454 455- FlexAlign.SpaceBetween:子元素各行与交叉轴两端对齐,各行间垂直间距平均分布。 456 457 458 ```ts 459 Flex({ justifyContent: FlexAlign.SpaceBetween, wrap: FlexWrap.Wrap, alignContent: FlexAlign.SpaceBetween }) { 460 Text('1').width('30%').height(20).backgroundColor(0xF5DEB3) 461 Text('2').width('60%').height(20).backgroundColor(0xD2B48C) 462 Text('3').width('40%').height(20).backgroundColor(0xD2B48C) 463 Text('4').width('30%').height(20).backgroundColor(0xF5DEB3) 464 Text('5').width('20%').height(20).backgroundColor(0xD2B48C) 465 } 466 .width('90%') 467 .height(100) 468 .backgroundColor(0xAFEEEE) 469 ``` 470 471  472 473- FlexAlign.SpaceAround:子元素各行间距相等,是元素首尾行与交叉轴两端距离的两倍。 474 475 476 ```ts 477 Flex({ justifyContent: FlexAlign.SpaceBetween, wrap: FlexWrap.Wrap, alignContent: FlexAlign.SpaceAround }) { 478 Text('1').width('30%').height(20).backgroundColor(0xF5DEB3) 479 Text('2').width('60%').height(20).backgroundColor(0xD2B48C) 480 Text('3').width('40%').height(20).backgroundColor(0xD2B48C) 481 Text('4').width('30%').height(20).backgroundColor(0xF5DEB3) 482 Text('5').width('20%').height(20).backgroundColor(0xD2B48C) 483 } 484 .width('90%') 485 .height(100) 486 .backgroundColor(0xAFEEEE) 487 ``` 488 489  490 491- FlexAlign.SpaceEvenly: 子元素各行间距,子元素首尾行与交叉轴两端距离都相等。 492 493 494 ```ts 495 Flex({ justifyContent: FlexAlign.SpaceBetween, wrap: FlexWrap.Wrap, alignContent: FlexAlign.SpaceEvenly }) { 496 Text('1').width('30%').height(20).backgroundColor(0xF5DEB3) 497 Text('2').width('60%').height(20).backgroundColor(0xD2B48C) 498 Text('3').width('40%').height(20).backgroundColor(0xD2B48C) 499 Text('4').width('30%').height(20).backgroundColor(0xF5DEB3) 500 Text('5').width('20%').height(20).backgroundColor(0xD2B48C) 501 } 502 .width('90%') 503 .height(100) 504 .backgroundColor(0xAFEEEE) 505 ``` 506 507  508 509 510## 自适应拉伸 511 512在弹性布局父组件尺寸过小时,通过子元素的以下属性设置其在父容器的占比,达到自适应布局。 513 514- [flexBasis](../reference/apis-arkui/arkui-ts/ts-universal-attributes-flex-layout.md#flexbasis):设置子元素在父容器主轴方向上的基准尺寸。如果设置了该属性,则子项占用的空间为该属性所设置的值;如果没设置该属性,那子项的空间为width/height的值。 515 516 517 ```ts 518 Flex() { 519 Text('flexBasis("auto")') 520 .flexBasis('auto') // 未设置width以及flexBasis值为auto,内容自身宽度 521 .height(100) 522 .backgroundColor(0xF5DEB3) 523 Text('flexBasis("auto")'+' width("40%")') 524 .width('40%') 525 .flexBasis('auto') //设置width以及flexBasis值auto,使用width的值 526 .height(100) 527 .backgroundColor(0xD2B48C) 528 529 Text('flexBasis(100)') // 未设置width以及flexBasis值为100,宽度为100vp 530 .flexBasis(100) 531 .height(100) 532 .backgroundColor(0xF5DEB3) 533 534 Text('flexBasis(100)') 535 .flexBasis(100) 536 .width(200) // flexBasis值为100,覆盖width的设置值,宽度为100vp 537 .height(100) 538 .backgroundColor(0xD2B48C) 539 }.width('90%').height(120).padding(10).backgroundColor(0xAFEEEE) 540 ``` 541 542  543 544- [flexGrow](../reference/apis-arkui//arkui-ts/ts-universal-attributes-flex-layout.md#flexgrow):设置父容器的剩余空间分配给此属性所在组件的比例。用于分配父组件的剩余空间。 545 546 ```ts 547 Flex() { 548 Text('flexGrow(2)') 549 .flexGrow(2) 550 .width(100) 551 .height(100) 552 .backgroundColor(0xF5DEB3) 553 Text('flexGrow(3)') 554 .flexGrow(3) 555 .width(100) 556 .height(100) 557 .backgroundColor(0xD2B48C) 558 559 Text('no flexGrow') 560 .width(100) 561 .height(100) 562 .backgroundColor(0xF5DEB3) 563 }.width(420).height(120).padding(10).backgroundColor(0xAFEEEE) 564 ``` 565 566  567 568 父容器宽度420vp,三个子元素原始宽度为100vp,左右padding为20vp,总和320vp,剩余空间100vp根据flexGrow值的占比分配给子元素,未设置flexGrow的子元素不参与“瓜分”。 569 570 第一个元素以及第二个元素以2:3分配剩下的100vp。第一个元素为100vp+100vp * 2/5=140vp,第二个元素为100vp+100vp * 3/5=160vp。 571 572- [flexShrink](../reference/apis-arkui/arkui-ts/ts-universal-attributes-flex-layout.md#flexshrink): 当父容器空间不足时,子元素的压缩比例。 573 574 575 ```ts 576 Flex({ direction: FlexDirection.Row }) { 577 Text('flexShrink(3)') 578 .flexShrink(3) 579 .width(200) 580 .height(100) 581 .backgroundColor(0xF5DEB3) 582 583 Text('no flexShrink') 584 .width(200) 585 .height(100) 586 .backgroundColor(0xD2B48C) 587 588 Text('flexShrink(2)') 589 .flexShrink(2) 590 .width(200) 591 .height(100) 592 .backgroundColor(0xF5DEB3) 593 }.width(400).height(120).padding(10).backgroundColor(0xAFEEEE) 594 ``` 595 596  597 598 599## 场景示例 600 601使用弹性布局,可以实现子元素沿水平方向排列,两端对齐,子元素间距平分,垂直方向上子元素居中的效果。 602 603 604```ts 605@Entry 606@Component 607struct FlexExample { 608 build() { 609 Column() { 610 Column({ space: 5 }) { 611 Flex({ direction: FlexDirection.Row, wrap: FlexWrap.NoWrap, justifyContent: FlexAlign.SpaceBetween, alignItems: ItemAlign.Center }) { 612 Text('1').width('30%').height(50).backgroundColor(0xF5DEB3) 613 Text('2').width('30%').height(50).backgroundColor(0xD2B48C) 614 Text('3').width('30%').height(50).backgroundColor(0xF5DEB3) 615 } 616 .height(70) 617 .width('90%') 618 .backgroundColor(0xAFEEEE) 619 }.width('100%').margin({ top: 5 }) 620 }.width('100%') 621 } 622} 623``` 624 625 626 627## 相关实例 628 629针对Flex开发,有以下相关实例可供参考: 630 631- [弹性布局(ArkTS)(API9)](https://gitee.com/openharmony/codelabs/tree/master/ETSUI/FlexLayout)