浏览器与 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 个字符,并通过表单重置恢复默认内容。
<!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 个字符”后,页面预期显示:
标题当前值:DOM 入门
标题默认值:DOM 入门
摘要当前值:先读取,再处理。
标题选区:0-3
选中文本:DOM把标题改成其他内容后点击“重置表单”,当前值会恢复为 DOM 入门。浏览器中的光标位置会随点击和键盘操作变化,因此直接点击“读取状态”时,选区数字可能不同。
关键边界
脚本给 value 赋值时,通常会影响当前光标或选区,后续若还要定位光标,应在赋值后调用 setSelectionRange()。读取选区前也应确认控件获得焦点,否则得到的索引虽然有效,用户却未必能看到选中效果。
对于输入法组合输入,input 事件可能在文字尚未最终确认时触发。需要处理中文、日文等输入法时,应结合 compositionstart、compositionend 判断是否处于组合阶段,避免过早格式化内容。