Общие атрибуты

allowedCharPattern

Устанавливает регулярное выражение для ввода данных пользователя на стороне клиента. Оно должно быть допустимым регулярным выражением JavaScript, которое соответствует одному символу, а не последовательности символов.

Например, чтобы разрешить ввод только цифр и косой черты, используйте "[0-9/]" шаблон.

alignItems

MDN

Определяет расположение элементов относительно поперечной оси. Возможные значения:

  • START – элементы размещаются в начале поперечной оси.

  • END – элементы размещаются в конце поперечной оси.

  • CENTER – элементы центрируются в поперечной оси.

  • STRETCH – элементы с неопределенным размером вдоль поперечной оси растягиваются, чтобы соответствовать контейнеру.

  • BASELINE – элементы размещаются на базовой линии контейнера. Работает только для flex-direction: row.

  • AUTO – элемент наследует свойство alignItems своего родительского контейнера или "stretch", если у него нет родительского контейнера.

Вы можете найти примеры использования в разделе Правила Компоновки.

alignSelf

MDN

Определяет расположение отдельных компонентов внутри контейнера переопределяя при этом значение атрибута alignItems. Возможные значения:

  • START – элемент размещается в начале поперечной оси.

  • END – элемент размещается в конце поперечной оси.

  • CENTER – элемент центрируется в поперечной оси.

  • STRETCH – элемент с неопределенным размером вдоль поперечной оси растягивается, чтобы соответствовать контейнеру.

  • BASELINE – элемент размещается на базовой линии контейнера. Работает только для flex-direction: row.

  • AUTO – элемент наследует свойство alignItems своего родительского контейнера или "stretch", если у него нет родительского контейнера.

Вы можете найти примеры использования в разделе Правила Компоновки.

ariaLabel

MDN

Устанавливает отдельную, визуально скрытую метку для технологий обеспечения доступности, таких как программы чтения с экрана.

ariaLabelledBy

MDN

Позволяет ссылаться на другой компонент, чтобы определить доступное имя используемое для технологий обеспечения доступности, таких как программы чтения с экрана. Данное свойство имеет приоритет над другими методами задания доступного имени, включая ariaLabel и текст внутри компонента.

autocapitalize

MDN

Устанавливает HTML-атрибут autocapitalize. Он используется для задания автоматического перевода текста, вводимого пользователем, в верхний регистр.

autocomplete

MDN

Устанавливает HTML-атрибут autocomplete, указывающий, может ли значение этого компонента автоматически заполняться браузером.

autocorrect

MDN

Устанавливает для поля HTML-атрибут autocorrect.

Данный атрибут поддерживается только в Safari.

autofocus

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

Возможные значения: true, false. По умолчанию все компоненты не в фокусе.

classNames

Добавляет компоненту имена классов CSS.

clearButtonVisible

Устанавливает видимость кнопки очистки поля.

clickShortcut

Defines the keyboard shortcut to fire a click event associated with the component. The component must have an appropriate handler to process the click event, otherwise the key combination will not have any effect.

colspan

Устанавливает количество столбцов, которые должен занимать компонент, если он расположен в formLayout.

По умолчанию 1.

css

Позволяет декларативно указывать CSS-свойства для компонентов UI.

In this example, the css attribute is used to apply inline styles to the textField component, including setting the background color, border, padding, and font size:

<textField datatype="int"
           css="background-color: #f0f0f0;
                border: 1px solid #ccc;
                padding: 5px;
                font-size: 16px;"/>

In the example below, the css attribute is used to provide inline CSS for the button component.

<button id="stepperUpBtn"
        icon="vaadin:chevron-up"
        css="background-color: #4CAF50;
             color: #fff;
             border: none;
             padding: 10px 20px;
             font-size: 16px;
             cursor: pointer"/>

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

Устанавливает компоненту сообщение об ошибке.

flexGrow

MDN

Sets the flex grow factor for this component. When set to 0, the width is fixed.

focusShortcut

Defines the keyboard shortcut that is used to place focus on this component.

height

Устанавливает высоту компонента.

Высота должна быть в формате, понятном браузеру, например, "100px" или "2.5em".

helperText

Задает текст рядом с полем. Его можно использовать, например, для информирования пользователей о том, какие значения ожидает компонент.

id

Идентификатор компонента.

Рекомендуется создавать идентификаторы по правилам идентификаторов Java и использовать camelСase, например: userGrid, filterPanel. Атрибут id можно указать для любого компонента и он должен быть уникальным в пределах экрана.

invalid

Устанавливает недопустимое состояние поля с учетом результата валидации.

  • Если invalid=false, то поле отбражается в допустимом состоянии независимо от результата валидации.

  • If invalid=true, то поле отбражается в допустимом состоянии только если валидация прошла успешно.

label

Устанавливает надпись для компонента.

Значением атрибута может быть либо сам текст, либо ключ в пакете сообщений. В случае ключа значение должно начинаться с `msg:// `префикса.

maxHeight

MDN

Устанавливает CSS-свойство max-height компонента. Высота должна быть в формате, понятном браузеру, например, "100px" или "2.5em".

maxLength

MDN

Устанавливает максимальное количество символов, которое принимает поле.

maxWidth

MDN

Устанавливает CSS-свойство max-width компонента. Ширина должна быть в формате, понятном браузеру, например, "100px" или "2.5em".

metaClass

Определяет класс сущности для компонентов, отображающих сущности, например, DataGrid или entityComboBox.

Установите этот атрибут, если компонент не связан с контейнером данных. В противном случае класс сущности определяется контейнером данных.

minHeight

MDN

Устанавливает CSS-свойство min-height компонента. Высота должна быть в формате, понятном браузеру, например, "100px" или "2.5em".

minLength

MDN

Устанавливает минимальное количество символов, которое принимает поле.

minWidth

MDN

Устанавливает CSS-свойство min-width компонента. Ширина должна быть в формате, понятном браузеру, например, "100px" или "2.5em".

overlayClass

Specifies a list of CSS class names to set on the overlay element.

pattern

MDN

Устанавливает регулярное выражение для значения, проверяемое на стороне клиента. Шаблон должен представлять собой допустимое регулярное выражение JavaScript, соответствующее всему значению, а не только некоторому его подмножеству.

placeholder

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

property

Задает имя атрибута сущности значение которого будет отображаться и редактироваться данным визуальным компонентом.

property всегда используется вместе с атрибутом dataContainer.

readOnly

Устанавливает компонент в режим только для чтения.

required

Указывает, что для этого поля требуется значение.

requiredIndicatorVisible

Устанавливает видимым индикатор необходимости ввода значения.

requiredMessage

Используется вместе с атрибутом required. Устанавливает сообщение, которое будет отображаться пользователю, когда компонент не имеет значения.

Атрибут может содержать само сообщение или ключ из пакета сообщений, например: requiredMessage="msg://infoTextField.requiredMessage"

step

Устанавливает интервал времени в минутах между значениями, доступными для выбора в компонентах timePicker и dateTimePicker. Значение по умолчанию 60:

tabIndex

MDN

Устанавливает 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

Устанавливает видимость компонента.

weekNumbersVisible

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

whiteSpace

MDN

Устанавливает CSS-свойство white-space.

Значение по умолчанию NORMAL.

width

Устанавливает ширину компонента. Ширина должна быть в формате, понятном браузеру, например, "100px" или "2.5em".