textArea

ДЕМО

Область для ввода многострочного текста.

XML-элемент

textArea

Java-класс

JmixTextArea

Атрибуты

General: id - enabled - helperText - label - placeholder - readOnly - value - visible

Data Binding: dataContainer - property

Size: height - maxHeight - maxWidth - minHeight - minWidth - width

Position: alignSelf - colspan

Look & Feel: classNames - clearButtonVisible - css - maxRows - minRows - themeNames

Validation: errorMessage - maxLength - minLength - pattern - required

Other: allowedCharPattern - ariaLabel - ariaLabelledBy - autocapitalize - autocomplete - autocorrect - autofocus - autoselect - focusShortcut - tabIndex - trimEnabled

Обработчики

AttachEvent - BlurEvent - ClientValidatedEvent - ComponentValueChangeEvent - CompositionEndEvent - CompositionStartEvent - CompositionUpdateEvent - DetachEvent - FocusEvent - InputEvent - KeyDownEvent - KeyPressEvent - statusChangeHandler - validator

Элементы

tooltip - prefix - suffix - validator

Основы

Используйте textArea, когда ожидается ввод многострочного текста, такого как комментарии или описания.

text area basic 
<textArea label="Comment"
          value="Great job. This is excellent!"/>

Если не задана фиксированная высота, компонент автоматически подстраивает высоту под содержимое. Минимальная и стандартная высота - две строки текста.

Привязка данных

ДЕМО

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

Пример создания textArea с привязкой к данным:

<textArea id="textArea" label="Order description"
          dataContainer="orderDc"
          property="description"/>

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

Варианты темы

Используйте атрибут themeNames для настройки темы компонента.

Вариант Описание Поддерживается в

small

Уменьшает размер компонента.

Aura, Lumo

align-left

Выравнивает значение поля по левому краю.

Aura, Lumo

align-center

Выравнивает значение поля по центру.

Aura, Lumo

align-right

Выравнивает значение поля по правому краю.

Aura, Lumo

helper-above-field

Размещает вспомогательный текст над полем, под меткой.

Aura, Lumo

Атрибуты

Общие атрибуты выполняют ту же функцию для всех компонентов. Следующие атрибуты специфичны для textArea:

Имя

Описание

По умолчанию

autoselect

Установите в true, чтобы значение поля всегда автоматически выделялось при получении фокуса, в противном случае — false.

–

maxRows

Задаёт максимальное количество строк.

–

minRows

Задаёт минимальное количество строк.

2

trimEnabled

Если true, компонент обрезает пробелы в начале и в конце ввода. Например: " aaa bbb " будет сохранено как "aaa bbb".

Настройте этот параметр для всего приложения с помощью свойства jmix.ui.component.default-trim-enabled.

–

Обработчики

Общие обработчики настраиваются одинаково для всех компонентов. Следующие обработчики специфичны для textArea:

Чтобы сгенерировать заглушку обработчика в Jmix Studio, используйте вкладку Handlers панели инспектора Jmix UI, или команду Generate Handler, доступную на верхней панели контроллера экрана и через меню Code → Generate (Alt+Insert / Cmd+N).

Название

Описание

validator

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

Смотрите также

Дополнительную информацию смотрите в документации Vaadin.