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