TextArea  - AS3 Flex

Пакет	spark.components
Класс	public class TextArea
Наследование	TextArea SkinnableTextBase SkinnableComponent UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Тема оформления для темы Spark использует класс RichEditableText. Это значит, что элемент управления Spark TextArea поддерживает библиотеку Text Layout Framework (TLF), созданную на основе Flash Text Engine (FTE). Сочетание этих слоев обеспечивает высококачественную международную типографику и макет редактируемого текста. Тема оформления содержит средство прокрутки, отображающее горизонтальные и вертикальные полосы прокрутки для прокручивания текста, а также поддерживает вертикальную прокрутку с помощью колесика мыши. К RichEditableText можно получить доступ с помощью textDisplay, а к Scroller – с помощью scroller.

В теме оформления для мобильной темы используется класс StyleableStageText. Так как в StyleableStageText используются собственные текстовые поля, это позволяет более эффективно управлять вводом и обработкой текста на мобильных устройствах, однако следует учесть существующие ограничения и различия. Поскольку StageText не может использоваться для измерения текста, в TextArea необходимо указать явные, процентные или ограничительные значения width и height. К StyleableStageText можно получить доступ как к textDisplay. Если необходимо использовать тему оформления на основе TextField вместо темы оформления на основе StageText, установите для свойства skinClass значение spark.skins.mobile.TextAreaSkin.

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

Текст отформатирован с использованием стилей CSS, например fontFamily и fontSize.

В теме Spark можно указать значения ширины и высоты TextArea с помощью свойств widthInChars и heightInLines, предоставляющих удобный способ изменения размера шрифта, или использовать свойство typicalText. Учтите, что если используется typicalText, то свойства widthInChars и heightInLines игнорируются. Для всех тем значения высоты и ширины можно определить явно, в пикселах, процентах или с помощью ограничений, например left и right или top и bottom.

Для ограничения числа вводимых пользователем символов можно использовать свойство maxChars, а для указания допустимых для ввода символов – свойство restrict. Для использования данного элемента управления для ввода пароля установите свойство displayAsPassword на значение true.

В мобильной теме свойства экранной клавиатуры, такие как autoCapitalize, autoCorrect, returnKeyLabel и softKeyboardType, определяют подсказки клавиатуры. Если имеющаяся экранная клавиатура не поддерживает любую из функций подсказки, то подсказка игнорируется. Мобильные среды, в которых используются только аппаратные клавиатуры, игнорируют эти подсказки.

TextArea для темы Spark

Наиболее важными отличиями элементов управления Spark TextArea от MX TextArea являются следующие:

• Spark TextArea предлагает пользователям лучшую типографику, лучшую языковую поддержку и лучшее макетирование текста.
• Spark TextArea имеет объектно-ориентированную модель текстового формата RTF, в то время как версия MX таковой не имеет.
• Spark TextArea имеет лучшую поддержку отображения больших массивов текста.
• В Spark TextArea шрифты должны встраиваться отличным от версии MX образом. Для получения информации об использовании атрибута embedAsCFF при встраивании шрифтов см. документацию по шрифтам.

Элемент управления Spark TextArea использует объектно-ориентированную модель RTF-текста TLF, в которой элементы макета, такие как разделы, абзацы, интервалы, гиперссылки и иллюстрации, представлены в среде выполнения объектами ActionScript. Доступ к этим объектам и манипуляции ими возможны с помощью программных средств. Главным объектом в TLF, представляющим текст в формате RTF, является TextFlow. Определите текст RTF для элемента управления TextArea, установив его свойство textFlow для экземпляра TextFlow.

Если отображать текст в нескольких форматах не требуется, назначьте для свойства TextArea text параметр обычного текста. Более подробные сведения о взаимодействии свойств text и textFlow см. в описаниях этих свойств; например, можно установить одно свойство и получить другое.

Во время компиляции можно поместить теги разметки TLF в тег TextArea, как показано в следующем примере:

  <s:TextArea>Hello <s:span fontWeight="bold">World!</s:span></s:TextArea>
  

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

Форматирование текста по умолчанию определено стилями CSS, например fontFamily и fontSize. Любая информация по форматированию в объекте TextFlow переопределяет заданное по умолчанию форматирование, определенное в таблице стилей CSS.

С помощью стилей можно управлять различными характеристиками содержимого TextArea. Вот несколько наиболее часто используемых:

• Управление межстрочным интервалом с помощью стиля lineHeight.
• Управление отступами между абзацами с помощью стилей paragraphSpaceBefore и paragraphSpaceAfter.
• Выровняйте текст, используя стили textAlign и textAlignLast.
• Устанавливает отступ текста от границы элемента управления, используя стили paddingLeft, paddingTop, paddingRight и paddingBottom.

По умолчанию текст обтекает элемент управления по правому краю. Вертикальная полоса прокрутки появляется автоматически, когда текста больше, чем помещается в TextArea. Если значение стиля lineBreak установлено на explicit, новые строки начинаются только при наличии явного переноса строки. Это аналогично использованию CR (\r), LF (\n) или CR+LF (\r\n) в text или <p> и <br/> в разметке TLF. В этом случае горизонтальная полоса прокрутки появляется автоматически, если хотя бы одна строка текста оказывается шире элемента управления.

В области Spark TextArea может отображаться текст, написанный слева направо (LTR) (например, по-французски), справа налево (RTL) (например, по-арабски), а также в двух направлениях одновременно (например, предложения на французском языке в тексте на арабском). Если основным является направление текста справа налево, установите для стиля direction значение rtl. По умолчанию стиль textAlign имеет значение start, благодаря чему текст выравнивается по левому краю, если значение direction равно ltr, и по правому краю, если direction равно rtl. Чтобы выровнять текст по противоположному краю, установите для textAlign значение end.

Область Spark TextArea также поддерживает неограниченное число операций отмены/повтора в рамках одного сеанса. Началом сеанса редактирования считается получение элементом управления фокуса клавиатуры, а окончанием – его потеря.

Чтобы использовать этот компонент в компоненте на основе списка, таком как List или DataGrid, следует создать средство визуализации элементов. Для получения информации о создании средства визуализации элементов см. раздел Пользовательские средства визуализации элементов Spark.

В теме Spark элемент управления TextArea имеет следующие характеристики по умолчанию:

В мобильной теме элемент управления TextArea имеет следующие характеристики по умолчанию:

Показать синтаксис MXML

Скрыть синтаксис MXML

  <s:TextArea
    Properties
    heightInLines="Calculated default"  [Spark theme only]
    textFlow="TextFlow"  [Spark theme only]
    typicalText=null  [Spark theme only]
    widthInChars="Calculated default"  [Spark theme only]
  
    Styles
    horizontalScrollPolicy="auto"  [Spark theme only]
    symbolColor=""
    verticalScrollPolicy="auto"  [Spark theme only]
  />
  

Свойство MXML по умолчаниюcontent

Посмотреть примеры

Связанные элементы API