描述

配置元素参数。

接口

bool SetElementConfig(identity : object, config: object)

参数

使用示例

thinkEditor.SetElementConfig(
{
    mode: E_IDENTITY_MATCH_MODE.MatchIdentity,
    object: 'element',
    sources: [{ sourceClass: 'xxx', sourceId: 'xxx' }]
},
{ 
    inputHandle: 
    { 
    inputMode: E_INPUT_MODE.SelectOption, optionClass: 'xxx', optionId: 'xxx' 
    } 
}
);

identity-参数

使用方式1：元素Id字符串

参数名 必填 类型 说明 备注
id 是 string 元素ID,为””时表示当前操作元素 
thinkEditor.SetElementConfig("id1", config);

使用方式2：identity通用身份对象

参数名 必填 类型 说明 备注
身份标识对象 是 object 目前支持 元素、表格 详见identity说明 
thinkEditor.SetElementConfig({id:"id1"}, config);
or
thinkEditor.SetElementConfig({ids:["id1"]}, config);

config-参数

参数名 必填 类型 说明 备注
id 否 string 元素id
name 否 string 元素name
beginBorder 否 string 起始边框
endBorder 否 string 结束边框
beforeTag 否 string 前导标签
afterTag 否 string 后置标签
hint 否 string 背景文本
tip 否 string 提示文本
width 否 float 最小宽度 单位 cm
alignHorizontalMode 否 enum 横向对齐模式配合最小宽度使用 E_ALIGN_HORIZONTAL_MODE
hideKeyWord 否 enum 加密模式 0：默认不加密 1：首尾显示 2：全加密 构造
hide 否 bool 隐藏元素 0：显示 1：隐藏
moveFocusHotKey 否 enum 移动焦点快捷键 E_MOVE_FOCUS_HOTKEY
focusMode 否 int 焦点模式 0：焦点在插入元素之后 1：焦点在插入元素之中****
printVisibility 否 int 打印可见性 0：始终显示 1：隐藏 不占位 2：隐藏 占位

源-source

参数名 必填 类型 说明 备注
Θ source 否 object
┗ sourceClass 否 string 选用的源种类
┗ sourceId 否 string 选用的源Id
┗ dynamicLoad 否 bool 是否动态加载：每次打开文档时都更新源内容 0：禁止 1：启用

配置

参数名 必填 类型 说明 备注
forbidDelete 否 bool 是否禁止删除元素对象 0：跟随父级 1：禁止删除
lockedContent 否 bool [过时，使用readOnly代替] 元素内容禁止人为删除、增加 0：跟随父级 1：锁定
readOnly 否 bool 是否只读。元素内容禁止人为删除、增加 0：跟随父级 1：锁定
lockedFormat bool 元素内容禁止人为修改字体样式 0：不锁定 1：锁定
forbidSpace 否 int 空格模式 0：可输入空格 1：禁止空格
forbidBackgroundEffects 否 bool 显示背景特效 0：显示 1：不显示
forbidFocusedEffects 否 bool 显示焦点特效 0：显示 1：不显示
forbidModifiedEffects 否 bool 隐藏修改标志 0：显示 1：隐藏
widthUnderline 否 bool 宽度下划线配合最小宽度使用 0：不显示 1：显示
allowJump 否 bool 自动跳转 0：禁止跳转 1：允许跳转
fitContent 否 bool 内容大小适应宽度配合最小宽度使用 0：不适应 1：自适应
displayBorder 否 bool 显示边框 0：不显示 1：显示
splitParagraphMode 否 enum 分段模式 E_SPLIT_PARAGRAPH_MODE

运算集-algorithm

设置算法的前提是已经设置/加载了算法，本接口算法设置的目的是为对象选用需要参与的算法。

参数名 必填 类型 说明 备注
Θ algorithm 否 object
┗ algoGroup 否 string 运算集名
┗ algoRole 否 enum 算法角色 0：输入 1：输出 E_ALGO_ROLE
┗ algoMode 否 enum 不直接提供;不可编辑; 由algoGroup从GetAlgorithmList()获取当前algoMode的值。可选项根据E_ALGO_MODE数据构造
┗ algoScope 否 enum 不直接提供;不可编辑; 由algoGroup从GetAlgorithmList()获取当前algoScope的值。可选项根据E_ALGO_SCOPE数据构造

输入模式-inputHandle

参数名 必填 类型 说明 备注
Θ inputHandle 否 object
┗ inputMode 是 enum 输入模式 E_INPUT_MODE

