柵格容器組件

子組件

可以包含GridCol子組件。

接口

GridRow(option?: {columns?: number | GridRowColumnOption, gutter?: Length | GutterOption, breakpoints?: BreakPoints, direction?: GridRowDirection})

從API version 9開(kāi)始，該接口支持在ArkTS卡片中使用。

參數(shù)：

GutterOption

從API version 9開(kāi)始，該接口支持在ArkTS卡片中使用。

GridRowColumnOption

柵格在不同寬度設(shè)備類型下，柵格列數(shù)。

從API version 9開(kāi)始，該接口支持在ArkTS卡片中使用。

GridRowSizeOption

柵格在不同寬度設(shè)備類型下，gutter的大小。

從API version 9開(kāi)始，該接口支持在ArkTS卡片中使用。

BreakPoints

從API version 9開(kāi)始，該接口支持在ArkTS卡片中使用。

  // 啟用xs、sm、md共3個(gè)斷點(diǎn)
  breakpoints: {value: ["100vp", "200vp"]}
  // 啟用xs、sm、md、lg共4個(gè)斷點(diǎn)，斷點(diǎn)范圍值必須單調(diào)遞增
  breakpoints: {value: ["320vp", "520vp", "840vp"]}
  // 啟用xs、sm、md、lg、xl共5個(gè)斷點(diǎn)，斷點(diǎn)范圍數(shù)量不可超過(guò)斷點(diǎn)可取值數(shù)量-1
  breakpoints: {value: ["320vp", "520vp", "840vp", "1080vp"]}

BreakpointsReference枚舉類型

從API version 9開(kāi)始，該接口支持在ArkTS卡片中使用。

GridRowDirection枚舉類型

從API version 9開(kāi)始，該接口支持在ArkTS卡片中使用。

柵格最多支持xs、sm、md、lg、xl、xxl六個(gè)斷點(diǎn)，且名稱不可修改。假設(shè)傳入的數(shù)組是[n0, n1, n2, n3, n4]，各個(gè)斷點(diǎn)取值如下：

說(shuō)明：

• 柵格元素僅支持Row/RowReverse排列，不支持column/ColumnReverse方向排列。
• 柵格子組件僅能通過(guò)span、offset計(jì)算子組件位置與大小。多個(gè)子組件span超過(guò)規(guī)定列數(shù)時(shí)自動(dòng)換行。
• 單個(gè)元素span大小超過(guò)最大列數(shù)時(shí)后臺(tái)默認(rèn)span為最大column數(shù)。
• 新一行的Offset加上子組件的span超過(guò)總列數(shù)時(shí)，將下一個(gè)子組件在新的一行放置。
• 例：Item1: GridCol({ span: 6})， Item2: GridCol({ span: 8, offset:11})

屬性

支持通用屬性。

事件

onBreakpointChange

onBreakpointChange(callback: (breakpoints: string) => void)

從API version 9開(kāi)始，該接口支持在ArkTS卡片中使用。

參數(shù)：

示例

// xxx.ets
@Entry
@Component
struct GridRowExample {
  @State bgColors: Color[] = [Color.Red, Color.Orange, Color.Yellow, Color.Green, Color.Pink, Color.Grey, Color.Blue, Color.Brown]
  @State currentBp: string = 'unknown'

  build() {
    Column() {
      GridRow({
        columns: 5,
        gutter: { x: 5, y: 10 },
        breakpoints: { value: ["400vp", "600vp", "800vp"],
          reference: BreakpointsReference.WindowSize },
        direction: GridRowDirection.Row
      }) {
        ForEach(this.bgColors, (color) => {
          GridCol({ span: { xs: 1, sm: 2, md: 3, lg: 4 } }) {
            Row().width("100%").height("20vp")
          }.borderColor(color).borderWidth(2)
        })
      }.width("100%").height("100%")
      .onBreakpointChange((breakpoint) => {
        this.currentBp = breakpoint
      })
    }.width('80%').margin({ left: 10, top: 5, bottom: 5 }).height(200)
    .border({ color: '#880606', width: 2 })
  }
}