浏览器与 Web API / 系统课时

读取文本框与文本域

读取文本框与文本域

文本框和文本域的核心状态都保存在 value 中,而 defaultValue 表示表单重置时使用的默认内容。配合 selectionStart 与 selectionEnd,还可以准确读取光标和选区,为编辑器、搜索框和快捷替换功能提供基础。

学习目标

  • 区分 value 与 defaultValue 的职责和变化时机。
  • 读取文本控件的光标位置、选区范围与选中文本。
  • 使用完整示例验证读取、选择和重置行为。

当前值与默认值

input.value 和 textarea.value 返回用户此刻看到的文本。用户输入、脚本赋值都会改变它,但不会自动改写 HTML 中的初始属性。读取或修改控件内容时,应优先操作 value。

defaultValue 表示控件的默认文本,也是 form.reset() 恢复时采用的值。对文本框,它通常对应 value 属性的默认状态;对文本域,它来自标签初始文本。脚本修改 defaultValue 后,后续重置也会使用新默认值。

只想清空当前输入时设置 value = "";需要改变以后重置得到的内容时,才修改 defaultValue。

读取光标与选区

selectionStart 是选区起点,selectionEnd 是选区终点,范围采用从零开始、左闭右开的字符索引。两者相等时表示没有选中文本,该位置就是光标位置。选中文本可以通过 value.slice(selectionStart, selectionEnd) 得到。

这些属性适用于 textarea,以及 text、search、url、tel、password 等文本型 input。对不支持文本选区的输入类型,读取结果可能是 null,调用 setSelectionRange() 还可能抛出异常,因此不要把它用于 number、date 等控件。

完整示例

下面的页面可以读取当前值与默认值,选中标题前 3 个字符,并通过表单重置恢复默认内容。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>读取文本输入</title>
</head>
<body>
  <form id="editor">
    <label>
      标题
      <input id="title" type="text" value="DOM 入门">
    </label>
    <label>
      摘要
      <textarea id="summary">先读取,再处理。</textarea>
    </label>
    <button id="read" type="button">读取状态</button>
    <button id="select" type="button">选中前 3 个字符</button>
    <button id="reset" type="button">重置表单</button>
  </form>
  <pre id="output"></pre>

  <script>
    const form = document.querySelector("#editor");
    const titleInput = document.querySelector("#title");
    const summaryInput = document.querySelector("#summary");
    const output = document.querySelector("#output");

    function renderState() {
      const start = titleInput.selectionStart ?? 0;
      const end = titleInput.selectionEnd ?? 0;

      output.textContent = [
        `标题当前值:${titleInput.value}`,
        `标题默认值:${titleInput.defaultValue}`,
        `摘要当前值:${summaryInput.value}`,
        `标题选区:${start}-${end}`,
        `选中文本:${titleInput.value.slice(start, end)}`
      ].join("\n");
    }

    document.querySelector("#read").addEventListener("click", renderState);

    document.querySelector("#select").addEventListener("click", () => {
      titleInput.focus();
      titleInput.setSelectionRange(0, 3);
      renderState();
    });

    document.querySelector("#reset").addEventListener("click", () => {
      form.reset();
      renderState();
    });
  </script>
</body>
</html>

将文件保存为 index.html 并在浏览器中打开。点击“选中前 3 个字符”后,页面预期显示:

text
标题当前值:DOM 入门
标题默认值:DOM 入门
摘要当前值:先读取,再处理。
标题选区:0-3
选中文本:DOM

把标题改成其他内容后点击“重置表单”,当前值会恢复为 DOM 入门。浏览器中的光标位置会随点击和键盘操作变化,因此直接点击“读取状态”时,选区数字可能不同。

关键边界

脚本给 value 赋值时,通常会影响当前光标或选区,后续若还要定位光标,应在赋值后调用 setSelectionRange()。读取选区前也应确认控件获得焦点,否则得到的索引虽然有效,用户却未必能看到选中效果。

对于输入法组合输入,input 事件可能在文字尚未最终确认时触发。需要处理中文、日文等输入法时,应结合 compositionstart、compositionend 判断是否处于组合阶段,避免过早格式化内容。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取文本框与文本域

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通