就地编辑属性

1. 概念

设置当本元素的内容被就地编辑时,编辑界面的呈现细节,以及是否发起立即更新等细节。x-editable的data属性有效,但是会被指定属性覆盖,请索引官方文档。

2. 使用场景

修改元素的文本内容。

3. 绑定方法

右键点击目标元素→逻辑→数据绑定→绑定模式:就地编辑属性→高级编辑→增加绑定→确定。

4. 绑定内容

编辑方式:

1、就地编辑--可能对布局造成冲击,为了防止冲击,需要将要编辑的元素放在一个独立元素内,然后设置其宽高属性。

2、弹窗编辑--可能出现位置不对正的情况,此时需要设置偏移量。

2.1、位置:选择弹出窗口出现的位置

编辑类型:

1、文本:使用一个文本框来编辑。

1.1、允许清空:显示清空按钮。

1.2、占位提示:设置文本输入框的占位提示。

1.3、转义内容:将会对元素内容执行转义。

2、文本段:使用textarea来编辑,为了控制编辑器的外观,可以使用样式类。如下样式类会以100%宽度来编辑(请将其放在样式文件.css中)。.fullwidtheditable .editable-input textarea{width: 100% !important;} .fullwidtheditable .editable-input {width: 100% !important;} .fullwidtheditable .control-group {width: 100% !important;}.fullwidtheditable .editable-container {width: 100% !important;}

2.1、允许清空:显示清空按钮。

2.2、占位提示:设置文本输入框的占位提示。

2.3、转义内容:将会对元素内容执行转义。

3、所见即所得编辑器:所见即所得方式编辑文本段落。

4、日期:日期选择。

4.1、语言选择:选择日期输入所需要的语言,默认是中文

4.2、自动关闭:如果选择了true,则在选择了日期之后会自动关闭编辑界面。

4.3、默认世纪值:如果给出默认世纪20,则填入15/2/3被解析为2015年2月3日。

4.4、日期格式:使用日期(d, dd:固定双位,例如05),星期(D:简写,DD:全称),月份(m,mm:双位,例如02),月份名(M:简写,MM:全称),年份(yy:双字,如12;yyyy:四字,如2012)来组合格式。

5、时间:日期选择。

6、下拉日期:日期选择。

7、单项下拉选择:标准选择,HTML内建支持的select。

7.1、指定数据:

7.1.1、固定数据:拥有固定不可变选项的下拉选择。

固定数据:设置固定的数据来源,格式为[{text: "group1", children: [{value: 1, text: "text1"}, {value: 2, text: "text2"}]}],也可以是一个url,返回上述格式。

7.1.2、绑定变量:选项由绑定变量动态控制的下拉选择。

绑定变量名:使用绑定变量来指明数据。

选项值映射:绑定变量数组的元素对象里,哪个属性对应了选项值。留空使用默认的“value”。

选项名映射:绑定变量数组的元素对象里,哪个属性对应了选项名。留空使用默认的“text”。

8、多项下拉选择

8.1、指定数据:

8.1.1、固定数据:拥有固定不可变选项的下拉选择。

固定数据:设置固定的数据来源,格式为[{text: "group1", children: [{value: 1, text: "text1"}, {value: 2, text: "text2"}]}],也可以是一个url,返回上述格式。

8.1.2、绑定变量:选项由绑定变量动态控制的下拉选择。

绑定变量名:使用绑定变量来指明数据。

选项值映射:绑定变量数组的元素对象里,哪个属性对应了选项值。留空使用默认的“value”。

选项名映射:绑定变量数组的元素对象里,哪个属性对应了选项名。留空使用默认的“text”。

9、推特选择:推特风格的下拉选择(typeaheadjs)。

10、多项选择组:多项选择组(checklist)。

10.1、指定数据:

10.1.1、固定数据:拥有固定不可变选项的下拉选择。

固定数据:设置固定的数据来源,格式为[{text: "group1", children: [{value: 1, text: "text1"}, {value: 2, text: "text2"}]}],也可以是一个url,返回上述格式。

10.1.2、绑定变量:选项由绑定变量动态控制的下拉选择。

绑定变量名:使用绑定变量来指明数据。

选项值映射:绑定变量数组的元素对象里,哪个属性对应了选项值。留空使用默认的“value”。

选项名映射:绑定变量数组的元素对象里,哪个属性对应了选项名。留空使用默认的“text”。

动画速度:设置动画的速度,可以是2s,200ms或者false禁止动画。

编辑框标题:当出现编辑框时,编辑框的标题栏。

默认值文本:当内容为默认值时,元素上显示的文本,默认为“Empty”

默认值选择:选择哪种值会被当作默认值,从而显示Empty。可以是null|undefined|''|'XXX'

默认值样式类:当内容为默认值时,可以用醒目的样式来显示,这里指明其样式类名称,默认样式类“editable-empty”为红色显示。

实时绑定:实时绑定意味着,当编辑内容变动时,会自动更新绑定变量的值;如果选择false,只有在本次编辑被接受时,才会触发一次绑定变量同步。

显示值还是索引:部分编辑器(例如下拉菜单、多选)的值是数组下标,“自动”会显示对应下标的数据,选择“从不”可以关闭自动映射。

禁用:就地编辑的启用状态。填写true/false为固定启用或禁用,其它值被当作绑定变量,由变量值来控制是否禁用。

编辑状态绑定变量:除了通过点击触发编辑,还可以通过绑定变量来触发,将变量设置为true进入编辑状态。填写true/false为固定启用或禁用,其它值被当作绑定变量,由变量值来控制是否进入编辑状态。

显示编辑按钮:是否显示确定/取消的编辑按钮,以及显示在何处?如果选择不显示,则只有回车可以提交。


5. 绑定变量初始化

绑定变量初始化的作用是给变量赋值,即给元素提供发生事件时所需的数据, 点击查看详细操作