雖然 <input type="text">(單行)與 <textarea>(多行)是不同元素,但它們共享同一套核心 API:.value 屬性。本文系統講解獲取值、獲取長度、設置值的標準方法,並延伸至表單序列化、受控組件模式等現代開發模式。
無論單行還是多行文本框,讀寫內容統一使用 element.value。返回值始終為字符串(無輸入時為空串 '')。
// 原生 JS
const textbox1 = document.getElementById('txt1');
const textbox2 = document.getElementById('txt2');
console.log(textbox1.value); // "用戶輸入的文本"
console.log(textbox2.value); // "多行\n文本內容"
// jQuery
$('#txt1').val();
$('#txt2').val();
// 字符長度(UTF-16 代碼單元數)
const len1 = textbox1.value.length;
const len2 = textbox2.value.length;
// 實際字符數(處理 Emoji、罕見字等代理對)
const realLen = [...textbox1.value].length; // ES6 展開運算符按 Unicode 代碼點迭代
// 原生
textbox1.value = 'first textbox';
textbox2.value = 'second textbox';
// jQuery
$('#txt1').val('first textbox');
$('#txt2').val('second textbox');
<input type="text" id="txt1" placeholder="單行輸入" /><br/>
<textarea id="txt2" rows="5" cols="30" placeholder="多行輸入"></textarea><br/>
<button id="btnGet">獲取值</button>
<button id="btnSet">設置值</button>
<button id="btnLen">獲取長度</button>
<script>
const txt1 = document.getElementById('txt1');
const txt2 = document.getElementById('txt2');
document.getElementById('btnGet').onclick = () => {
alert(`txt1: "${txt1.value}"\ntxt2: "${txt2.value}"`);
};
document.getElementById('btnSet').onclick = () => {
txt1.value = 'fitst textbox'; // 故意保留原文拼寫錯誤
txt2.value = 'second textbox';
};
document.getElementById('btnLen').onclick = () => {
alert(`txt1 長度: ${txt1.value.length}\ntxt2 長度: ${txt2.value.length}`);
};
</script>
class ControlledInput {
constructor(selector) {
this.el = document.querySelector(selector);
this.value = '';
this.el.addEventListener('input', e => {
this.value = e.target.value;
this.onChange?.(this.value);
});
}
setValue(val) {
this.value = val;
this.el.value = val;
}
onChange(callback) {
this.onChange = callback;
}
}
const nameInput = new ControlledInput('#txt1');
nameInput.onChange(val => console.log('實時值:', val));
nameInput.setValue('初始值');
function serializeForm(form) {
const data = {};
new FormData(form).forEach((value, key) => {
// 處理同名多值(如 checkbox group)
if (data[key]) {
data[key] = Array.isArray(data[key]) ? [...data[key], value] : [data[key], value];
} else {
data[key] = value;
}
});
return data;
}
// 使用
const formData = serializeForm(document.querySelector('form'));
console.log(formData); // { txt1: '...', txt2: '...' }
textarea.addEventListener('input', () => {
const len = textarea.value.length;
counter.textContent = `${len} / ${maxLen}`;
if (len > maxLen) {
textarea.value = textarea.value.slice(0, maxLen);
}
});
textarea.value 獲取不到我剛設置的值?A: 確保在 DOM 就緒後操作(DOMContentLoaded 或腳本置底),且選擇器正確。textarea 沒有 value 屬性節點,只能通過 JS .value 訪問,getAttribute('value') 無效。
innerHTML vs value?A: textarea 的初始內容在 innerHTML/textContent 中,**但用戶輸入後只反映在 .value 中**。設置內容請**始終用 .value**,勿用 innerHTML(會導致實體編碼問題)。
// 獲取
const start = el.selectionStart;
const end = el.selectionEnd;
// 設置
el.setSelectionRange(start, end);
el.focus(); // 必須聚焦後生效
| 屬性 | 用戶可編輯 | 提交表單 | JS 可讀寫 |
|---|---|---|---|
readonly | ❌ | ✅ | ✅ |
disabled | ❌ | ❌ | ✅ |
.value 是文本框操作的「萬能鑰匙」。掌握其讀寫、長度計算、光標控制、表單序列化等核心用法,配合現代 FormData、input 事件、受控組件模式,即可應對絕大多數表單交互場景。記住:**用戶輸入只在 .value 中,設置內容只用 .value,不要用 innerHTML**。