choicetable

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

By default, the highlighting of the choice column is bold. To change the highlighting, set the keycol attribute of the ChoiceTable tag to 0 (zero).

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

Contains

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

Contained by

Doctype Parents
ditabase, task step

Inheritance:

- topic/simpletable task/choicetable

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 Designates columns that contain references, and are candidates for automated linking. Columns are identified by a space-delimited list of numbers (for example: 1 3). 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; (scale, frame, expanse) A set of related attributes, described at %display-atts; parameter entity PE not applicable Not applicable
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;) A set of related attributes, described at %univ-atts; parameter entity PE not applicable Not applicable
%global-atts; (xtrf, xtrc) A set of related attributes, described at %global-atts; parameter entity PE not applicable Not applicable
class, outputclass Common attributes described in Other common DITA attributes.      

Return to main page.

OASIS DITA Language Specification v1.1 -- Committee Draft 13 February 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.