萬盛學電腦網

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

JavaScript 即時顯示輸入剩餘字數:輕量級字元計數器實作

需求場景

表單輸入框(<input>、<textarea>)常需限制最大字元數,並即時提示使用者「還可輸入 N 字」。本文提供最精簡的原生 JS 實作,無需任何庫依賴。

核心程式碼

HTML

<input name="title" type="text" size="50" maxlength="15"
       onkeyup="setShowLength(this, 15, 'cost_tpl_title_length')">
<span class="red" id="cost_tpl_title_length">還可以輸入15字數</span>

JavaScript

function setShowLength(obj, maxlength, spanId) {
    var remaining = maxlength - obj.value.length;
    if (remaining < 0) remaining = 0; // 防止負值(雖然 maxlength 已阻擋,但中文輸入法組合字期間可能超過)
    document.getElementById(spanId).innerHTML = "還可以輸入" + remaining + "字數";
}

進階增強版:支援中英混合、即時同步、游標保持

/**
 * 即時字元計數器(增強版)
 * @param {HTMLInputElement|HTMLTextAreaElement} inputEl - 輸入元素
 * @param {number} maxChars - 最大字元數(中文算 1,英文算 1;若中文算 2 請用 getByteLength)
 * @param {string} counterId - 顯示剩餘字數的 span id
 * @param {Object} [options] - 選項
 */
function createCharCounter(inputEl, maxChars, counterId, options) {
    var counterEl = document.getElementById(counterId);
    var opts = Object.assign({
        // 自訂長度計算:預設字元長度,可改為位元組長度
        lengthFn: function(str) { return str.length; },
        // 格式化輸出文字
        format: function(remain) { return "還可輸入 " + remain + " 字"; },
        // 超過限制時的類別
        overClass: 'over-limit'
    }, options);

    function update() {
        var len = opts.lengthFn(inputEl.value);
        var remain = Math.max(0, maxChars - len);
        counterEl.textContent = opts.format(remain);
        counterEl.classList.toggle(opts.overClass, remain === 0 && len > 0);
    }

    // 監聽輸入事件(包含中文輸入法組合完成、貼上、拖拽)
    inputEl.addEventListener('input', update);
    // 初始化
    update();
}

// 使用範例
var titleInput = document.querySelector('input[name="title"]');
createCharCounter(titleInput, 15, 'cost_tpl_title_length', {
    // 若需中文算 2 字元
    // lengthFn: function(s) { return s.replace(/[^\x00-\xff]/g, 'aa').length; }
});

關鍵點總結

  • 使用 input 事件而非 keyup,可涵蓋貼上、拖拽、輸入法組合字等所有輸入方式。
  • maxlength 原生屬性已阻擋超量輸入,JS 計數器僅作視覺提示。
  • 若需「中文 2 字元、英文 1 字元」計算,請自訂 lengthFn 使用 str.replace(/[^\x00-\xff]/g, 'aa').length。
  • 避免在 onkeyup 內操作 value 導致游標跳動;僅讀取長度更新提示區即可。

總結

幾行原生 JS 即可實現即時字元計數提示,核心在於 input 事件監聽與 maxlength 原生限制配合。專案中建議封裝為可複用函式 createCharCounter,支援自訂計算規則與顯示格式,滿足多國語系與不同業務需求。

copyright © 萬盛學電腦網 all rights reserved