自定义组件配置说明（components）

组件基本信息配置

组件基本信息是识别和加载自定义组件的基础，核心配置项如下所示：

多语言配置

用于定义组件的多语言显示名称，确保不同语言环境下的友好展示。

组件导入配置

定义UI引擎如何导入自定义组件，是组件加载的核心配置。

组件元数据配置

“schema”字段定义组件在UI引擎属性面板中的可配置项，即使无相关配置，也需传入空值（空数组/空对象）。

属性配置（schema.properties）

“properties”是属性分组数组，每个元素对应“属性”设置面板中的一个可折叠分组（如“基础属性”）。核心配置如下：

每个对象对应属性面板中的一个可配置项，核心配置如下：

“LabelConfig”定义属性在属性面板中显示的文字，核心配置如下：

“WidgetConfig”定义属性配置器的具体配置，核心配置如下：

事件配置（schema.events）

“events”为对象类型，每个属性对应一个事件名，需遵循以下规则：

• 事件名必须以“on”开头。
• 中横线连接的事件名需转换为驼峰命名。例如，组件内部发送了一个名为“custom-event”的事件，则在协议中要使用“onCustomEvent”。
• 避免使用下划线拼接多个单词组成的事件名称
• 触发双向绑定需要使用固定的写法为“onUpdate:modelValue”。

事件配置对象结构：

interface EventConfig {
    [onEventName: string]: Object<NameConfig>; // 值为事件多语言名称配置
}

插槽配置（schema.slots）

“slots”为对象类型，每个属性对应一个插槽名。结构定义如下：

interface SlotConfig {
    [slotName: string]: {
        "componentName": "slot" | "Template"; // 固定值
        "label": {
            "zh_CN": string; // 插槽中文名称
        }
    }
}

元信息配置（schema.configure）

“configure”是一个可选配置项，用于定义组件的特殊行为、嵌套规则、快捷键等元信息，无特殊需求时需传入空对象“{}”（该属性不可省略）。如需配置，可参考以下示例和说明：

{
  "configure": {
    "isContainer": true,          // 是否为容器组件（如果为true且提供默认插槽，拖入画布时会自动添加插槽占位）
    "isModal": false,             // 是否为带全局遮罩层的组件（如弹窗）
    "isPopper": false,            // 是否为带弹出层的组件（如下拉框）
    "nestingRule": {              // 组件嵌套规则
      "childWhitelist": ["div"],  // 允许的直接子组件类型
      "parentWhitelist": [],      // 允许的父组件类型
      "descendantBlacklist": [],  // 禁止的深层子组件类型
      "ancestorWhitelist": []     // 允许的深层祖先组件类型
    },
    "rootSelector": ".app",       // 画布中选中组件时实际作用的目标节点（支持CSS选择器）
    "shortcuts": {                // 组件快捷键配置
      "properties": [             // 可通过快捷键快速设置的属性名
        "bordered",
        "striped"
      ]
    }
  }
}