##### 3.2.2.15 choicetable

The <choicetable> element contains a series of optional choices available within a step of a task.

By default, processors should highlight the choice column is bold. To change the highlighting, set the keycol attribute of the <choicetable> tag to 0 (zero).

###### Contains

Doctype | Content model
ditabase, task, machineryTask, learningContent | ( (chhead) (optional) then (chrow) (one or more) )

###### Contained by

Doctype | Content model
ditabase, task (strict), task (general), machineryTask, learningContent | step

###### Inheritance

- topic/simpletable task/choicetable

    <step><cmd>Then this</cmd>
    <substeps>
    <substep importance="optional"><cmd>which is done by doing this</cmd></substep>
    <substep importance="required"><cmd>and then this.</cmd></substep>
    </substeps>
    <choicetable>
    <chhead>
    <choptionhd>Do something</choptionhd>
    <chdeschd>Or Else this</chdeschd>
    </chhead>
    <chrow><choption>Do this</choption>
    <chdesc>and this will happen</chdesc></chrow>
    <chrow><choption>Do that</choption>
    <chdesc>and that will happen</chdesc></chrow>
    </choicetable>
    </step>

###### Attributes

Name | Description | Data Type | Default Value | Required?
relcolwidth |
    A relative value to specify the width of a column in relationship to the width of the other columns. The values are totaled and made a percent. For example: relcolwidth="1* 2* 3*"
     causes widths of 16.7%, 33.3%, and 66.7%. relcolwidth="90* 150*" causes width of 37.5% and 62.5%.
| CDATA | #IMPLIED | No
keycol | Defines the column that will be used for row headings. By default, the first column is used. To indicate that no column in the table is the key column, set the attribute to 0. | NMTOKEN | 1 | No
refcols | The refcols attribute is currently undefined, and is reserved for future use. | NMTOKENS | #IMPLIED | No
spectitle | The specialized title attribute allows architects of specialized types to define a fixed or default title for a specialized element. Not intended for direct use by authors. | CDATA | #IMPLIED | No
display-atts attribute group (scale, frame, expanse) | A set of related attributes, described in 3.4.1.1 display-atts attribute group |  |  |
univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups) | A set of related attributes, described in 3.4.1.3 univ-atts attribute group |  |  |
global-atts attribute group (xtrf, xtrc) | A set of related attributes, described in 3.4.1.2 global-atts attribute group |  |  |
class, outputclass | Common attributes described in 3.4.1.9 Other common DITA attributes |  |  |

Previous Topic: 3.2.2.14 stepxmp

Next Topic: 3.2.2.16 chhead

Parent Topic: 3.2.2 Task elements

Sibling Topics:

3.2.2.1 task

3.2.2.2 taskbody

3.2.2.3 prereq

3.2.2.4 context

3.2.2.5 steps

3.2.2.6 steps-informal

3.2.2.7 steps-unordered

3.2.2.8 step

3.2.2.9 stepsection

3.2.2.10 cmd

3.2.2.11 info

3.2.2.12 substeps

3.2.2.13 substep

3.2.2.14 stepxmp

3.2.2.16 chhead

3.2.2.17 choptionhd

3.2.2.18 chdeschd

3.2.2.19 chrow

3.2.2.20 choption

3.2.2.21 chdesc

3.2.2.22 choices

3.2.2.23 choice

3.2.2.24 stepresult

3.2.2.25 tutorialinfo

3.2.2.26 result

3.2.2.27 postreq