萬盛學電腦網

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

JavaScript 獲取與設置文本框值完全指南:input、textarea 統一操作

雖然 <input type="text">(單行)與 <textarea>(多行)是不同元素,但它們共享同一套核心 API:.value 屬性。本文系統講解獲取值、獲取長度、設置值的標準方法,並延伸至表單序列化、受控組件模式等現代開發模式。

核心 API:.value 屬性

無論單行還是多行文本框,讀寫內容統一使用 element.value。返回值始終為字符串(無輸入時為空串 '')。

1. 獲取值

// 原生 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();

2. 獲取長度

// 字符長度(UTF-16 代碼單元數)
const len1 = textbox1.value.length;
const len2 = textbox2.value.length;

// 實際字符數(處理 Emoji、罕見字等代理對)
const realLen = [...textbox1.value].length; // ES6 展開運算符按 Unicode 代碼點迭代

3. 設置值

// 原生
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>

進階應用模式

1. 受控組件模式(React/Vue 風格)

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('初始值');

2. 表單序列化獲取所有文本框值

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: '...' }

3. 實時字符統計與限制(結合上篇)

textarea.addEventListener('input', () => {
  const len = textarea.value.length;
  counter.textContent = `${len} / ${maxLen}`;
  if (len > maxLen) {
    textarea.value = textarea.value.slice(0, maxLen);
  }
});

常見問題與避坑指南

Q: 為什麼 textarea.value 獲取不到我剛設置的值?

A: 確保在 DOM 就緒後操作(DOMContentLoaded 或腳本置底),且選擇器正確。textarea 沒有 value 屬性節點,只能通過 JS .value 訪問,getAttribute('value') 無效。

Q: innerHTML vs value?

A: textarea 的初始內容在 innerHTML/textContent 中,**但用戶輸入後只反映在 .value 中**。設置內容請**始終用 .value**,勿用 innerHTML(會導致實體編碼問題)。

Q: 如何獲取/設置光標位置?

// 獲取
const start = el.selectionStart;
const end = el.selectionEnd;

// 設置
el.setSelectionRange(start, end);
el.focus(); // 必須聚焦後生效

Q: 只讀與禁用的區別?

屬性用戶可編輯提交表單JS 可讀寫
readonly❌✅✅
disabled❌❌✅

總結

.value 是文本框操作的「萬能鑰匙」。掌握其讀寫、長度計算、光標控制、表單序列化等核心用法,配合現代 FormData、input 事件、受控組件模式,即可應對絕大多數表單交互場景。記住:**用戶輸入只在 .value 中,設置內容只用 .value,不要用 innerHTML**。

copyright © 萬盛學電腦網 all rights reserved