输入模式-输入文本

参数名 必填 类型 说明 备注
Θ inputHandle 否 object
┗ inputMode 是 enum 输入模式 =E_INPUT_MODE.InputText

输入模式-输入数值

参数名 必填 类型 说明 备注
Θ inputHandle 否 object
┗ inputMode 是 enum 输入模式 =E_INPUT_MODE.InputNumber

输入模式-选择选项

参数名 必填 类型 说明 备注
Θ inputHandle 否 object
┗ inputMode 是 enum 输入模式 =E_INPUT_MODE.SelectOption
┗ optionClass 否 string 当前选项类 可选项依据接口GetOptionList数据构造
┗ optionId 否 string 当前选项组 可选项依据接口GetOptionList()数据optionClass对应的optionId构造
┗ linkStr 否 string 当前拼接符 可选项依次为
“”
“,”
“、”
“#”
“*”
┗ optionShowMode 否 int 选项模式 0：普通模式 1：有无模式
┗ multipleChoice 否 bool 是否强制多选 0：不强制 1：强制多选
┗ groupExclusion 否 bool 是否分组互斥 0：不互斥 1：互斥
┗ sortByTime 否 bool 按时间排序 用于选项
┗ checked 否 json_arr Json数组 没有该项时，默认都不选中。示例选中两项：{“checked”: [“选项1”,”选项2”]}
┗ optionShowMode 否 int 选项显示模式 0：普通模式 1：有无模式
┗ denyStr 否 string 否认字串 有无模式时有效，不设置时为”有”
┗ sureStr 否 string 肯定字串 有无模式时有效，不设置时为”无”
┗ popSelectorWidth 否 float 弹出的选项过滤器宽度 默认值5.0cm。不可小于该值
┗ showFilter 否 bool 是否强制显示选项过滤器 0：不强制显示，当选项个数大于6个时自动显示。1：强制显示
┗ externalFilter 否 bool 是否使能外部过滤 0：默认，使用内部过滤机制 1：使用外部过滤机制，有应用决定可选项是哪些。

输入模式-选择时间

参数名 必填 类型 说明 备注
Θ inputHandle 否 object
┗ inputMode 是 enum 输入模式 =E_INPUT_MODE.SelectDateTime
┗ timeType 否 enum 当前时间类型 可选项依据枚举E_TIME_TYPE数据构造

质控相关-qualityControl

参数名 必填 类型 说明 备注
Θ qualityControl 否 object
┗ qcClass 否 enum 质控类型 E_QC_CLASS
┗ level 否 enum 质控信息等级 E_MESSAGE_LEVEL
┗ forbidEmpty 否 bool 是否禁止为空 0：不禁止 1：禁止
┗ notice 否 string 质控信息 当违反至少一项质控规则时，内置UI可使用该信息用于提示。
可以配合GetQualityControlReport()获得完整质控信息，自行按需提示。
┗ exclude 否 string 违禁关键字 当元素中包含对应的字词即为违反规则。
多个违禁关键字，使用分号”;”隔开，示例：”违禁1;违禁2;”

质控-string

参数名 必填 类型 说明 备注
Θ qualityControl 否 object
┗ qcClass 否 enum 质控类型 =E_QC_CLASS.String
┗ useByteLen 否 int 字符串长度是否按字节计数 0：按字符数计长 1：按字节数计长
┗ useMinLimit 否 bool 使用最小长度限制
┗ min 否 int 字符串最小长度 注意：没有本字段，表示没有相关限制
┗ useMaxLimit 否 bool 使用最大长度限制
┗ max 否 int 字符串最大长度 注意：没有本字段，表示没有相关限制

质控-number

参数名 必填 类型 说明 备注
Θ qualityControl 否 object
┗ qcClass 否 enum 质控类型 =E_QC_CLASS.Number
┗ useInteger 否 bool 是否为整形 0：否 1：是
┗ useMinLimit 否 bool 使用最小长度限制
┗ min 否 float / int 最小值 注意：没有本字段，表示没有相关限制
┗ useMaxLimit 否 bool 使用最大长度限制
┗ max 否 float / int 最大值 注意：没有本字段，表示没有相关限制
┗ useDecimalPlacesLimit 否 bool 使用小数位数限制
┗ decimalPlaces 否 int 最大小数位数 注意：没有本字段，表示没有相关限制

质控-dateTime

