ExtJS NumberField 預設不支援在輸入框右側顯示固定單位(如「元」、「%」、「kg」)。本文提供透過 Override Ext.form.TextField 實現 unitText 配置的完整方案,含 CSS 樣式與使用範例。
// UnitText.js
Ext.override(Ext.form.TextField, {
unitText: '',
onRender: function(ct, position) {
Ext.form.TextField.superclass.onRender.call(this, ct, position);
if (this.unitText) {
// 建立單位元素
this.unitEl = ct.createChild({
tag: 'div',
html: this.unitText
});
this.unitEl.addClass('x-form-unit');
// 調整輸入框寬度,預留單位空間
// 簡易估算:中文字符約 12px,英文 6px
const unitWidth = this.unitText.replace(/[^\x00-\xff]/g, 'xx').length * 6 + 2;
this.width = (this.width || 100) - unitWidth;
// 重新定位錯誤圖示對齊單位元素
this.alignErrorIcon = function() {
this.errorIcon.alignTo(this.unitEl, 'tl-tr', [2, 0]);
};
}
}
});
<style>
.x-form-unit {
height: 22px;
line-height: 22px;
padding-left: 2px;
display: inline-block;
*display: inline; /* IE7 hack */
*zoom: 1; /* IE7 hack */
vertical-align: middle;
color: #666;
background: #f5f5f5;
border: 1px solid #ddd;
border-left: none;
border-radius: 0 3px 3px 0;
}
</style>
<!-- 頁面引入順序:ExtJS 核心 → UnitText.js -->
<script type="text/javascript" src="ext-all.js"></script>
<script type="text/javascript" src="UnitText.js"></script>
<script>
Ext.onReady(function() {
var jine = new Ext.form.NumberField({
id: 'je',
fieldLabel: '金額',
allowDecimals: true, // 允許小數
allowNegative: false, // 禁止負數
width: 120, // 含單位總寬
style: 'text-align:right',
unitText: ' 元' // 自訂單位
});
var rate = new Ext.form.NumberField({
fieldLabel: '利率',
width: 100,
unitText: ' %',
allowDecimals: true,
decimalPrecision: 4
});
new Ext.FormPanel({
renderTo: 'form-ct',
items: [jine, rate]
});
});
</script>
onRender 在輸入框渲染後,於同一容器 (ct) 追加單位 div。x-form-unit 樣式,利用 inline-block 使其緊貼輸入框右側。this.width,避免撐破容器。alignErrorIcon 讓驗證錯誤圖示對齊單位元素而非輸入框。Ext.define 定義類別,建議改用 Ext.override 或 Ext.apply 至原型。Ext.util.TextMetrics 精確測量文字寬度。plugins: {ptype: 'fieldunit', unitText: ' 元'},更符合架構。Ext.define('Ext.ux.FieldUnit', {
extend: 'Ext.plugin.Abstract',
alias: 'plugin.fieldunit',
unitText: '',
init: function(field) {
field.on('afterrender', function() {
if (!this.unitText) return;
const unitEl = Ext.get(field.el.dom.parentNode).createChild({
tag: 'span', cls: 'x-form-unit', html: this.unitText
});
field.inputEl.setStyle('padding-right', unitEl.getWidth() + 4 + 'px');
}, this, {single: true});
}
});
// 使用
{
xtype: 'numberfield',
fieldLabel: '金額',
plugins: {ptype: 'fieldunit', unitText: ' 元'}
}