先定義一個 ViewModel:
var AppViewModel = {
shouldShowMessage: ko.observable(true) // 初始化時 div 是 visible 的
};
AppViewModel.shouldShowMessage = ko.observable(false); // 現在隱藏了
ko.applyBindings(AppViewModel);
接著定義要控制的 UI 元素:
<div data-bind="visible: shouldShowMessage"> You will see this message only when "shouldShowMessage" holds a true value. </div>
執行後,這個 div 在初始化階段確實顯示,但因為隨後被重新賦值為 false,最終還是隱藏掉了。
當參數是假值(false、0、null、undefined 等),綁定會把元素的 style.display 設為 none,讓它隱藏。這個設定的優先級高於你在 CSS 裡定義的任何 display 樣式。
當參數是真值(true、非空的非 null 物件或陣列),綁定會移除元素的 style.display,讓元素恢復可見,此時你在 CSS 中自訂的 display 樣式才會重新生效。
如果參數是 observable 監控屬性,可見狀態會隨值變化而不斷更新;若不是,狀態只設定一次,之後不再變動。
<script type="text/javascript">
var AppViewModel = {
shouldShowMessage: ko.observable(true),
myValues: ko.observableArray([])
};
AppViewModel.shouldShowMessage = ko.observable(false);
AppViewModel.myValues.push("some value"); // 往陣列裡塞一筆資料
ko.applyBindings(AppViewModel);
</script>
頁面元素這樣綁定:
<div data-bind="visible: myValues().length > 0"> You will see this message only when 'myValues' has at least one member. </div>
於是當「some value」被推進 myValues 之後,myValues().length > 0 的結果變成 true,這個 div 就顯示出來了。這種寫法很適合做「列表非空才顯示提示」這類條件式 UI。