Dane powiązania i opcje konfiguracyjne

context.binding

Obiekt powiązania, jeśli jest zdefiniowany, udostępnia dane powiązane z widokiem. Dla każdego widoku może być zdefiniowane maksymalnie jedno powiązanie danych.

Dostęp do danych powiązanych z widokiem można uzyskać przy użyciu konstrukcji: this.context.binding.get("value"), gdzie value jest specjalną nazwą właściwości zwracającą powiązanie danych. Jeśli na przykład widok jest powiązany z obiektem local.phoneBook.title, może on uzyskać tytuł książki telefonicznej w następujący sposób:

if (!! this.context.binding){
var title = this.context.binding.get("value")
}

Wiązanie z prostymi i złożonymi typami danych

W przypadku prostych typów danych, takich jak łańcuchy i liczby, środowisko widoku wykrywa zmiany danych i automatycznie powiadamia o nich widok. Jeśli na przykład widok jest powiązany z prostym typem łańcucha local.phoneBook.title, w przypadku zdarzenia zmiany określającego, że tytuł uległ zmianie i ma nową wartość, wywoływana jest funkcja change() widoku. Są o tym informowane wszystkie widoki powiązane z łańcuchem local.phoneBook.title.

bind(path, callback, [scope])

Powiadamia widok przy użyciu wywołania zwrotnego, jeśli określona właściwość uległa zmianie. Zasięg jest opcjonalnym parametrem, który określa zasięg kontekstu wywołania zwrotnego. Funkcja zwraca uchwyt do wywołania zwrotnego.

bindAll(callback, [scope])

Powiadamia widok przy użyciu wywołania zwrotnego, jeśli zmianie uległa jakakolwiek właściwość obiektu. Zasięg jest opcjonalnym parametrem, który określa zasięg kontekstu wywołania zwrotnego. Funkcja zwraca uchwyt do wywołania zwrotnego.

W przypadku sygnatury wywołania zwrotnego należy zapoznać się z tematem function (event) .

   var binding = this.context.binding.get("value");  //this is a complex object
   this.property2Handle = binding.bind("property1.property2", function(e) {some code}, this);
   this.property3Handle = binding.get("property3").bindAll(this.myBindAllChangeHandler, this);
   ......
   this.mybindAllChangeHandler(event) { .....};

Powiązanie z typem listy

W przypadku powiązania z listą widok jest powiadamiany automatycznie w przypadku zmiany całego obiektu listy. Na potrzeby tego przykładu założono, że widok jest powiązany z listą local.phoneBook.person[]. Jeśli zostanie utworzona nowa lista osób i zostanie ona ustawiona na powiązanie widoku, na przykład przy użyciu składni skryptu serwera tw.local.phoneBook.person = new tw.object.listOf.person();, środowisko automatycznie powiadamia widok o zmianie.

Powiązanie z aktualizacjami listy

var binding = this.context.binding.get("value"); //this is a List object
this.bindAllHandle = binding.bindAll(this.listUpdated, this);

Powiązanie z właściwościami listy

var binding = this.context.binding.get("value"); //this is a list
this.selectedIndicesHandle = binding.bind("listAllSelectedIndices", this.indicesChanged, this);

Uzyskiwanie dostępu do elementów listy

Operacje listy

• Aby dodać obiekt, należy użyć funkcji list.add(item). Na przykład: this.context.binding.get("value").add(item)
• Aby usunąć obiekt, należy użyć funkcji list.remove(index). Przykład: this.context.binding.get("value").remove(0)
• Aby zastąpić obiekt, należy użyć funkcji list.put(index, item). Na przykład: this.context.binding.get("value").put(0, item)
• Aby uzyskać długość listy, należy użyć funkcji list.length().
• Aby uzyskać indeksowany element lub właściwość listy, należy użyć funkcji list.get(index | property). Patrz sekcja Uzyskiwanie dostępu do elementów listy wcześniej.
• Aby programowo zaktualizować wybraną właściwość listy, należy użyć funkcji list.set(property). Na przykład: this.context.binding.get("value").set("listAllSelectedIndices", [1, 2, 3]);

Czyszczenie powiązanych zasobów

if (event.type != "config"){
var binding = this.context.binding.get("value"); //this is a list
	// assumes that this.selectedIndicesHandle was initialized in the load function
  this.selectedIndicesHandle.unbind();
this.selectedIndicesHandle = binding.bind("listAllSelectedIndices", this.indicesChanged, this);
	// assumes that this.selectedIndicesHandle was initialized in the load function
this.bindAllHandle.unbind();
this.bindAllHandle = binding.bindAll(this.listUpdated, this);

}

Opcje konfiguracyjne

Aby przekształcić obiekt danych powiązania do postaci szeregowej łańcucha JSON, należy wywołać funkcję toJson() na obiekcie powiązania danych. W celu pobrania podstawowego obiektu JavaScript reprezentującego powiązanie danych można wywołać funkcję toJSObject().