萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

ExtJS NumberField 後方附加單位文字 (unitText) 實作方案

前言

ExtJS NumberField 預設不支援在輸入框右側顯示固定單位(如「元」、「%」、「kg」)。本文提供透過 Override Ext.form.TextField 實現 unitText 配置的完整方案,含 CSS 樣式與使用範例。

核心 Override 代碼 (UnitText.js)

// 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]);
            };
        }
    }
});

CSS 樣式

<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>

原理說明

  1. Override onRender 在輸入框渲染後,於同一容器 (ct) 追加單位 div。
  2. 將單位元素加上 x-form-unit 樣式,利用 inline-block 使其緊貼輸入框右側。
  3. 根據單位文字長度動態縮減 this.width,避免撐破容器。
  4. 覆寫 alignErrorIcon 讓驗證錯誤圖示對齊單位元素而非輸入框。

注意事項與改良

  • ExtJS 4/5/6/7 類體系不同,若用 Ext.define 定義類別,建議改用 Ext.override 或 Ext.apply 至原型。
  • 寬度計算為估算值,建議改用 Ext.util.TextMetrics 精確測量文字寬度。
  • 若需支援 **右對齊單位**(如金額右對齊),需調整容器佈局為 `hbox` 或使用 `labelAlign: 'right'`。
  • 現代 ExtJS (6.5+) 建議改用 **Plugin** 方式:plugins: {ptype: 'fieldunit', unitText: ' 元'},更符合架構。

Plugin 寫法範例 (ExtJS 6.5+)

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: ' 元'}
}
copyright © 萬盛學電腦網 all rights reserved