Инструменты пользователя

Инструменты сайта

  • Показать исходный текст
  • История страницы
  • Ссылки сюда
  • Оставить на чай
  • Экспорт в PDF
  • Наверх

  • software:development:web:docs:web:html:attributes:autocomplete

    Это старая версия документа!


    HTML атрибут: autocomplete (автозаполнение)

    Атрибут HTML autocomplete позволяет веб-разработчикам указать, какие разрешения должен иметь пользовательский агент для автоматической помощи при заполнении значений полей формы, а также указания браузеру относительно типа информации, ожидаемой в поле.

    Он доступен для <input> элементов, которые принимают текстовое или числовое значение в качестве входных данных, <textarea> элементов, <select> элементов и <form> элементов.

    Источник предлагаемых значений обычно зависит от браузера; обычно значения берутся из прошлых значений, введенных пользователем, но они также могут быть взяты из предварительно настроенных значений. Например, браузер может позволить пользователю сохранять свое имя, адрес, номер телефона и адреса электронной почты для целей автозаполнения. Возможно, браузер предлагает возможность сохранять зашифрованную информацию о кредитной карте для автоматического заполнения после процедуры аутентификации.

    Если элемент <input>, <select> или <textarea> не имеет autocomplete атрибута, браузеры используют атрибут autocomplete владельца формы элемента, который является либо <form> элементом, потомком которого является элемент, либо атрибутом <form> которого id указан formатрибут элемента (см. <form> autocomplete атрибут).

    Примечание. Чтобы обеспечить автозаполнение, пользовательским агентам могут потребоваться элементы: <input> / <select> / <textarea>

    1. Иметь name и/или id атрибут
    2. Быть потомками <form> элемента
    3. Форма для кнопки отправки (sumbit)

    Попробуй

    Значения

    tablelayout

    «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.

    Обзор

    Свойство Accept является атрибутом типа файла <input>. Он поддерживался в <form>элементе, но был удален в пользу файла .

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

    Например, существует несколько способов идентификации файлов Microsoft Word, поэтому сайт, принимающий файлы Word, может использовать <input> следующий код:

    HTML
    <input
      type="file"
      id="docpicker"
      accept=".doc,.docx,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document" />

    Принимая во внимание, что если вы принимаете медиафайл, вы можете включить любой формат этого типа мультимедиа:

    HTML
    <input type="file" id="soundFile" accept="audio/*" />
    <input type="file" id="videoFile" accept="video/*" />
    <input type="file" id="imageFile" accept="image/*" />

    Атрибут accept не проверяет типы выбранных файлов; он предоставляет браузерам подсказки, помогающие пользователям выбрать правильные типы файлов. Пользователи по-прежнему могут (в большинстве случаев) переключить опцию в средстве выбора файлов, которая позволяет переопределить ее и выбрать любой файл по своему желанию, а затем выбрать неправильные типы файлов.

    По этой причине вам следует убедиться, что ожидаемое требование проверено на стороне сервера.

    Примеры

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

    Обратите внимание, что последний пример позволяет вам выбрать несколько изображений. См. multiple атрибут для получения дополнительной информации.

    Уникальные спецификаторы типов файлов

    Уникальный спецификатор типа файла — это строка, описывающая тип файла, который может быть выбран пользователем в <input> элементе type file. Каждый уникальный спецификатор типа файла может принимать одну из следующих форм:

    • Допустимое расширение имени файла без учета регистра, начинающееся с точки («».«). Например: .jpg, .pdf, или .doc.
    • Действительная строка типа MIME без расширений.
    • Строка, audio/* означающая «любой аудиофайл».
    • Строка, video/* означающая «любой видеофайл».
    • Строка, image/* означающая «любой файл изображения».

    Атрибут accept принимает в качестве значения строку, содержащую один или несколько уникальных спецификаторов типов файлов, разделенных запятыми. Например, средство выбора файлов, которому требуется контент, который может быть представлен в виде изображения, включая как стандартные форматы изображений, так и файлы PDF, может выглядеть так:

    HTML
    <input type="file" accept="image/*,.pdf" />

    Использование файловых входов

    Независимо от устройства или операционной системы пользователя, при вводе файла имеется кнопка, открывающая диалоговое окно выбора файла, позволяющее пользователю выбрать файл.

    Включение multiple атрибута, как показано выше, указывает, что одновременно можно выбрать несколько файлов. Пользователь может выбрать несколько файлов из средства выбора файлов любым способом, который позволяет выбранная им платформа (например, удерживая нажатой кнопку Shift или Control и затем щелкнув). Если вы хотите, чтобы пользователь выбирал только один файл для каждого <input>, опустите multiple атрибут.

    Ограничение допустимых типов файлов

    Часто вы не захотите, чтобы пользователь мог выбрать любой произвольный тип файла; вместо этого вы часто хотите, чтобы они выбирали файлы определенного типа или типов. Например, если ваш входной файл позволяет пользователям загружать изображение профиля, вы, вероятно, захотите, чтобы они выбрали веб-совместимые форматы изображений, такие как JPEG или PNG.

    Приемлемые типы файлов можно указать с помощью accept атрибута, который принимает разделенный запятыми список разрешенных расширений файлов или типов MIME. Некоторые примеры:

    • accept=«image/png» или accept=».png«— принимает файлы PNG.
    • accept=«image/png, image/jpeg» или accept=».png, .jpg, .jpeg«— Принимать файлы PNG или JPEG.
    • accept=«image/*»— Принять любой файл с image/* типом MIME. (Многие мобильные устройства также позволяют пользователю делать снимки с помощью камеры, когда она используется.)
    • accept=».doc,.docx,.xml,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document« — принимайте все, что схожи с документом MS Word.

    Давайте посмотрим на более полный пример:

    Только авторизованные участники могут оставлять комментарии.
    software/development/web/docs/web/html/attributes/autocomplete.1693412727.txt.gz · Последнее изменение: 2023/08/30 19:25 — vladpolskiy