Language reference : Technical content architecture : Task elements : choicetable
   
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
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