Are there conventions for linking to rows, columns, or cells in DITA tables?

In DITA XML, there are conventions for linking to specific rows, columns, or cells within tables to enhance the accessibility and usability of your content. These conventions allow you to create precise links that point to particular elements in a table. Let’s explore how this can be achieved:

1. Linking to Rows: To link to a specific row in a table, you can use the “id” attribute of the row element. Consider the following table containing software features:


<table>
  <tgroup>
    <tbody>
      <row id="feature1">
        <entry>Feature 1</entry>
        <entry>Description of Feature 1</entry>
      </row>
      <row id="feature2">
        <entry>Feature 2</entry>
        <entry>Description of Feature 2</entry>
      </row>
    </tbody>
  </tgroup>
</table>

To create a link to “Feature 1” from another topic, use this keyref:


<ph>For more details, see <keyword keyref="table.dita#feature1"/>.</ph>

2. Linking to Columns or Cells: While DITA’s conventions mainly focus on linking to rows, you can also create similar links for columns or individual cells using the “id” attribute associated with those specific elements. The same keyref approach can be applied.

By following these conventions, you can create precise links to rows, columns, or cells in DITA tables, ensuring that your audience can easily access the exact information they need within the table structures.