Общие атрибуты
Устанавливает регулярное выражение для ввода данных пользователя на стороне клиента. Оно должно быть допустимым регулярным выражением JavaScript, которое соответствует одному символу, а не последовательности символов.
Например, чтобы разрешить ввод только цифр и косой черты, используйте «[0-9/]» шаблон.
ariaLabel
Устанавливает отдельную, визуально скрытую метку для технологий обеспечения доступности, таких как программы чтения с экрана.
autocapitalize
Устанавливает HTML-атрибут autocapitalize . Он используется для задания автоматического перевода текста, вводимого пользователем, в верхний регистр.
autocomplete
Устанавливает HTML-атрибут autocomplete , указывающий, может ли значение этого компонента автоматически заполняться браузером.
autocorrect
Устанавливает для поля HTML-атрибут autocorrect .
| Данный атрибут поддерживается только в Safari. |
autofocus
Указывает, что компонент должен иметь фокус ввода при загрузке страницы.
Возможные значения: true , false . По умолчанию все компоненты не в фокусе.
classNames
Добавляет компоненту имена классов CSS.
clearButtonVisible
Устанавливает видимость кнопки очистки поля.
colspan
Устанавливает количество столбцов, которые должен занимать компонент, если он расположен в formLayout.
dataContainer
Устанавливает контейнер данных, определенный в разделе data XML-дескриптора экрана.
При установке в dataContainer контейнера экземпляра, необходимо также установить атрибут property.
datatype
Устанавливает тип данных содержимого компонента. Возможные значения:
- boolean
- byteArray
- char
- date
- dateTime
- decimal
- double
- fileRef
- int
- localDate
- localDateTime
- localTime
- long
- offsetDateTime
- offsetTime
- string
- time
- uri
- uuid
Данный атрибут необходимо установить если компонент не связан с каким-либо атрибутом сущности. В противном случае тип данных определяется типом атрибута сущности.
dateFormat
Устанавливает предпочтительный формат для значений даты в компоненте. По умолчанию используется формат даты текущей локали.
enabled
Делает компонент явно отключенным или включенным.
errorMessage
Устанавливает компоненту сообщение об ошибке.
height
Устанавливает высоту компонента.
Высота должна быть в формате, понятном браузеру, например, «100px» или «2.5em» .
helperText
Задает текст рядом с полем. Его можно использовать, например, для информирования пользователей о том, какие значения ожидает компонент.
id
Рекомендуется создавать идентификаторы по правилам идентификаторов Java и использовать camelСase, например: userGrid , filterPanel . Атрибут id можно указать для любого компонента и он должен быть уникальным в пределах экрана.
invalid
Устанавливает недопустимое состояние поля с учетом результата валидации.
- Если invalid=false , то поле отбражается в допустимом состоянии независимо от результата валидации.
- If invalid=true , то поле отбражается в допустимом состоянии только если валидация прошла успешно.
label
Устанавливает надпись для компонента.
Значением атрибута может быть либо сам текст, либо ключ в пакете сообщений. В случае ключа значение должно начинаться с `msg:// `префикса.
maxHeight
Устанавливает CSS-свойство max-height компонента. Высота должна быть в формате, понятном браузеру, например, «100px» или «2.5em» .
maxLength
Устанавливает максимальное количество символов, которое принимает поле.
maxWidth
Устанавливает CSS-свойство max-width компонента. Ширина должна быть в формате, понятном браузеру, например, «100px» или «2.5em» .
metaClass
Определяет класс сущности для компонентов, отображающих сущности, например, DataGrid или entityComboBox.
Установите этот атрибут, если компонент не связан с контейнером данных. В противном случае класс сущности определяется контейнером данных.
minHeight
Устанавливает CSS-свойство min-height компонента. Высота должна быть в формате, понятном браузеру, например, «100px» или «2.5em» .
minLength
Устанавливает минимальное количество символов, которое принимает поле.
minWidth
Устанавливает CSS-свойство min-width компонента. Ширина должна быть в формате, понятном браузеру, например, «100px» или «2.5em» .
pattern
Устанавливает регулярное выражение для значения, проверяемое на стороне клиента. Шаблон должен представлять собой допустимое регулярное выражение JavaScript, соответствующее всему значению, а не только некоторому его подмножеству.
placeholder
Определяет подсказку пользователю о том, что можно ввести в компонент.
property
Задает имя атрибута сущности значение которого будет отображаться и редактироваться данным визуальным компонентом.
property всегда используется вместе с атрибутом dataContainer.
readOnly
Устанавливает компонент в режим только для чтения.
required
Указывает, что для этого поля требуется значение.
requiredIndicatorVisible
Устанавливает видимым индикатор необходимости ввода значения.
requiredMessage
Используется вместе с атрибутом required. Устанавливает сообщение, которое будет отображаться пользователю, когда компонент не имеет значения.
Атрибут может содержать само сообщение или ключ из пакета сообщений, например: requiredMessage=»msg://infoTextField.requiredMessage»
step
Устанавливает интервал времени в минутах между значениями, доступными для выбора в компонентах timePicker и dateTimePicker. Значение по умолчанию 60 :
tabIndex
Устанавливает HTML-атрибут tabindex в компоненте. Атрибут указывает, может ли его элемент быть сфокусирован и как он участвует в последовательной навигации с помощью клавиатуры:
- Отрицательное значение (обычно tabindex = -1 означает, что компонент должен быть доступен для фокуса, но не должен быть достижим при последовательной навигации с помощью клавиатуры.
- tabindex = `0 означает, что компонент должен быть доступен для фокусировки при последовательной навигации с помощью клавиатуры, но его порядок определяется исходным порядком документа.
- Положительное значение означает, что компонент должен быть доступен для фокусировки при последовательной навигации с помощью клавиатуры, а его порядок определяется значением атрибута. То есть tabindex = 4 фокусируется до tabindex = 5 , но после tabindex = 3 . Если несколько компонентов имеют одно и то же положительное значение tabindex , их порядок относительно друг друга соответствует их положению в документе.
text
Задает текстовое содержимое компонента.
Значением атрибута может быть либо сам текст, либо ключ в пакете сообщений. В случае ключа значение должно начинаться с msg:// префикса.
Есть два способа заданя ключа:
- Короткий ключ — в этом случае сообщение будет искаться в группе сообщений текущего экрана. Например: msg://infoField.caption .
- Полный ключ, включающий группу сообщений, например: msg://com.company.sample.view.user/infoField.caption .
themeNames
Добавляет компоненту тему.
title
Значение атрибута устанавливается в HTML-атрибуты title и aria-label. Большинство компонентов интерпретируют его как всплывающую подсказку.
value
Sets the value of the component. If the new value is not equal to getValue() , fires a value change event. May throw IllegalArgumentException if the value is not acceptable.
valueChangeMode
Устанавливает новый режим изменения значения для компонента.
valueChangeTimeout
Применяет тайм-аут изменения значения для данного valueChangeMode.
visible
Устанавливает видимость компонента.
autocapitalize
Некоторые методы ввода текста, например с помощью виртуальных клавиатур на мобильных устройствах, а также голосовой ввод, часто помогают пользователям автоматически писать первые буквы в предложении заглавными. Виртуальная клавиатура, которая реализует автокапитализацию, может автоматически переключиться на отображение заглавных букв (но разрешить пользователю переключать ее обратно в нижний регистр). Другие типы ввода, например голосовой ввод, могут выполнять автокапитализацию таким образом, чтобы не давать пользователям возможность сразу вмешаться. Атрибут autocapitalize позволяет контролировать такое поведение. Атрибут autocapitalize не влияет на поведение при вводе с помощью физической клавиатуры. (По этой причине, а также из-за возможности последующей правки нельзя полагаться на атрибут без проверки ввода.) Атрибут autocapitalize никогда не приводит к активации автокапитализации для элементов input , с типом url , email или password .
Синтаксис
Значения:
- off или none : не применяется автоматическая активация (все буквы по умолчанию — строчные).
- on или sentences : первая буква каждого предложения по умолчанию имеет заглавную букву, все остальные буквы по умолчанию строчные.
- words : первая буква каждого слова по умолчанию имеет заглавную букву, все остальные буквы по умолчанию строчные.
- characters : все буквы должны быть по умолчанию в верхнем регистре.
Совместимость браузеров
Настольные браузеры
| Базовая поддержка | ? | ? | ? | ? | ? | ? |
|---|
Мобильные браузеры
| Базовая поддержка | ? | ? | ? | ? | ? | ? | ? |
|---|
См. также:
Глобальные атрибуты HTML
Глобальные атрибуты — это атрибуты, которые могут быть применены к любому элементу HTML, независимо от его типа. Они используются для предоставления дополнительной информации или функциональности элементам, улучшая их поведение или внешний вид по умолчанию. В этом документе представлен краткий обзор каждого из следующих глобальных атрибутов:
accesskey
Атрибут accesskey назначает клавиатурное сокращение для элемента HTML, позволяя пользователям быстро получить доступ или активировать элемент, нажав указанную клавишу в сочетании с клавишей Alt (или клавишей Ctrl на Mac).
autocapitalize
Атрибут autocapitalize управляет поведением автоматической капитализации для элементов ввода и элементов contenteditable . Он может быть установлен на on или off , или на более конкретные значения, такие как words , sentences или characters , чтобы определить желаемое поведение капитализации.
autofocus
Атрибут autofocus , когда он применяется к элементу формы, указывает, что элемент должен получить фокус автоматически при загрузке страницы. Это особенно полезно для полей ввода, где от пользователя ожидается немедленный ввод, например, поля поиска.
contenteditable
Атрибут contenteditable определяет, может ли содержимое элемента редактироваться пользователем. При значении true элемент становится редактируемым, позволяя пользователям изменять его содержимое непосредственно в браузере.
dir
Атрибут dir определяет направление текста для содержимого элемента. Он может быть установлен в значение ltr (слева направо) или rtl (справа налево). Этот атрибут особенно важен для языков, которые пишут справа налево, таких как арабский и иврит.
dragggable
Атрибут draggable определяет, может ли пользователь перетаскивать элемент. Если установлено значение true , элемент становится перетаскиваемым, что позволяет пользователям перемещать его в пределах страницы или между различными страницами или приложениями.
enterkeyhint
Атрибут enterkeyhint предоставляет браузеру подсказку об ожидаемом действии, когда пользователь нажимает клавишу Enter при взаимодействии с элементом ввода. Возможные значения: enter , done , go , next , previous , search и send .
hidden
Атрибут hidden — это булев атрибут, который, когда присутствует, скрывает элемент от пользователя. Этот атрибут можно использовать для хранения информации, которая не должна отображаться, или для условного скрытия элементов на основе взаимодействия с пользователем.
inert
Атрибут inert , когда он присутствует, не позволяет элементу и его потомкам получать события пользовательского ввода или быть сфокусированными. Это может быть полезно для создания модальных диалогов или других элементов интерфейса, с которыми не следует взаимодействовать до тех пор, пока не будет выполнено определенное условие.
inputmode
Атрибут inputmode предоставляет браузеру подсказку о типе данных, которые, как ожидается, будут введены пользователем в элемент управления формой, влияя на раскладку виртуальной клавиатуры. Возможные значения: text , decimal , numeric , tel , email , url и search .
is
Атрибут is используется в сочетании с пользовательскими элементами, позволяя разработчикам создавать новые HTML-элементы с пользовательским поведением и свойствами. Он указывает имя определения пользовательского элемента, от которого элемент должен унаследовать свое поведение.
itemid
Атрибут itemid , используемый в сочетании с Microdata API, присваивает уникальный идентификатор элементу на странице, позволяя разработчикам создавать машиночитаемые структурированные данные.
itemprop
Атрибут itemprop используется с микроданными для определения свойства элемента, что позволяет поисковым системам и другим инструментам извлекать и обрабатывать структурированные данные с веб-страницы.
itemref
Атрибут itemref используется в микроданных для определения отношений между элементом с атрибутом itemscope и другими элементами, содержащими атрибуты itemprop , которые принадлежат к тому же элементу, но не являются потомками элемента с itemscope .
itemscope
Атрибут itemscope используется с микроданными для определения нового элемента, создавая область видимости для атрибутов itemprop , чтобы связать свойства с элементом.
itemtype
Атрибут itemtype используется в микроданных для определения словаря для элемента, обеспечивая контекст для свойств, определенных с помощью атрибутов itemprop .
lang
Атрибут lang определяет язык содержимого элемента, улучшая доступность, позволяя программам чтения с экрана использовать правильные правила произношения и помогая в переводе.
nonce
Атрибут nonce используется в политике безопасности контента (CSP), чтобы разрешить выполнение определенных встроенных скриптов или стилей, повышая безопасность путем предотвращения несанкционированного выполнения кода.
popover
Атрибут popover не является стандартным глобальным атрибутом в HTML. Он может относиться к пользовательскому атрибуту, используемому в определенных библиотеках или фреймворках для отображения дополнительной информации при наведении или нажатии на элемент.
spellcheck
Атрибут spellcheck определяет, должно ли содержимое элемента проверяться браузером на наличие орфографических и грамматических ошибок.
style
Атрибут style используется для применения встроенных стилей CSS непосредственно к элементу HTML, что позволяет быстро и точно изменять стиль без необходимости использования внешней таблицы стилей.
tabindex
Атрибут tabindex определяет порядок, в котором элемент получает фокус, когда пользователь перемещается по странице с помощью клавиши Tab.
title
Атрибут title предоставляет дополнительную информацию об элементе, обычно отображаемую в виде всплывающей подсказки при наведении курсора мыши на элемент.
translate
Атрибут translate указывает, следует ли переводить содержимое элемента при локализации страницы, что позволяет лучше контролировать процесс перевода.
«Доктайп» — журнал о фронтенде. Читайте, слушайте и учитесь с нами.
autocapitalize
The autocapitalize global attribute is an enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user.
The attribute must take one of the following values:
- off or none : No autocapitalization is applied (all letters default to lowercase)
- on or sentences : The first letter of each sentence defaults to a capital letter; all other letters default to lowercase
- words : The first letter of each word defaults to a capital letter; all other letters default to lowercase
- characters : All letters should default to uppercase
The autocapitalize attribute doesn’t affect behavior when typing on a physical keyboard. Instead, it affects the behavior of other input mechanisms, such as virtual keyboards on mobile devices and voice input. The behavior of such mechanisms is that they often assist users by automatically capitalizing the first letter of sentences. The autocapitalize attribute enables authors to override that behavior per-element.
The autocapitalize attribute never causes autocapitalization to be enabled for an element with a type attribute whose value is url , email , or password .
Specifications
| Specification |
|---|
| HTML Standard # attr-autocapitalize |
Browser compatibility
BCD tables only load in the browser
Found a content problem with this page?
- Edit the page on GitHub.
- Report the content issue.
- View the source on GitHub.
This page was last modified on Mar 13, 2023 by MDN contributors.
Your blueprint for a better internet.