栅格子组件，必须作为栅格容器组件([GridRow])的子组件使用。

说明

该组件从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

可以包含单个子组件。

接口

GridCol(option?: GridColOptions)

卡片能力：  从API version 9开始，该接口支持在ArkTS卡片中使用。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
option	[GridColOptions]	否	栅格布局子组件参数。

GridColOptions对象说明

卡片能力：  从API version 9开始，该接口支持在ArkTS卡片中使用。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

名称	类型	必填	说明
span	number	[GridColColumnOption]	否
offset	number	[GridColColumnOption]	否
order	number	[GridColColumnOption]	否

span、offset、order属性按照xs、sm、md、lg、xl、xxl的顺序具有“继承性”，未设置值的断点将会从前一个断点取值。

属性

除支持[通用属性]外，还支持以下属性：

span

span(value: number | GridColColumnOption)

设置占用列数。span为0，意味着该元素不参与布局计算，即不会被渲染。

卡片能力：  从API version 9开始，该接口支持在ArkTS卡片中使用。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	number	[GridColColumnOption]	是

gridColOffset

gridColOffset(value: number | GridColColumnOption)

设置相对于前一个栅格子组件偏移的列数。

卡片能力：  从API version 9开始，该接口支持在ArkTS卡片中使用。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	number	[GridColColumnOption]	是

order

order(value: number | GridColColumnOption)

设置元素的序号，根据栅格子组件的序号，从小到大对栅格子组件做排序。

卡片能力：  从API version 9开始，该接口支持在ArkTS卡片中使用。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	number	[GridColColumnOption]	是

GridColColumnOption

用于自定义指定在不同宽度设备类型上，栅格子组件占据的栅格数量单位。

卡片能力：  从API version 9开始，该接口支持在ArkTS卡片中使用。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

名称	类型	必填	说明
xs	number	否	在栅格大小为xs的设备上，栅格容器组件的栅格列数。
sm	number	否	在栅格大小为sm的设备上，栅格容器组件的栅格列数。
md	number	否	在栅格大小为md的设备上，栅格容器组件的栅格列数。
lg	number	否	在栅格大小为lg的设备上，栅格容器组件的栅格列数。
xl	number	否	在栅格大小为xl的设备上，栅格容器组件的栅格列数。
xxl	number	否	在栅格大小为xxl的设备上，栅格容器组件的栅格列数。