[Reference] NumberField

2011-11-21 15:51:57by ???

NumberField

NumberField是一个提供数字输入编辑的组件,继承自TextField组件,拥有TextField标签的属性以及TextField对象的方法和事件。

上图是NumberField组件在页面中的呈现,输入框前的文字信息是通过NumberField标签属性prompt来定义的。

NumberField定义

在screen文件中我们通过<a:numberField>标签来定义一个NumberField对象。

<a:numberField bindTarget="fnd_tax_type_codes_query_ds" name="tax_type_rate"
	allowDecimals="true" allowFormat="true" decimalPrecision="1">
    <a:events>
        <a:event name="enterdown" handler="queryTaxTypeCodes"/>
    </a:events>
</a:numberField>

numberField标签可以设置一个id属性,id是组件的唯一标识,我们可以在页面脚本中用$('id')的方法获得该id对应的组件对象,进而可以调用相应的函数方法。

numberField标签的bindTarget属性可指定一个dataset对象的id,name属性可指定该dataset其中一个field的名字。这两个属性必须联合使用,其功能是将NumberField对象绑定到dataset中的一个field上,进而我们只要对dataset进行操作就能即时反映在NumberField上,另外NumberField上的文字编辑也会立刻修改dataset中的数据。

events标签定义了需要响应的事件函数,例如enterdown事件,当键盘键入回车键时,NumberField会触发enterdown事件,这样我们可以通过配置一个客户端函数queryTaxTypeCodes来响应。

function queryTaxTypeCodes(){
    $('fnd_tax_type_codes_result_ds').query();
}
NumberField标签属性

表 1. 

属性名 用途 默认值 是否必填
allowDecimals 是否允许NumberField的值为小数。

取值 true | false

true
allowNegative 是否允许NumberField的值为负数。

取值 true | false

true
allowFormat 是否允许NumberField的值按照千分位显示。

取值 true | false

true
decimalPrecision 组件的小数位精度,必须在allowDecimals为true的情况下才能使用。 2
其他 参阅TextField标签属性。

NumberField对象事件

请参阅TextField的对象事件。

Attachments
  1. numberField.rar

Comments

0 Responses to the article

暂时没有评论。

发表评论