文档管理中心
我的

您当前正在浏览HarmonyOS最新文档,覆盖已发布的所有API版本,可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。

指南与API参考API参考应用框架ArkUI(方舟UI框架)ArkTS组件系统预置UI组件库GridObjectSortComponent

GridObjectSortComponent

Phone12+PC/2in113+Tablet12+TV19+

网格对象排序组件,用于网格对象的编辑、拖动排序、新增和删除。

说明
  • 该组件从API version 11开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

  • 该组件仅可在Stage模型下使用。

  • 如果GridObjectSortComponent设置通用属性和通用事件,编译工具链会额外生成节点__Common__,并将通用属性或通用事件挂载在__Common__上,而不是直接应用到GridObjectSortComponent本身。这可能导致开发者设置的通用属性或通用事件不生效或不符合预期,因此,不建议GridObjectSortComponent设置通用属性和通用事件。

导入模块

收起
自动换行
深色代码主题
复制
  1. import { GridObjectSortComponent, GridObjectSortComponentItem, GridObjectSortComponentOptions, GridObjectSortComponentType , SymbolGlyphModifier } from '@kit.ArkUI';

子组件

无

GridObjectSortComponent

Phone12+PC/2in113+Tablet12+TV19+

GridObjectSortComponent({options: GridObjectSortComponentOptions, dataList: Array<GridObjectSortComponentItem>, onSave: (select: Array<GridObjectSortComponentItem>, unselect: Array<GridObjectSortComponentItem>) => void, onCancel: () => void })

网格对象排序组件。

装饰器类型:@Component

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

设备行为差异: 该接口在Wearable设备上使用时,应用程序运行异常,异常信息中提示接口未定义,在其他设备中可正常调用。

展开
名称 类型 必填 装饰器类型 说明
options GridObjectSortComponentOptions 是 @Prop 组件配置信息。
dataList Array<GridObjectSortComponentItem> 是 - 传入的数据,最大长度为50,数据长度超过50,只会取前50条数据。
onSave (select: Array<GridObjectSortComponentItem>, unselect: Array<GridObjectSortComponentItem>) => void 是 - 保存编辑排序的回调函数,select为编辑后的选中数据,unselect为编辑后的未选中数据。
onCancel () => void 是 - 取消保存数据的回调。

GridObjectSortComponentOptions

Phone12+PC/2in113+Tablet12+TV19+

网格对象排序组件的组件配置信息。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

设备行为差异: 该接口在Wearable设备上使用时,应用程序运行异常,异常信息中提示接口未定义,在其他设备中可正常调用。

展开
名称 类型 只读 可选 说明
type GridObjectSortComponentType 否 是

组件展示形态:文字|图片+文字。设置为GridObjectSortComponentType.IMAGE_TEXT时,需为数据项配置url或symbolStyle。

默认值:GridObjectSortComponentType.TEXT

imageSize number | Resource 否 是

图片的尺寸,单位vp。仅在type为GridObjectSortComponentType.IMAGE_TEXT时生效。设置为数值0时,普通图片按默认尺寸显示,Symbol图标的字号为0vp。

取值范围:大于等于0。

默认值:56vp

normalTitle ResourceStr 否 是

未编辑状态下显示的标题。

默认值:频道。

showAreaTitle ResourceStr 否 是

展示区域标题,第一个子标题。

默认值:长按拖动排序。

addAreaTitle ResourceStr 否 是

添加区域标题,第二个子标题。

默认值:点击添加。

editTitle ResourceStr 否 是

编辑状态下头部标题显示。

默认值:编辑。

GridObjectSortComponentType

Phone12+PC/2in113+Tablet12+TV19+

配置网格对象排序组件节点的类型,配置名称 IMAGE_TEXT 为图片文字类型,TEXT 为文字类型。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

设备行为差异: 该接口在Wearable设备上使用时,应用程序运行异常,异常信息中提示接口未定义,在其他设备中可正常调用。

展开
名称 值 说明
IMAGE_TEXT "image_text" 图片文字类型。
TEXT "text" 文字类型。

GridObjectSortComponentItem

Phone12+PC/2in113+Tablet12+TV19+

网格对象排序组件的组件数据配置信息。

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

设备行为差异: 该接口在Wearable设备上使用时,应用程序运行异常,异常信息中提示接口未定义,在其他设备中可正常调用。

展开
名称 类型 只读 可选 说明
id number | string 否 否

数据id序号,不可重复。

默认值:空字符串。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

text ResourceStr 否 否

显示文本信息。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

selected boolean 否 否

是否被选中,已选中:true,未选中:false。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

url ResourceStr 否 是

GridObjectSortComponentType类型为IMAGE_TEXT时,用于配置图片地址;类型为TEXT时不生效。若同时配置symbolStyle,优先使用symbolStyle。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

symbolStyle18+ SymbolGlyphModifier 否 是

GridObjectSortComponentType类型为IMAGE_TEXT时,用于配置Symbol图标资源;类型为TEXT时不生效。配置优先级高于url。

元服务API: 从API version 18开始,该接口支持在元服务中使用。

order number 否 否

顺序序号,数值越小排序越靠前。

取值范围:大于等于0。

默认值:0

元服务API: 从API version 12开始,该接口支持在元服务中使用。

事件

不建议设置通用事件,设置后可能不生效或不符合预期。

示例

网格对象的编辑排序组件基础用法,涉及对组件配置信息初始化,数据初始化,保存、取消方法的使用。

收起
自动换行
深色代码主题
复制
  1. import { GridObjectSortComponent, GridObjectSortComponentItem, GridObjectSortComponentOptions, GridObjectSortComponentType, SymbolGlyphModifier } from '@kit.ArkUI';
  2. @Entry
  3. @Component
  4. struct Index {
  5. // 组件数据初始化。
  6. @State dataList: GridObjectSortComponentItem[] = [
  7. {
  8. id: 0,
  9. url: $r('sys.media.ohos_save_button_filled'),
  10. text: '下载',
  11. selected: true,
  12. order: 3
  13. },
  14. {
  15. id: 1,
  16. url: $r('sys.media.ohos_ic_public_web'),
  17. text: '网络',
  18. selected: true,
  19. order: 9
  20. },
  21. {
  22. id: 2,
  23. url: $r('sys.media.ohos_ic_public_video'),
  24. text: '视频',
  25. selected: false,
  26. order: 1
  27. },
  28. {
  29. id: 3,
  30. symbolStyle: new SymbolGlyphModifier($r('sys.symbol.record_circle')),
  31. text: '录制',
  32. selected: false,
  33. order: 4
  34. }
  35. ]
  36. // 组件配置信息初始化。
  37. @State option: GridObjectSortComponentOptions = {
  38. type: GridObjectSortComponentType.IMAGE_TEXT,
  39. imageSize: 45,
  40. normalTitle: '菜单',
  41. editTitle: '编辑',
  42. showAreaTitle: '长按拖动排序',
  43. addAreaTitle: '点击添加'
  44. }
  45. build() {
  46. Column() {
  47. GridObjectSortComponent({
  48. options: this.option,
  49. dataList: this.dataList,
  50. // 保存编辑排序的回调函数,接收编辑后的选中数据和未选中数据。
  51. onSave: (
  52. select: Array<GridObjectSortComponentItem>,
  53. unselect: Array<GridObjectSortComponentItem>
  54. ) => {
  55. // 实现保存数据的逻辑
  56. },
  57. // 取消保存数据的回调。
  58. onCancel: () =>{
  59. // 实现取消编辑的逻辑
  60. }
  61. })
  62. }
  63. }
  64. }