Dados de Ligação e Opções de Configuração

context.binding

O objeto de ligação, se definido, fornece acesso a dados que é ligado a uma visualização. Existe no máximo uma ligação de dados declarados para cada visualização.

É possível acessar dados ligados a uma visualização usando a construção: this.context.binding.get("value"), em que value é um nome de propriedade especial que retorna a ligação de dados. Por exemplo, se uma visualização estiver ligada ao local.phoneBook.title, então a visualização pode obter o título da agenda de telefones da seguinte forma:

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

Ligando a tipos de dados simples e complexos

Para os tipos de dados simples, como cadeias e números, a estrutura de visualização detecta alterações dos dados e notifica automaticamente a visualização da alteração. Por exemplo, quando uma visualização é ligada ao tipo simples de sequência local.phoneBook.title, a função change() da visualização é chamada com um evento de mudança que especifica que o título foi alterado e seu novo valor. Todas as visualizações que estão ligadas a local.phoneBook.title são notificadas.

bind(path, callback, [scope])

Notifica a visualização por meio de retorno se uma propriedade especificada foi alterado. Escopo é um parâmetro opcional que especifica o escopo do contexto do retorno de chamada. Retorna uma manipulação para o retorno de chamada.

bindAll(callback, [scope])

Notifica a visualização por meio de retorno se qualquer propriedade no objeto foi alterado. Escopo é um parâmetro opcional que especifica o escopo do contexto do retorno de chamada. Retorna uma manipulação para o retorno de chamada.

Para a assinatura de retorno de chamada, consulte o tópico 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) { .....};

Ligando a um tipo de lista

Quando você ligar à uma lista, a visualização será automaticamente notificado quando o objeto Lista de toda a alterações. Por exemplo, considere que a visualização está ligada à lista local.phoneBook.person[]. Se uma nova lista de pessoas for criada e configurada para a ligação da visualização, por exemplo, usando a sintaxe do script de servidor tw.local.phoneBook.person = new tw.object.listOf.person();, a estrutura notifica automaticamente a visualização da alteração.

Ligando a lista de atualizações

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

Ligando a lista de propriedades

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

Acessando elementos da lista

Lista de operações

• Para incluir um objeto, use list.add(item). Por exemplo, this.context.binding.get("value").add(item)
• Para remover um objeto, use list.remove(index), por exemplo, this.context.binding.get("value").remove(0)
• Para substituir um objeto, use list.put(index, item). Por exemplo, this.context.binding.get("value").put(0, item)
• Para obter o comprimento de uma lista, use list.length().
• Para obter um elemento ou propriedade indexada da lista, use list.get(index | property). Consulte Acessando os elementos da lista anteriormente
• Para atualizar programaticamente a propriedade selecionada na lista, utilize list.set(property). Por exemplo, this.context.binding.get("value").set("listAllSelectedIndices", [1, 2, 3]);

Limpando recursos ligados

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);

}

Opções de configuração

Para serializar o objeto de ligação de dados para uma sequência JSON, é possível chamar a função toJson() no objeto de ligação de dados. Para obter um objeto JavaScript básico que represente a ligação de dados, é possível chamar toJSObject().