Тег [Bindable]. Flex

Если нам необходимо связать два свойства так, чтобы при изменении первого (источника) Flex автоматически копировал данные во второе (приемник), мы можем использовать метатег [Bindable]. Указав [Bindable] перед свойством-источником, мы даем понять Flex, что при изменении свойства надо генерировать событие.
[Bindable]
[Bindable(event="eventname")]

Если событие не указано явно, то по умолчанию создается событие propertyChange.

Тег [Bindable] используется в трех случаях:

1. Перед определением класса. В этом случае, для всех (только!) public свойств (и переменных, и установщиков) Flex автоматически генерирует событие propertyChange типа PropertyChangeEvent, и все эти свойства могут использоваться как источники связывания данных.
   [Bindable]
public class TextAreaFontControl extends TextArea {}
2. Перед public, protected, private свойствами, определенными как переменные.
   При изменении свойств, Flex автоматически генерирует событие propertyChange типа PropertyChangeEvent. Можно также указать другое имя события.
   [Bindable(event="fooChanged")]
public var foo:String;
3. Перед public, protected, private свойствами, определенными как установщики. Для того, чтобы свойство являлось источником связывания данных, необходимо чтобы были определены и set, и get методы.
   Если указан только set метод, создается свойство "только для записи" и его нельзя использовать в качестве источника связывания данных.
   Если же указан только get метод, создается свойство "только для чтения", которое можно использовать как источник связывания данных и без вставки метатега - аналогично переменным, определеных как const.
   При изменении свойств, Flex автоматически генерирует событие propertyChange типа PropertyChangeEvent. Можно также указать другое имя события.
   [Bindable]
public function set shortNames(val:Boolean):void { ... }
public function get shortNames():Boolean { ... }

ВАЖНО: Если после изменения, свойство не приобрело новое значение, Flex не генерирует событие. Проверка осуществляется по принципу (oldValue !== value).

ВАЖНО: Если свойство содержит ссылку на объект и эта ссылка заменяется на другую, то событие генерируется. Если же изменяется объект, на который ссылается свойство, событие генерироваться не будет.

Свойства read-only и static по-умолчанию являются источниками связывания данных.

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

// Define private variable.
private var _maxFontSize:Number = 15;

[Bindable(event="maxFontSizeChanged")]
// Define public getter method.
public function get maxFontSize():Number {
return _maxFontSize;
}

// Define public setter method.
public function set maxFontSize(value:Number):void {
if (value <= 30) {
_maxFontSize = value;
} else _maxFontSize = 30;
// Create event object.
var eventObj:Event = new Event("maxFontSizeChanged");
dispatchEvent(eventObj);
}

Работа с цепочками связываемых свойств.

Следующий пример показывает довольно длинную цепочку связываемых свойств:

<mx:Text id="myText" text="{user.name.firstName.text}"/>

Для того, чтобы механизм связывания данных поймал изменения свойства text, достаточно сделать свойство text связываемым. Однако, если необходимо присвоить новое значение какому-либо элементу цепочки на этапе выполнения, то все они должны быть связываемыми. С другой стороны, изменение любого из элементов приведет к неспособности механизма связывания отслеживать изменение свойства text.
В случае работы с такими цепочками, можно пользоваться методами BindingUtils.bindProperty() или BindingUtils.bindSetter() .
Пример использования bindProperty():

bindProperty(myText, 'text', user, ["name","firstName","text"]);

Здесь представлена цепочка в виде ["name","firstName","text"] относительно объекта user. При этом user не является элементом цепочки.
В MXML цепочка связываемых свойств всегда задается относительно this:

bindProperty(myText, 'text', this, ["user", "name","firstName","text"]);