amis/docs/zh-CN/components/form/diff-editor.md
2022-05-31 15:05:54 +08:00

4.0 KiB
Executable File

title description type group menuName icon order
DiffEditor 对比编辑器 0 null DiffEditor 对比编辑器 17

基本使用

{
    "type": "form",
    "api": "/api/mock2/form/saveForm",
    "body": [
        {
            "type": "diff-editor",
            "name": "diff",
            "label": "Diff-Editor",
            "diffValue": "hello world",
            "value": "hello"
        }
    ]
}

禁用编辑器

左侧编辑器始终不可编辑,右侧编辑器可以通过设置disableddisabledOn,控制是否禁用

{
    "type": "form",
    "api": "/api/mock2/form/saveForm",
    "body": [
        {
            "type": "diff-editor",
            "name": "diff",
            "label": "Diff-Editor",
            "diffValue": "hello world",
            "value": "hello",
            "disabledOn": "this.isDisabled"
        },
        {
            "type": "switch",
            "name": "isDisabled",
            "label": "是否禁用"
        }
    ]
}

diff 数据域中的两个变量

如下例,左侧编辑器中的值,通过"diffValue": "${value1}"获取,右侧编辑器的值,通过设置"name": "value2",自动映射数据域中value2的值

{
    "type": "form",
    "api": "/api/mock2/form/saveForm",
    "data": {
        "value1": "hello world",
        "value2": "hello wrold"
    },
    "body": [
        {
            "type": "diff-editor",
            "name": "value2",
            "label": "Diff-Editor",
            "diffValue": "${value1}"
        }
    ]
}

属性表

除了支持 普通表单项属性表 中的配置以外,还支持下面一些配置

属性名 类型 默认值 说明
language string javascript 编辑器高亮的语言,可选 支持的语言
diffValue Tpl 左侧值

事件表

当前组件会对外派发以下事件,可以通过onEvent来监听这些事件,并通过actions来配置执行的动作,在actions中可以通过event.data.xxx事件参数变量来获取事件产生的数据,详细请查看事件动作

事件名称 事件参数 说明
focus event.data.value: string 当前代码 右侧输入框获取焦点时触发
blur event.data.value: string 当前代码 右侧输入框失去焦点时触发

动作表

当前组件对外暴露以下特性动作,其他组件可以通过指定actionType: 动作名称componentId: 该组件id来触发这些动作,动作配置可以通过args: {动作配置项名称: xxx}来配置具体的参数,详细请查看事件动作

动作名称 动作配置 说明
clear - 清空
reset - 将值重置为resetValue,若没有配置resetValue,则清空
focus - 获取焦点,焦点落在右侧编辑面板
setValue value: string 更新的右侧编辑面板中的值 更新数据