参数名 必填 类型 说明 备注
Θ qualityControl 否 object
┗ qcClass 否 enum 质控类型 =E_QC_CLASS.DateTime
┗ onlyTime 否 bool 只为时间 0：否 1：是
┗ min 否 long long 最小值 注意：没有本字段，表示没有相关限制
┗ max 否 long long 最大值 注意：没有本字段，表示没有相关限制

质控-regex

参数名 必填 类型 说明 备注
Θ qualityControl 否 object
┗ qcClass 否 enum 质控类型 =E_QC_CLASS.RegularExpression
┗ regex 否 string 正则表达式

事件相关-expressions

事件信息

添加1个事件，需要如下三个参数都同时存在。一次可添加1个事件。
相同事件不会重复添加。

参数名 必填 类型 说明 备注
Θ expressions 否 object
┗ event 否 int 触发条件 0：值更改时
1：单击
2：双击
┗ mode 否 int 执行模式 0：始终
1：一次
2：不执行
┗ action 否 string 事件表达式 详情请咨询技术人员或查看《设计手册》

设置事件

参数名 必填 类型 说明 备注
┗ opt 否 string 操作 “delete”/null: 清空 “add”:新增
┗ expression 否 json arr 事件表达式数组 
{
    "cmd": "delete",
    "list": [
        {
            "event": "0",
            "mode": "0",
            "action": "this.element.value=='吸烟' ? smoke.element.visible=true:smoke.element.visible=false"
        },
        {
            "event": "0",
            "mode": "0",
            "action": "this.element.value=='有食物或药物过敏史' ? allergen_desc.element.visible=true:allergen_desc.element.visible=false"
        }
    ]
}

元素默认字体-font

参数名 必填 类型 说明 备注
fontName 否 string 字体 “宋体”等
fontSize 否 float 字体大小 单位：cm
fontSizeItem 否 string 字号 示例： “小四”
color 否 ARGB 字体颜色 示例 红色：字符串“ffff0000” 或 数值 0xffff0000
backColor 否 ARGB 背景颜色 示例 红色：字符串“ffff0000” 或 数值 0xffff0000
bold 否 bool 加粗 0-不加粗 1-加粗
italic 否 bool 倾斜 0-不倾斜 1-倾斜
underline 否 bool 下划线 0-无 1-有
strikethrough 否 bool 删除线 0-无 1-有
ferrule 否 int 文字套圈 0-普通 1-圆形圈 2-矩形圈
script 否 int 上下标 0-正常 1-上标 2-下标

入参示例

{
    "object": "element",
    "id": "",
    "name": "",
    "empty": 0,
    "text": "咳嗽、咳痰、胸闷",
    "content": "咳嗽、咳痰、胸闷",
    "fragment": "咳嗽、咳痰、胸闷",
    "beginBorder": "",
    "endBorder": "",
    "beforeTag": "",
    "afterTag": "",
    "hint": "请选择",
    "tip": "",
    "width": "0.00",
    "alignHorizontalMode": 0,
    "hideKeyWord": 0,
    "forbidDelete": 0,
    "lockedContent": 0,
    "lockedFormat": 0,
    "forbidSpace": 0,
    "forbidBackgroundEffects": 0,
    "forbidFocusedEffects": 0,
    "widthUnderline": 0,
    "allowJump": 0,
    "fitContent": 0,
    "displayBorder": 0,
    "splitParagraphMode": 0,
    "source": {
        "sourceClass": "",
        "sourceId": "",
        "dynamicLoad": 0,
        "writeBack": 0
    },
    "algorithm": {

    },
    "inputHandle": {
        "inputMode": 2,
        "optionClass": "呼吸科",
        "optionId": "肺症状",
        "linkStr": "、",
        "optionShowMode": 0,
        "multipleChoice": 1,
        "groupExclusion": 1
    },
    "qualityControl": {
        "qcClass": 0,
        "level": 0,
        "forbidEmpty": 0,
        "notice": "",
        "exclude": "",
        "useByteLen": 0,
        "useMinLimit": 0,
        "min": 0,
        "useMaxLimit": 0,
        "max": 0
    },
    "expressions": {
        "cmd": "delete",
        "list": [

        ]
    }
}

返回值

类型 说明 备注
bool 是否有更新 0：设置失败 1：设置成功

示例代码

设置多个元素

var identity = {
    ids:["id1","id2"]

};
var config = {
    ...
};
thinkEditor.SetElementConfig(identity, config);
文档更新时间: 2025-10-21 14:15   作者：admin