ObservableObject: reflectValues()

プロパティの状態を更新します。

構文

observableObject.reflectValues(valueMap)

引数

• valueMap: Object

  更新するプロパティ名と値の配列です。

例

ターゲットにプロパティ値を反映させない例です。

// 双方向を許可しない
const source = new ObservableObject({ output: "foo" }, false);

const target1 = Object.assign(Object.create(target_proto), { output: "" });
// 双方向を要求するが許可されていない
source.bindData(target1, true);

const target2 = Object.assign(Object.create(target_proto), { output: "" });
// 単方向を要求
source.bindData(target2, false);

// ターゲットは更新されない
target1.reflectValues({ output: "bar" });
// source.output  => foo
// target1.output => foo
// target2.output => foo

// ターゲットは更新されない
target2.reflectValues({ output: "bar" });
// source.output  => foo
// target1.output => foo
// target2.output => foo

// ターゲットが更新される
source.reflectValues({ output: "bar" });
// source.output  => bar
// target1.output => bar
// target2.output => bar

画面要素の値をソースに反映させる実装例です。

// ある ViewElement element のプロパティ prop_str を取得します
let value = element[prop_str];

// プロパティ prop_str を再割り当てします
Object.defineProperty(element, prop_str, {
    get() {
        return value;
    },
    set(newValue) {
        if (value != newValue) {
            this.source.reflectValues({ [this.id]: value });
        }
    },
});

解説

引数 valueMap のプロパティの中で、バインディングソースの同期対象となっているプロパティが valueMap のプロパティ値に更新されます。

この関数の呼び出しによってバインディングターゲットが実装する reflectValues() が呼び出されます。