Powerful control flow bindings for Knockout
if and ifnot bindings for control flow. The switch and case bindings provide a flexible and powerful control flow mechanism that can simplify your code.
html
Your order has been shipped. Your tracking number is .
Your order is being processed. Please be patient.
Your order could not be processed. Please go back and complete the missing data.
Please call customer service to determine the status of your order.
`
Here's an equivalent example using source data values:
`html
Your order has been shipped. Your tracking number is .
Your order is being processed. Please be patient.
Your order could not be processed. Please go back and complete the missing data.
Your order could not be processed. Please go back and complete the missing data.
`
A switch block can contain any number of case blocks. No more than one case block will be used. The contents of the remaining blocks will be cleared. Both switch and case take a single parameter. In most cases the values of the two parameters are matched against each other to determine which case block to use. The first block (top-down) to match is used; subsequent blocks are cleared. Here, in detail, is how the values are matched:
1. If the case value is the special value $else or $default, the block is used if no non-default blocks were used. There can be multiple blocks with $else or $default and they can be in any order.
1. If the switch value is boolean (true or false), each case value's "truthiness" is matched against the switch value.
1. If the case value is boolean (and the switch value is not boolean), the case value is used as is. The special variable $value can be used in a case expression to refer to the switch value. The block will be used if the expression is true.
1. If the case value is an array, the block will be used if the switch value matches (strict) an item in the array.
1. Otherwise, the block will be used if the case value matches the switch value (loose comparison).
If you want a block to be used based on the parameter not matching, you can use the casenot binding. This works similarly to case, except that the result of the value matching is reversed.
Here are some more examples. This example demonstrates items 1, 3, 4, and 5 above and uses container-less bindings:
`html
Value doesn't match
Value is foo
Value is bar
Value is either baz or qux
Value is a three-letter word
`
This example demonstrates item 2 (also see the second example above):
`html
You are ready!
You are not ready!
`
$3
You can use the case.visible and casenot.visible bindings to conditionally show an element. For example:
`html
You are ready!
You are not ready!
`
$3
When using Knockout 3.0+, you do not need to include the true value for the switch binding. For example:
`html
Value matched
Value didn't match
`
$3
ko.bindingHandlers.switch.makeCaseHandler can be used to create new bindings that control any UI aspect. It returns a new binding handler object that you should assign to a ko.bindingHandlers property. It takes three parameters:
* binding This is the name of the binding to wrap (case wraps the if binding, for example).
isNot (optional) If set to true*, the new binding will reverse the result of the value matching (like casenot).
* makeValueAccessor (optional) If the wrapped binding needs the value specified in a certain format, you can provide a function that accepts a value parameter and returns a valueAccessor function. The default looks like this:
function (value) { return function() { return value } }`