autocorrect глобальный атрибут HTML

autocorrect глобальный атрибут — это перечисляемый атрибут, который управляет включением автокоррекции ошибок в правописании и/или пунктуации редактируемого текста.

Конкретное поведение автокоррекции, включая заменяемые слова, зависит от пользовательского агента и служб, предоставляемых устройством. Например, в macOS пользовательский агент может использовать зарегистрированные замены текста и пунктуации. Другие устройства и браузеры могут использовать иной подход.

Автокоррекция применима к редактируемым текстовым элементам:

• Элементы <input>, за исключением password, email и url, которые не поддерживают автокоррекцию.
• Элементы <textarea>.
• Любой элемент, у которого установлен атрибут contenteditable.

Для редактируемых элементов автокоррекция включена по умолчанию, за исключением случаев, когда они находятся внутри элемента <form>: в этом случае значение по умолчанию может наследоваться от формы. Явная установка атрибута переопределяет значение по умолчанию.

Значение

Возможные значения:

on или "" (пустая строка)

Включить автоматическое исправление ошибок в правописании и пунктуации.

off

Отключить автоматическое исправление редактируемого текста.

Для типов элемента <input>, не поддерживающих автокоррекцию, всегда используется состояние off: password, email и url.

Для всех остальных редактируемых элементов любое значение, отличное от перечисленных выше, всегда рассматривается как on. Значение по умолчанию для элементов, не вложенных в <form>, — on.

При вложении в <form> следующие элементы наследуют значение autocorrect по умолчанию от формы, если оно задано: <button>, <fieldset>, <input>, <output>, <select> и <textarea>.

Примеры

Простой пример

В этом примере показано базовое использование атрибута autocorrect.

HTML

Мы добавляем два текстовых элемента <input> с разными значениями атрибутов autocorrect:

<label for="vegetable">A vegetable: </label>
<input id="vegetable" name="vegetable" type="text" autocorrect="on" />

<label for="fruit">A fruit: </label>
<input id="fruit" name="fruit" type="text" autocorrect="off" />

Результат

Введите некорректный текст в поля ввода названий фруктов и овощей выше. Если ваш браузер поддерживает автокоррекцию и устройство предоставляет подходящую замену, опечатка в названии овоща будет исправлена автоматически. Опечатки в поле названия фрукта исправляться не будут.

Включение и отключение автокоррекции

В этом примере показано, как включать и отключать автокоррекцию с помощью атрибута autocorrect.

HTML

Разметка HTML задаёт элемент <button>, элемент <input> типа type="text" для имени, элемент <textarea> для биографии и два элемента <label>.

Для элемента "username" задано значение autocorrect="off", поскольку автокоррекция имени была бы неудобна! Для биографии значение autocorrect не указано, поэтому автокоррекция включена (можно было бы задать любое значение, кроме off).

<button id="reset">Reset</button>
<label for="username">Name: </label>
<input id="username" name="username" type="text" autocorrect="off" />
<label for="bio">Biography: </label>
<textarea id="bio" name="bio"></textarea>

JavaScript

Код проверяет поддержку autocorrect, выясняя, присутствует ли он в прототипе. Если атрибут отсутствует, этот факт записывается в журнал. Если он присутствует, в журнал записывается значение свойства autocorrect для каждого элемента ввода текста.

Для кнопки добавляется обработчик щелчка, который позволяет сбросить введённый текст и журнал.

const resetButton = document.querySelector("#reset");
const userNameElement = document.querySelector("#username");
const bioElement = document.querySelector("#bio");

if (!("autocorrect" in HTMLElement.prototype)) {
  log("autocorrect not supported");
} else {
  log(`userNameElement.autocorrect: ${userNameElement.autocorrect}`);
  log(`bioElement.autocorrect: ${bioElement.autocorrect}`);
}

resetButton.addEventListener("click", (e) => {
  userNameElement.value = "";
  bioElement.value = "";
});

Результаты

Если ваш браузер поддерживает автокоррекцию, область журнала под полями «Биография» и «Имя» должна показывать, что она включена для поля «Биография», но отключена для поля «Имя».

Введите некорректный текст в поля ввода имени и биографии. Если на устройстве есть замена для введённого слова, текст будет автоматически исправлен только в поле «Биография».

Спецификации

Совместимость с браузерами

См. также

• Все глобальные атрибуты.
• spellcheck.