Это старая версия документа!
Содержание
HTML атрибут: autocomplete (автозаполнение)
Атрибут HTML autocomplete
позволяет веб-разработчикам указать, какие разрешения должен иметь пользовательский агент для автоматической помощи при заполнении значений полей формы, а также указания браузеру относительно типа информации, ожидаемой в поле.
Он доступен для <input> элементов, которые принимают текстовое или числовое значение в качестве входных данных, <textarea> элементов, <select> элементов и <form> элементов.
Источник предлагаемых значений обычно зависит от браузера; обычно значения берутся из прошлых значений, введенных пользователем, но они также могут быть взяты из предварительно настроенных значений. Например, браузер может позволить пользователю сохранять свое имя, адрес, номер телефона и адреса электронной почты для целей автозаполнения. Возможно, браузер предлагает возможность сохранять зашифрованную информацию о кредитной карте для автоматического заполнения после процедуры аутентификации.
Если элемент <input>, <select> или <textarea> не имеет autocomplete
атрибута, браузеры используют атрибут autocomplete
владельца формы элемента, который является либо <form> элементом, потомком которого является элемент, либо атрибутом <form> которого id
указан formатрибут элемента (см. <form> autocomplete
атрибут).
Примечание. Чтобы обеспечить автозаполнение, пользовательским агентам могут потребоваться элементы: <input>
/ <select>
/ <textarea>
- Иметь
name
и/илиid
атрибут - Быть потомками
<form>
элемента - Форма для кнопки отправки (sumbit)
Попробуй
Значения
«off» | Браузеру не разрешено автоматически вводить или выбирать значение для этого поля. Возможно, документ или приложение предоставляет собственную функцию автозаполнения или соображения безопасности требуют, чтобы значение поля не вводилось автоматически. |
Примечание. В большинстве современных браузеров установка autocomplete« off» не помешает менеджеру паролей спрашивать пользователя, хотят ли они сохранить информацию об имени пользователя и пароле, или автоматически заполнять эти значения в форме входа на сайт. См. атрибут автозаполнения и поля входа. |
|
«on» | Браузеру разрешено автоматически завершать ввод. Никаких указаний относительно типа данных, ожидаемых в поле, не предоставляется, поэтому браузер может принять собственное решение. |
«name» | ожидается, что в поле будет указано полное имя человека. Обычно предпочтительнее использовать « name» вместо того, чтобы разбивать имя на компоненты, поскольку это позволяет избежать широкого разнообразия человеческих имен и их структуры; однако вы можете использовать следующие autocomplete значения, если вам нужно разбить имя на компоненты: |
«honorific-prefix» :Префикс или титул, например «Миссис», «Мистер», «Мисс», «Мисс», «Доктор» или «Мадемуазель». | |
«given-name» :Данное (или «имя») имя. | |
«additional-name» :Второе имя. | |
«family-name» :Фамилия (или «фамилия») | |
«honorific-suffix» :Суффикс, например «младший», «бакалавр наук», «доктор философии», «MBASW» или «IV». | |
«nickname» :Псевдоним или псевдоним. | |
«email» | адрес электронной почты. |
«username» | имя пользователя или имя учетной записи. |
«new-password» | Новый пароль. При создании новой учетной записи или изменении паролей это поле следует использовать для поля «Введите новый пароль» или «Подтвердите новый пароль», а не общего поля «Введите текущий пароль», которое может присутствовать. Это может использоваться браузером как для предотвращения случайного ввода существующего пароля, так и для оказания помощи в создании безопасного пароля (см. также Предотвращение автозаполнения с помощью autocomplete="new-password"). |
«current-password» | текущий пароль пользователя. |
«one-time-code» | одноразовый пароль (OTP) для проверки информации пользователя. Чаще всего это номер телефона, используемый в качестве дополнительного фактора при входе в систему. |
«organization-title» | должность или должность, которую человек имеет в организации, например «Старший технический писатель», «Президент» или «Помощник командира отряда». |
«organization» | название компании или организации, например «Acme Widget Company» или «Девочки-скауты Америки». |
«street-address» | Адрес. Это может быть несколько строк текста, и он должен полностью идентифицировать местоположение адреса на втором административном уровне (обычно город), но не должен включать название города, почтовый индекс или индекс или название страны. |
«shipping» :адрес для отправки товара. Его можно комбинировать с другими токенами, такими как «shipping street-address» и «shipping address-level2» . |
|
«billing» : почтовый адрес, который необходимо связать с используемой формой оплаты. Его можно комбинировать с другими токенами, такими как «billing street-address» и «billing address-level2» . |
|
«address-line1», «address-line2», «address-line3» | каждая отдельная строка адреса. Они должны присутствовать только в том случае, если «street-address» отсутствует. |
«address-level4» | Самый детальный административный уровень для адресов, имеющих четыре уровня. |
«address-level3» | Третий административный уровень для адресов с минимум тремя административными уровнями. |
«address-level2» | Второй административный уровень , в адресах с минимум двумя из них. В странах с двумя административными уровнями это обычно город, поселок, деревня или другой населенный пункт, в котором расположен адрес. |
«address-level1» | Первый административный уровень по адресу. Обычно это провинция, в которой расположен адрес. В Соединенных Штатах это будет штат. В Швейцарии кантон. В Великобритании почтовый город. |
«country» | код страны или территории. |
«country-name» | название страны или территории. |
«postal-code» | почтовый индекс (в США это почтовый индекс). |
«cc-name» | Полное имя, напечатанное или связанное с платежным инструментом, например кредитной картой. Использование поля полного имени обычно предпочтительнее, чем разбиение имени на части. |
«cc-given-name» | Имя (имя), указанное на платежном инструменте, таком как кредитная карта. |
«cc-additional-name» | второе имя, указанное на платежном инструменте или кредитной карте. |
«cc-family-name» | фамилия, указанная на кредитной карте. |
«cc-number» | номер кредитной карты или другой номер, определяющий способ оплаты, например номер счета. |
«cc-exp» | дата истечения срока действия способа оплаты, обычно в формате «ММ/ГГ» или «ММ/ГГГГ». |
«cc-exp-month» | Месяц, в котором истекает срок действия способа оплаты. |
«cc-exp-year» | год истечения срока действия способа оплаты. |
«cc-csc» | код безопасности платежного инструмента; на кредитных картах это трехзначный проверочный номер, указанный на обратной стороне карты. |
«cc-type» | тип платежного инструмента (например, «Visa» или «Master Card»). |
«transaction-currency» | Валюта, в которой должна осуществляться транзакция. |
«transaction-amount» | Сумма, указанная в валюте transaction-currencyтранзакции, указанной в параметре « », для формы платежа. |
«language» | Предпочтительный язык, указанный в виде допустимого языкового тега BCP 47. |
«bday» | дата рождения в виде полной даты. |
«bday-day» | день месяца даты рождения. |
«bday-month» | Месяц года даты рождения. |
«bday-year» | Год рождения. |
«sex» | гендерная идентичность (например, «Женский», «Фаафафине», «Хиджра», «Мужской», «Недвоичный») в виде текста произвольной формы без новых строк. |
«tel» | полный номер телефона, включая код страны. Если вам нужно разбить номер телефона на компоненты, вы можете использовать эти значения для этих полей. |
«tel-country-code» :Код страны, например «1», для США, Канады и других регионов Северной Америки и некоторых частей Карибского бассейна. | |
«tel-national» :Полный номер телефона без компонента кода страны, включая внутренний префикс страны. Для номера телефона «1-855-555-6502» значение этого поля будет «855-555-6502». | |
«tel-area-code» :Код города с любым внутренним префиксом страны, если это необходимо. | |
«tel-local» :Номер телефона без кода страны или города. Его можно разделить на две части для телефонных номеров, у которых есть номер обмена, а затем номер внутри обмена. Для номера телефона «555-6502» используйте « tel-local-prefix» для «555» и « tel-local-suffix» для «6502». | |
«tel-extension» | добавочный телефонный код внутри телефонного номера, например номер комнаты или люкса в отеле или добавочный номер офиса в компании. |
«impp» | URL-адрес конечной точки протокола обмена мгновенными сообщениями, например «xmpp: username@example.net». |
«url» | URL-адрес, например домашняя страница или адрес веб-сайта компании, в зависимости от контекста других полей формы. |
«photo» | URL-адрес изображения, представляющего человека, компанию или контактную информацию, указанную в других полях формы. |
«webauthn» | ключи доступа, генерируемые API веб-аутентификации по запросу условного navigator.credentials.get() вызова (т.е. того, который включает mediation 'conditional'). Дополнительные сведения см. в разделе Вход с паролем через автозаполнение формы. |
Более подробную информацию см. в стандарте WHATWG .|
Примечание.
Этот autocomplete
атрибут также определяет, будет ли Firefox — в отличие от других браузеров — сохранять динамическое отключенное состояние и (если применимо) динамическую проверку элемента <input>
, <textarea>
элемента или всей <form>
страницы при загрузке страницы. Функция сохранения включена по умолчанию. Установка значения атрибута autocomplete
на off
отключает эту функцию. Это работает даже тогда, когда autocomplete
атрибут обычно не применяется из-за его type
. См. ошибку Firefox 654072.
Примеры
Административные уровни в адресах
Четыре поля административного уровня (address-level1до address-level4
) описывают адрес с точки зрения возрастающей точности в пределах страны, в которой расположен адрес. Каждая страна имеет свою собственную систему административных уровней и может располагать уровни в разном порядке при написании адресов.
address-level1
всегда представляет самое широкое административное деление; это наименее конкретная часть адреса, не считая названия страны.
Гибкость макета формы
Учитывая, что разные страны пишут свой адрес по-разному, каждое поле находится в разных местах адреса и даже полностью различаются наборами и количеством полей, может быть полезно, если, когда это возможно, ваш сайт сможет переключиться на ожидаемый макет. вашими пользователями при представлении формы ввода адреса, учитывая страну, в которой находится адрес.
Вариации
Способ использования каждого административного уровня будет варьироваться от страны к стране. Ниже приведены несколько примеров; это не исчерпывающий список.
Соединенные Штаты
Типичный домашний адрес в США выглядит так:
432 Anywhere St, Примервилль, Калифорния 95555
В Соединенных Штатах наименее конкретной частью адреса является штат, в данном случае «CA» (официальное сокращение Почтовой службы США от «Калифорния»). Таково address-level1
состояние или «CA» в данном случае.
Вторая по значимости часть адреса — это название города или поселка, как и address-level2
«Exampleville» в этом примере адреса.
В адресах США не используются уровни 3 и выше.
Великобритания
Формы ввода адреса в Великобритании должны содержать один уровень адреса и одну, две или три адресные строки, в зависимости от адреса. Полный адрес будет выглядеть так:
103 Фрогмарч-стрит Аппер-Уэппинг Винчелси TN99 8ZZ
Уровни адресов:
address-level1
: Почтовый город — в данном случае «Уинчелси».address-line2
: Местность — в данном случае «Аппер-Уаппинг».address-line1
: Характеристики дома/улицы — «Фрогмарч-стрит, 103».
Почтовый индекс отдельный. Обратите внимание, что на самом деле вы можете использовать только почтовый индекс и address-line1
успешно доставлять почту в Великобритании, поэтому они должны быть единственными обязательными элементами, но обычно люди склонны предоставлять более подробную информацию.
Китай
В Китае может использоваться до трех административных уровней: провинция, город и район.
Почтовый индекс из 6 цифр не всегда требуется, но при его наличии он для ясности помещается отдельно с этикеткой. Например:
北京市东城区建国门北大街 8 号华润大厦 17 层 1708 单元 邮编:100005
Япония
Адрес в Японии обычно записывается в одну строку в порядке от менее конкретной к более конкретной части (в обратном порядке по отношению к США ). В адресе имеется два или три административных уровня. Дополнительную строку можно использовать для отображения названий зданий и номеров комнат. Почтовый индекс указан отдельно. Например:
〒 381-0000 長野県長野市某町 123
«〒» и следующие семь цифр обозначают почтовый индекс.
address-level1
используется для обозначения префектур или мегаполиса Токио; В данном случае «長野県» (префектура Нагано). address-level2
обычно используется для городов, округов, поселков и деревень; В данном случае «長野市» (город Нагано). «某町 123» address-line1
состоит из названия участка и номера участка.