Version dev

# `Switch`

Create an if-then-else construct. The test attribute of each `Case` commands is evaluated until it yields true. The contents of the Case gets executed. If no test succeeds, the (optional) `Otherwise` gets executed.

## Child elements

`Case`, `Otherwise`

## Parent elements

`A`, `AtPageCreation`, `AtPageShipout`, `B`, `Case`, `Color`, `Columns`, `Contents`, `Element`, `Fontface`, `ForAll`, `Frame`, `Function`, `I`, `Include`, `Layout`, `Li`, `Loop`, `NoBreak`, `Otherwise`, `Overlay`, `Paragraph`, `PlaceObject`, `Position`, `PositioningArea`, `Record`, `SavePages`, `Section`, `SetVariable`, `Span`, `Table`, `Tablefoot`, `Tablehead`, `Td`, `Text`, `Textblock`, `Tr`, `U`, `URL`, `Until`, `While`

## Attributes

(none)

## Example

    <Record element="data">
      <SetVariable variable="counter" select="3"/>
      <Switch>
        <Case test=" $counter &lt; 5">
          <SetVariable variable="text" select="'Less than 5'"/>
        </Case>
        <Case test=" $counter &lt; 20">
          <SetVariable variable="text" select="'Less than 20'"/>
        </Case>
        <Otherwise>
          <SetVariable variable="text" select="'Larger or equal to 20'"/>
        </Otherwise>
      </Switch>
      <PlaceObject>
        <Textblock>
          <Paragraph><Value select="$text"/></Paragraph>
        </Textblock>
      </PlaceObject>
    </Record>

## Info

You have to be careful to encode the test with the rules of XML: that is “less” must be written as `&lt;`, since `<` must not be part of text contents.

A Switch may be part of nearly all commands. It dissolves and only the contents of the Case or Otherwise gets replaced by the whole construct.

#### On this page