データのバインディングと構成オプション

ビジネス・オブジェクトのような複合データ型の場合、ビューが通知を受けるのはバインディング・オブジェクト自体が変更された場合に限られ、そのプロパティーやサブプロパティーが変更された場合には通知を受けません。 例えば、ストリングのような単純型ではなく、複合オブジェクト local.phoneBook にビューがバインドされているとします。 オブジェクト phoneBook は複数のプロパティーを持ち、その 1 つが title です。 この場合、title プロパティーが変更されても、change 関数は呼び出されません。これは、ビューが title プロパティーではなく phoneBook オブジェクトにバインドされているためです。 change 関数は、phoneBook オブジェクト全体が変更された場合のみ呼び出されます。 複合オブジェクトのプロパティーが変更されたかどうかをビューで認識する必要がある場合は、bind() 関数または bindAll() 関数を使用して、ビューをプロパティーに手動でバインドする必要があります。 構成オプションについても同じように、bind() 関数と bindAll() 関数を使用できることに注意してください。

以下の例では、複合オブジェクトのプロパティーを手動でバインドするためにビューの load イベント・ハンドラーに追加する可能性のあるコードを示します。

   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) { .....};

この例では、ビューは複合オブジェクトにバインドされています。このビューにより、binding.property1.property2 (これはストリング) が変更された場合に change ハンドラーが通知を受けるように設定されます。 また、property3 のサブプロパティーが変更された場合には、別の change ハンドラーが通知を受けるように設定されます。 どちらの場合も、change ハンドラーが呼び出されるスコープは、ビューの this スコープです。

エレメントが追加、削除、または置換されたときに通知を受けるには、bindAll() 関数を使用して、ビューを手動でバインドする必要があります。 以下のコード例では、リスト・エレメントが追加、削除、または置換されるたびに、ビューの listUpdated 関数が呼び出されます。

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

特殊なプロパティーの変更の通知を受け取る場合は、bind() 関数を使用して、個々のプロパティーにサブスクライブできます。 通常は、1 つの特殊プロパティーにサブスクライブするだけで十分です (つまり、すべての特殊プロパティーにサブスクライブする必要はありません)。 以下の例のコードをロード・イベント・ハンドラーに追加して、listAllSelectedIndices の値が変更されるたびに、ビューの indicesChanged 関数を呼び出すことができます。

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

リストは、単純型のコレクション、またはプロパティーを持つ複合オブジェクトのコレクションです。 リストからデータを取得するには、以下の表記を使用します。

• リスト・オブジェクトを取得するには get("value") を使用します。 例えば、次のとおりです。list = this.context.binding.get("value")
• 指標エレメントを取得するには get(index) を使用します。 例: list.get(0) は、最初のエレメントを取得します。
• プロパティーの値を取得するには get(property) を使用します。 例: list.get("listSelected") は、listSelected プロパティーの値を取得します。 その他のすべてのプロパティーの値を取得する場合も、同様の構文を使用します。
• リストの基礎となるエレメントを表す配列を取得するには items を使用します。 例えば、list.itemsです。 items によって返されるデータは、変更しないでください。

バインディングが必要なくなったら、バインドされたリソースを解放することができます。 それぞれの bind 関数または bindAll 関数は、バインディングのクリーンアップに使用できるハンドルを返します。 バインドされたリソースを解放するには、unload() イベント・ハンドラー内で行うか、またはバインディング・オブジェクト全体が変更されるたびに行う必要があります。 バインディング・データの変更が発生すると、ビューで手動バインディングを解放してから、もう一度 bind や bindAll を呼び出して context.binding オブジェクトに再バインドする必要があります。 例えば、change イベント・ハンドラーで以下のコードを追加します。

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

}

構成オプションは、バインディング・データと同じ方法でアクセスおよび更新されます。 例:

• ビューの事前定義オプションを取得するには、this.context.options._metadata.* を使用します。 例えば、ビューの可視性オプションを取得するには、this.context.options._metadata.visibility.get("value"); を使用します。
• ビューの事前定義オプションを設定するには、this.context.options._metadata.* を使用します。 例えば、ビューの可視性オプションの設定には、 this.context.options._metadata.visibility.set("value", newValue); を使用します。
• ユーザー定義の構成オプションを取得するには、this.context.options.myOption.get("value"); を使用します。myOption はオプション名です。
• ユーザー定義の構成オプションの設定には、 this.context.options.myOption.set("value", newValue); を使用します。ここで、 myOption はオプション名です。