表單輸入框(<input>、<textarea>)常需限制最大字元數,並即時提示使用者「還可輸入 N 字」。本文提供最精簡的原生 JS 實作,無需任何庫依賴。
<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>
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 計數器僅作視覺提示。lengthFn 使用 str.replace(/[^\x00-\xff]/g, 'aa').length。onkeyup 內操作 value 導致游標跳動;僅讀取長度更新提示區即可。幾行原生 JS 即可實現即時字元計數提示,核心在於 input 事件監聽與 maxlength 原生限制配合。專案中建議封裝為可複用函式 createCharCounter,支援自訂計算規則與顯示格式,滿足多國語系與不同業務需求。