Skip to content

工具函数

createNumberProp()

createNumberProp 用于创建整数或浮点数类型的属性。可以指定属性的初始值、标签、字段名等参数。

参数

  • component: 组件名称,通常为 PropNumber
  • field: 字段名称,属性的唯一标识符。
  • label: 标签,显示给用户的属性名称。
  • defaultValue: 默认值,属性的初始值。
  • tips: 提示信息,通常用于展示给用户的辅助说明。
  • visible: 布尔值,控制属性是否可见。

使用示例

js
createNumberProp({
    component: 'PropNumber',
    field: 'field1',
    label: 'Width',
    defaultValue: 0,
    tips: '请输入宽度值',
    visible: true
});

createObjectProp()

createObjectProp 用于创建对象类型的属性。可以通过该函数定义一个包含多个键值对的对象属性。

参数

  • component: 组件名称,通常为 PropObject
  • field: 字段名称,属性的唯一标识符。
  • label: 标签,显示给用户的属性名称。
  • defaultValue: 默认值,属性的初始值(通常为 {})。
  • tips: 提示信息,通常用于展示给用户的辅助说明。
  • visible: 布尔值,控制属性是否可见。

使用示例

js
createObjectProp({
    component: 'PropObject',
    field: 'field2',
    label: 'Dimensions',
    defaultValue: {},
    tips: '请输入对象的属性值',
    visible: true
});

createStringProp()

createStringProp 用于创建字符串类型的属性。此函数通常用于创建文本字段、标题等。

参数

  • component: 组件名称,通常为 PropString
  • field: 字段名称,属性的唯一标识符。
  • label: 标签,显示给用户的属性名称。
  • defaultValue: 默认值,属性的初始值(通常为空字符串 '')。
  • tips: 提示信息,通常用于展示给用户的辅助说明。
  • visible: 布尔值,控制属性是否可见。

使用示例

js
createStringProp({
    component: 'PropString',
    field: 'field3',
    label: 'Height',
    defaultValue: '',
    tips: '请输入高度值',
    visible: true
});

createGroupProp()

createGroupProp 用于创建一个属性组,将多个基础属性包装在一起。通常用于将相关属性进行分组,便于管理和展示。

参数

  • label: 属性组的标签。
  • props: 一个属性数组,包含多个基础属性。

使用示例

js
createGroupProp({
    label: 'Group Title',
    props: [
        createNumberProp({
            field: 'field1',
            label: 'Width',
            defaultValue: 0
        }),
        createStringProp({
            field: 'field2',
            label: 'Height',
            defaultValue: ''
        })
    ]
});

createBooleanProp()

createBooleanProp 用于创建布尔类型的属性,常用于开关、复选框等。

参数

  • component: 组件名称,通常为 PropBoolean
  • field: 字段名称,属性的唯一标识符。
  • label: 标签,显示给用户的属性名称。
  • defaultValue: 默认值,属性的初始值(布尔类型)。
  • tips: 提示信息,通常用于展示给用户的辅助说明。
  • visible: 布尔值,控制属性是否可见。

使用示例

js
createBooleanProp({
    component: 'PropBoolean',
    field: 'field4',
    label: 'Enable',
    defaultValue: true,
    tips: '是否启用此功能',
    visible: true
});

createArrayProp()

createArrayProp 用于创建数组类型的属性,通常用于选择多个选项或提供多个值的输入。

参数

  • component: 组件名称,通常为 PropArray
  • field: 字段名称,属性的唯一标识符。
  • label: 标签,显示给用户的属性名称。
  • defaultValue: 默认值,属性的初始值(通常为空数组 [])。
  • options: 可选项数组,通常用于下拉选择框或多选框等。
  • tips: 提示信息,通常用于展示给用户的辅助说明。
  • visible: 布尔值,控制属性是否可见。

使用示例

js
createArrayProp({
    component: 'PropArray',
    field: 'field5',
    label: 'Options',
    defaultValue: [],
    options: ['Option1', 'Option2', 'Option3'],
    tips: '选择可用的选项',
    visible: true
});

createSlot()

createSlot 用于创建插槽方法,可以为组件提供灵活的插槽配置,支持白名单和黑名单的过滤,控制哪些内容可以插入到该插槽。

参数

  • title: 插槽的标题或标识。
  • allow: 白名单,指定允许的插槽内容。
  • deny: 黑名单,指定禁止的插槽内容。
  • props: 插槽的扩展参数,允许自定义插槽的额外属性。

使用示例

js
createSlot({
    title: 'CustomSlot',
    allow: ['ComponentA', 'ComponentB'], // 白名单,允许插入的组件
    deny: ['ComponentC'], // 黑名单,禁止插入的组件
    props: [] // 插槽扩展参数
});