autocorrect 全局属性是一种枚举属性,控制是否针对拼写和/或标点符号错误启用可编辑文本的自动更正特性。
具体的自动更正行为,包括替换哪些词语,取决于用户代理和底层设备提供的服务。例如,在 macOS 上,用户代理可能依赖于注册替换文本和标点符号。其他设备和浏览器可能使用不同的方法。
自动更正与以下可编辑文本元素相关:
- input 元素,除了
password、email和url类型以外(这些类型不支持自动更正)。 - textarea 元素。
- 任何具有
contenteditable属性的元素。
可编辑元素默认情况下启用自动更正,除了在 form 内的元素以外,默认值可能从表单中继承。明确设置该属性会覆盖默认行为。
值
可能的值有:
-
on或""(空字符串)- : 启用拼写和标点符号的自动更正特性。
-
off- : 禁用可编辑文字的自动更正。
不支持自动更正的 input 元素类型(password、email 和 url)始终处于 off 状态。
对于所有其他可编辑元素,设置上述值以外的任何其他值都会被视为 on。未嵌套在 <form> 内的元素的默认值为 on。
嵌套在 <form> 中时,如果已经设置了 autocorrect,则以下元素将从表单中继承其默认值:button、fieldset、input、output、select 和 textarea。
示例
基本示例
此示例演示了 autocorrect 属性的基本用法。
HTML
我们包含了两个 autocorrect 属性不同的 <input> 元素:
<label for="vegetable">一种蔬菜:</label
><input id="vegetable" name="vegetable" type="text" autocorrect="on" />
<label for="fruit">一种水果:</label
><input id="fruit" name="fruit" type="text" autocorrect="off" />
结果
基本示例
在上述水果和蔬菜文本输入框中输入无效文本。如果你的浏览器支持自动更正,并且底层设备提供了适当的替换,则蔬菜名称输入框中的错别字应自动更正。水果名称字段中的错别字不应更正。
启用与禁用自动更正
此示例演示了如何使用 autocorrect 属性启用与禁用自动更正。
HTML
以下 HTML 标记定义了一个 button,一个 type="text" 类型的“名字” input 元素,一个“简介” textarea 元素和两个 label 元素。
“用户名”元素设置了 autocorrect="off",因为自动更正名字会比较讨厌!“简介”没有指定 autocorrect 值,意味着启用了自动更正(我们可以设置任何除了 off 以外的其他值)。
<button id="reset">重置</button><label for="username">名字:</label
><input id="username" name="username" type="text" autocorrect="off" /><label
for="bio"
>简介:</label
><textarea id="bio" name="bio"></textarea>
<pre id="log"></pre>
#log {
height: 75px;
overflow: scroll;
padding: 0.5rem;
border: 1px solid black;
}
button,
input,
textarea {
display: block;
}
const logElement = document.querySelector("#log");
function log(text) {
logElement.innerText = `${logElement.innerText}${text}\n`;
logElement.scrollTop = logElement.scrollHeight;
}
JavaScript
代码通过检查原型上是否存在 autocorrect 来检查是否支持该特性。如果不存在,则记录这一事实。如果存在,则记录每个文本输入元素的 autocorrect 属性值。
为按钮添加了一个点击处理器,允许重置输入的文本和日志。
const resetButton = document.querySelector("#reset");
const userNameElement = document.querySelector("#username");
const bioElement = document.querySelector("#bio");
if (!("autocorrect" in HTMLElement.prototype)) {
log("不支持自动更正特性");
} else {
log(`userNameElement.autocorrect: ${userNameElement.autocorrect}`);
log(`bioElement.autocorrect: ${bioElement.autocorrect}`);
}
resetButton.addEventListener("click", (e) => {
userNameElement.value = "";
bioElement.value = "";
});
结果
如果你的浏览器支持自动更正,则“简介”和“名字”输入下方的日志区域会显示“简介”输入启用了自动更正,而“名字”输入没有。
启用与禁用自动更正
在姓名和简介文本输入框中输入无效文本。如果设备有输入字词的替代词,则会(仅)用于自动更正“简介”输入框中的文本。
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
