Value Converters
Xamarin + MvvmCross の話をします。
View と ViewModel とのバインディングを行う際に重要なのが Value Converters です。Converter を適切に導入することで、バインディングをすっきりさせることができます。
例えば、文字列を受け取って文字列の長さに変換する StringLength Value Converter を定義しておいて、次のようにバインディングする、といったことが可能です。
set.Bind(lengthLabel).To(vm => vm.HogeText).WithConversion("StringLength");
Visibility Converter
便利な Converter のひとつとして、Visibility Converter を紹介します。これは、MvvmCross プラグインのひとつ Visibility Plugin で提供されており、NuGet でインストールできます。
これは、ViewModel の値に応じて View のパーツの表示・非表示を切り替えたい場合に便利な Converter です。
具体例
iOS の場合を例に挙げます。ViewModel の string 型プロパティ HogeText が空文字列の場合に hogeButton を表示しないようにするには、以下のようにします。
set.Bind(hogeButton).For("Visibility").To(vm => vm.HogeText).WithConversion("Visibility");
どのような仕組みになっているか分解します。
-
For("Visibility")は、Visibility Plugin が提供しているUIViewへのバインディングです。-
MvxVisibility.Visibleを受け取った場合はUIViewのHiddenプロパティがfalseになります。 -
MvxVisibility.Collapsedを受け取った場合はUIViewのHiddenプロパティがtrueになります。
-
-
WithConversion("Visibility")は、各種のデータをMvxVisibilityに変換します。-
boolの値の場合は、trueをVisibleに、falseをCollapsedに変換します。 -
intの値の場合は、0 より大きな値をVisibleに変換します。 -
stringの値の場合は、nullでも空文字列でもなければVisibleに変換します。 - その他オブジェクトの場合は、
nullでなければVisibleに変換します。
-
注意点
For("Visibility") と WithConversion("Visibility")（または WithConversion("InvertedVisibility")）とはセットで使わなくてはいけません。
例えば、For(v => v.Hidden) と WithConversion("Visibility") とではバインディングできません。Converter が返す MvxVisibility は bool 値ではなく、Hidden プロパティに代入できないためです。
なお、厳密にはセットでなくても、自分で MvxVisibility 型のプロパティを定義してバインディングするのは可能です。