tmagic-editor/docs/api/editor/componentListServiceMethods.md
roymondchen 873a51fc87 docs: 升级 VitePress 至 v2 alpha,类型引用改为源码片段同步
- 升级 vitepress 到 ^2.0.0-alpha.17
- vite.optimizeDeps.rolldownOptions.transform.define 迁移至 vite.define 以适配 v2 API
- 同步升级 vitest/rolldown/vue/vite 等周边依赖
- 文档中类型链接统一改为 <<< 片段引用源码 region,避免 commit hash 链接失效
- packages/{core,editor,form-schema,schema,stage} 相关类型加 // #region 锚点
- 移除已废弃的 docs/guide/advanced/tmagic-ui.md 及侧栏入口

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-18 11:47:03 +08:00

1.7 KiB
Raw Blame History

componentListService方法

setList

  • 参数:

    • {ComponentGroup[]} componentGroupList 组件列表配置

    ::: details 查看 ComponentGroup 及关联类型定义 <<< @/../packages/editor/src/type.ts#ComponentGroup{ts}

    <<< @/../packages/editor/src/type.ts#ComponentItem{ts} :::

  • 返回:

    • {void}
  • 详情:

    设置左侧面板的组件列表配置

    :::tip 该方法通常由编辑器内部调用,开发者可以通过 m-editor 的 componentGroupList prop 来配置组件列表 :::

  • 示例:

import { componentListService } from '@tmagic/editor';

componentListService.setList([
  {
    title: '基础组件',
    items: [
      {
        icon: 'text-icon',
        text: '文本',
        type: 'text',
      },
      {
        icon: 'button-icon',
        text: '按钮',
        type: 'button',
      },
    ],
  },
]);

getList

  • 参数:

  • 返回:

    • {ComponentGroup[]} 组件列表配置
  • 详情:

    获取当前的组件列表配置

  • 示例:

import { componentListService } from '@tmagic/editor';

const list = componentListService.getList();
console.log(list);

resetState

  • 参数:

  • 返回:

    • {void}
  • 详情:

    重置组件列表状态,清空所有配置

  • 示例:

import { componentListService } from '@tmagic/editor';

componentListService.resetState();

destroy

  • 参数:

  • 返回:

    • {void}
  • 详情:

    销毁 componentListService清空状态并移除所有事件监听和插件

  • 示例:

import { componentListService } from '@tmagic/editor';

componentListService.destroy();