Перейти к основному содержимому

TextArea

Отображает текстовое поле

В зависимости от значения свойства View имеет следующие варианты отображения:

  • Default: ввод текстовой информации в поле фиксированного размера;
  • AutoExpand: автоматическое изменение высоты компонента в зависимости от вводимых данных;
  • Custom: изменение высоты компонента пользователем вручную.
    В зависимости от значения свойства Mode возвращает в OutputValue следующие значения:
  • ReturnString: тип String;
  • ReturnArray: тип Array, содержащий массив непустых строк.
  <TextArea
Model-var="foo3"
Label="View=Default"
Text=""
/>

Свойства

ИмяОписаниеТипЗначение по умолчаниюВозможные значения
AutofocusПризнак установки фокуса на компонентbooleanFalse
BadgeКоличественная информация в компонентах Menu, Accordion, Link, Text. В качестве значения может использоваться объект с полями: counter (число),
position ("post" или "pre"), color (цвет)
any
CSSМассив строк-классов CSS-стилей компонентаarray
CombineConfigКонфигурация всех событий компонента. Служебное свойство для генерации фрагментов кода в визуальном режиме редактора форм.
Не рекомендуется указывать значение вручную
object
DataHintПодсказка к компонентуstring
DisabledПризнак запрета на редактирование компонентаbooleanFalse
ErrorТескт ошибки при валидации компонента или undefined/false, если при валидации не обнаружены ошибкиbooleanFalse
ErrorMessageСообщение об ошибке при валидации компонента. Устаревшее свойство, используется только для совместимости с версиями Платформы до 3.0. Вместо ErrorMessage рекомендуется использовать свойство Errorstring
FocusedПризнак фокусировки на компонентеbooleanFalse
HiddenПризнак состояния компонента СкрытbooleanFalse
HighlightErrorПризнак подсвечивания ошибкиbooleanTrue
HintПодсказка над компонентомstring
HintPositionСторона — правая или левая — для отображения подсказкиenumrightleft - Слева
right - Справа
top - Сверху
bottom - Снизу
topRight - Сверху справа
topLeft - Сверху слева
bottomRight - Снизу справа
bottomLeft - Снизу слева
IdИдентификатор компонента для навигации к нему на HTML-страницеstring
LabelНадпись на компонентеstring
MaxLengthМаксимальная длина вводимой строкиnumber30
MinHeightМинимальная высота компонентаstring
ModeФормат возвращаемых данныхenumReturnStringReturnString - OutputValue имеет тип String
ReturnArray - OutputValue имеет тип Array, содержащий массив непустых строк
ModelПсевдоним свойств Value и OutputValueany
NoWriteOnInitПризнак отказа от записи данных в переменную, заданную в свойствах OutputValue или Model, при создании компонентаbooleanFalse
OnBlurПараметры команды, отправляемой при потере фокуса компонентомundefined
OnChangeПараметры команды, отправляемой при изменении компонента, например, при вводе текста, выборе из спискаundefined
OnClickОбработчик события нажатия кнопки мышиundefined
OnDelayПараметры команды, отправляемой по истечении секунды (для предотвращения ложного срабатывания обработчика события) после последнего изменения модели данныхundefined
OnEnterKeyDownПараметры команды, отправляемой по нажатию Enterundefined
OnKeyDownОбработчик события KeyDownundefined
OnKeyUpОбработчик события KeyUpundefined
OnMouseDownОбработчик события MouseDownundefined
OnMouseEnterОбработчик события MouseEnterundefined
OnMouseLeaveОбработчик события MouseLeaveundefined
OnMouseMoveОбработчик события MouseMoveundefined
OnMouseOutОбработчик события MouseOutundefined
OnMouseOverОбработчик события MouseOverundefined
OnMouseUpОбработчик события MouseUpundefined
OnUnmountОбработчик события Unmountundefined
OutputStateИмя переменной для записи информации, относящейся к состоянию компонента, но не относящейся к даннымany
OutputValueПривязка отрисованного компонента к моделиany
ReadOnlyПризнак запрета на редактирование компонента c возможностью копирования содержимогоbooleanFalse
RequiredПризнак обязательности заполнения. Не влияет на валидацию, отображает звездочку справа от надписиbooleanFalse
SlotМетка для динамического добавления другого компонента по его идентификаторуstring
TextЗаполнитель (Placeholder)string
TooltipВсплывающая подсказка над компонентом, чаще используемая для пояснения назначения значкаany
TraceId
Идентификатор для отслеживания состояния компонента исходя из хронологической последовательности:
создание, отрисовка, обновление, удаление; используется для выполнения фрагмента кода по изменению состояния компонента
string
ValidationПризнак ошибки валидации компонента. Устаревшее свойство, используется только для совместимости с версиями Платформы до 3.0. Вместо Validation рекомендуется использовать свойство ErrorbooleanFalse
ValueПривязка модели к отрисованному компонентуany
ViewРазмер и масштабирование компонентаenumDefaultDefault - Используется для ввода пользователем текстовой информации в поле фиксированного размера
AutoExpand - Высота компонента может быть настроена на автоматическое изменение размера в зависимости от вводимых пользователем данных
Custom - Высота компонента может быть изменена пользователем вручную
VisibleПризнак инверсии состояния компонента СкрытbooleanTrue
WriteModeИмя события, по которому меняется значение переменной состояния (экранной формы), переданной в качестве OutputValueenum- Режим ввода без контроля состояния компонента

Примеры

Данные:

  "foo": ""
}

JSX:

<Form AutoMargin={16}>
<TextArea
Model-var="foo"
Label="View=Default"
Text="Placeholder"
/>
<TextArea
Model-var="foo1"
Label="View=AutoExpand"
View="AutoExpand"
Text="Placeholder"
/>
<TextArea
Model-var="foo2"
Label="View=Custom"
Error={foo => {
if (foo.length < 3) return 'Длина foo меньше 3';
if (foo.length < 4) return 'Длина foo меньше 4';
if (foo.length < 5) return 'Длина foo меньше 5';
}}
HighlightError={true}
View="Custom"
Text="Placeholder"
/>
<TextArea
Model-var="foo3"
Label="Disabled"
Disabled={true}
Text="Placeholder"
/>
<TextArea
Model-var="foo4"
Label="ReadOnly"
ReadOnly={true}
/>
</Form>