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
Note
These models represent only the default document types distributed by OASIS.
Actual content models will differ with each new document type.
| 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 display-atts attribute group | |||
| univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups) | A set of related attributes, described in univ-atts attribute group | |||
| global-atts attribute group (xtrf, xtrc) | A set of related attributes, described in global-atts attribute group | |||
| class, outputclass | Common attributes described in Other common DITA attributes |