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).



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


- topic/simpletable task/choicetable

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


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%.
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

Was this helpful?