ユーザー操作の選択肢を表形式で書く <choicetable>

ユーザーの操作指示が、条件によっていくつかに分かれる場合は、choicetable要素を用いて条件に応じた操作指示を記述します。

choicetable要素は、表形式でユーザー操作の選択肢を書くための要素です。table要素と同様に、必要に応じてヘッダ行(chhead要素)を設けることができます。choicetableは2列の表で、1列目(choption要素)に条件を、2列目(chdesc)に操作指示を書きます。

choicetable要素の記述例

<task id="execute_by_ant" xml:lang="ja-jp">
    :
  <taskbody>
    <prereq> ... </prereq>
    <context> ... </context>
    <steps>
       :
      <step>
        <cmd>サンプル文書をビルドするために、以下のコマンドを入力します。</cmd>
        <info><screen>C:\DITA-OT1.4.3&gt;<userinput>ant -f %DITA-OT%samples\ant_sample\<varname>sample_all.xml</varname></userinput></screen>出力形式ごとにビルドを行う場合は、出力形式に応じて<filepath><varname>sample_all.xml</varname></filepath>の代わりに以下のスクリプト・ファイルを指定します。</info>
        <choicetable>
          <chhead>
            <choptionhd>スクリプト・ファイル</choptionhd>
            <chdeschd>出力形式</chdeschd>
          </chhead>
          <chrow>
            <choption>sample_docbook.xml</choption>
            <chdesc>DocBook</chdesc>
          </chrow>
          <chrow>
            <choption>sample_eclipsehelp.xml</choption>
            <chdesc>Eclipse Help</chdesc>
          </chrow>
          <chrow>
            <choption>sample_htmlhelp.xml</choption>
            <chdesc>HTML Help</chdesc>
          </chrow>
          <chrow>
            <choption>sample_javahelp.xml</choption>
            <chdesc>JavaHelp</chdesc>
          </chrow>
          <chrow>
            <choption>sample_pdf.xml</choption>
            <chdesc>PDF</chdesc>
          </chrow>
          <chrow>
            <choption>sample_wordrtf.xml</choption>
            <chdesc>Word RTF</chdesc>
          </chrow>
          <chrow>
            <choption>sample_xhtml.xml</choption>
            <chdesc>XHTML</chdesc>
          </chrow>
        </choicetable>
      </step>
      :
    </steps>
    :
  </taskbody>
</task>