功能
用于显示字段的label属性，一般在系统中作为字段标题使用。如下图红圈部分的信息:
图表 112
FieldLabel能自动的显示dataset中field的label属性。
在说明TextEditor作用的时候曾经使用过一段代码，通过自定义TextEditor的方式实现上图的使用效果，代码如下：
<table>
<tr><td>员工编码</td><td><d:TextEditor id="editorEmployeeId" /></td></tr>
<tr><td>姓名</td><td><d:TextEditor id="editorEmployeeName" /></td></tr>
<tr><td>性别</td><td><d:TextEditor id="editorSex" /></td></tr>
<tr><td>出生日期</td><td><d:TextEditor id="editorBirthday" /></td></tr>
</table> |
如果我们改为FieldLabel显示其中的字段标题信息，则我们可以将以上的数据标题中文信息从JSP页面中调整到Dataset的Field的label属性中。这样我们就可以利用FieldLabel对象放在JSP中：
<table>
<tr><td><d:FieldLabel id="fieldlabelEmployeeId" /></td><td><d:TextEditor id="editorEmployeeId" /></td></tr>
<tr><td><d:FieldLabel id="fieldlabelEmployeeName" /></td><td><d:TextEditor id="editorEmployeeName" /></td></tr>
<tr><td><d:FieldLabel id="fieldlabelSex" /></td><td><d:TextEditor id="editorSex" /></td></tr>
<tr><td><d:FieldLabel id="fieldlabelBirthday" /></td><td><d:TextEditor id="editorBirthday" /></td></tr>
</table> |
其中四个新增的FieldLabel对象我们可以直接在View中定义，并绑定到dataset的相关字段上（绑定的实现通过设置dataset以及field属性完成）。
不过在实际使用中我们较少的会直接使用该对象，通常情况下我们都是通过DataTable对象以及AutoForm对象自动生成。
主要属性说明
属性 |
说明 |
dataset |
字段标题绑定的dataset对象 |
field |
字段标题对应dataset的field对象 |
主要事件说明
onRefresh
public Boolean onRefresh(FieldLabel fieldLabel, any value)
当系统刷新此数据标签的内容时被触
说明:此方法返回值用于通知系统是否要终止后续默认的内部操作.返回true表示继续默认的操作.
Parameters
fieldLabel - FieldLabel - 触发事件的字段标题对象
value - any - 将要在此字段标题中显示的数据
Returns:
Boolean |
事件举例
1.利用onRefresh在数据刷新的时候同时自定以字段标题
label.innerText ="自定义标题";
return false; |
2.利用onRefresh事件，让网址字段可超链接
label.innerHTML = "<a href='http://www.bstek.com'>自定义标题(单击查看详情)</a>";
return false; |
