1# GridCol 2 3栅格子组件，必须作为栅格容器组件([GridRow](ts-container-gridrow.md))的子组件使用。 4 5> **说明：** 6> 7> 该组件从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8 9## 子组件 10 11可以包含单个子组件。 12## 接口 13 14GridCol(option?:{span?: number | GridColColumnOption, offset?: number | GridColColumnOption, order?: number | GridColColumnOption}) 15 16从API version 9开始，该接口支持在ArkTS卡片中使用。 17 18**参数：** 19 20| 参数名 | 类型 | 必填 | 说明 | 21| ------ | ----------------------------------------------------- | ---- | ------------------------------------------------------------ | 22| span | number \| [GridColColumnOption](#gridcolcolumnoption) | 否 | 栅格子组件占用栅格容器组件的列数。span为0表示该元素不参与布局计算，即不会被渲染。<br/>默认值：1。 | 23| offset | number \| [GridColColumnOption](#gridcolcolumnoption) | 否 | 栅格子组件相对于原本位置偏移的列数。<br/>默认值：0。 | 24| order | number \| [GridColColumnOption](#gridcolcolumnoption) | 否 | 元素的序号，根据栅格子组件的序号，从小到大对栅格子组件做排序。<br/>默认值：0。<br/>**说明：**<br/>当子组件不设置order或者设置相同的order, 子组件按照代码顺序展示。<br/>当子组件部分设置order，部分不设置order时，未设置order的子组件依次排序靠前，设置了order的子组件按照数值从小到大排列。 | 25 26**说明：** 27 28`span`、`offset`、`order`属性按照`xs`、`sm`、`md`、`lg`、`xl`、`xxl`的顺序具有“继承性”，未设置值的断点将会从前一个断点取值。 29 30在不同宽度设备类型上的默认值为： 31 32|参数\断点 |xs|sm|md|lg|xl|xxl| 33|---|---|---|---|---|---|---| 34|span |2 |2 |3 |3 |4 |4 | 35|offset |2 |2 |3 |5 |5 |5 | 36|order |20 |20 |20 |3 |3 |3 | 37 38## 属性 39 40| 参数名 | 类型 | 必填 | 说明 | 41| ------ | ----------------------------- | ---- | ------------------------------------------------------------ | 42| span | number \| [GridColColumnOption](#gridcolcolumnoption) | 否 | 占用列数。span为0，意味着该元素不参与布局计算，即不会被渲染。<br/>默认值：1。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 | 43| gridColOffset | number \| [GridColColumnOption](#gridcolcolumnoption) | 否 | 相对于前一个栅格子组件偏移的列数。<br/>默认值：0。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 | 44| order | number \| [GridColColumnOption](#gridcolcolumnoption) | 否 | 元素的序号，根据栅格子组件的序号，从小到大对栅格子组件做排序。<br/>默认值：0。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 | 45 46## GridColColumnOption 47 48用于自定义指定在不同宽度设备类型上，栅格子组件占据的栅格数量单位。 49 50从API version 9开始，该接口支持在ArkTS卡片中使用。 51 52| 参数名 | 参数类型 | 必填 | 参数描述 | 53| ----- | ------ | ---- | ---------------------------------------- | 54| xs | number | 否 | 在栅格大小为xs的设备上，栅格容器组件的栅格列数。 | 55| sm | number | 否 | 在栅格大小为sm的设备上，栅格容器组件的栅格列数。 | 56| md | number | 否 | 在栅格大小为md的设备上，栅格容器组件的栅格列数。 | 57| lg | number | 否 | 在栅格大小为lg的设备上，栅格容器组件的栅格列数。 | 58| xl | number | 否 | 在栅格大小为xl的设备上，栅格容器组件的栅格列数。 | 59| xxl | number | 否 | 在栅格大小为xxl的设备上，栅格容器组件的栅格列数。 | 60 61## 示例 62请参考栅格容器示例代码([GridRow](ts-container-gridrow.md#示例))