大网数据广告活动
Web 标准与前端开发

autocorrect

· 52CE 我爱测

**`autocorrect`** 全局属性是一种枚举属性,控制是否针对拼写和/或标点符号错误启用可编辑文本的自动更正特性。

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。