Tables

Tables should be tagged using the <table-wrap> element. The <table-wrap> element directly contains elements that hold information such as the table’s label, caption, accessibility text, and table footers. Within there are two table models available to capture tabular information: OASIS CALS Table Model and NISO JATS XHTML-based Table Model.

For new content that is being typeset the OASIS CALS Table Model should be used.

For content that is being converted from pre-existing XML, either table model can be used.

Footnotes should be placed in the <table-wrap-foot> element.

An @id attribute should be placed on the element.

All citations to a table using <xref> should point to the @id attribute on <table-wrap>.

Figures that are actually contain tables should be tagged tables.

Alternative text that describes the table for accessibility, if present, should be tagged in <alt-text> or <long-desc>. See the topic on Accessibility for more information.

Headers within a table should be tagged to support both display of the table and use of screen readers for accessibility. Headers in a table are cells that contain labels that describe the data in the table. A good way to determine whether a cell should be tagged as a header is to ask if the table were divided by a page break would it make sense to repeat the cell where the table continues after the page break. Headers for columns should be tagged using <oasis:thead>. The OASIS CALS Table Model does not provide an element or attribute to identify other headers within a table, so the JATS attribute @specific-use should be used to identify other headers that are not inside an <oasis:thead> element. Any cell in a table can be identified as a header by adding a @specific-use attribute to a child element within the <oasis:entry> element. The value of the @specific-use attribute should be one of the following values which are aligned with the HTML5 @scope attribute.

  • row-header - the cell acts as a header for cells in the same row.
  • rowgroup-header - the cell acts as a header for cells in the same row group.
  • col-header - the cell acts as a header for cells in the same column.
  • colgroup-header - the cell acts as a header for cells in the same column group.

For example, cell that is a row header can be tagged like one of the following examples:

<oasis:entry><bold specific-use="row-header">label text</bold></oasis:entry>

<oasis:entry><italic specific-use="row-header">label text</italic></oasis:entry>

<oasis:entry><styled-content specific-use="row-header">label text</styled-content></oasis:entry>

Examples

Example of table footnote tagged correctly.

<table-wrap> 
… 
<table-wrap-foot> <fn><label><sup>1</sup></label>
<p>DSC-affiliated physicians, now working 
elsewhere.</p></fn> 
<fn><p><sup>2</sup> Behaviorist, exercise specialist, dietician.< <p>&#x002A; Note: Percentages are rounded and may not always add to 100%</p></fn> 
</table-wrap> 

<table-wrap id="t0008" orientation="portrait" position="float"> 
    <label>Table 5.</label> 
    <caption><p>Number of substances involved in human exposure cases.</p></caption> 
    <oasis:table frame="topbot"> 
        <oasis:tgroup cols="5"> 
            <oasis:colspec colnum="1" colname="col1" colwidth="80pt"/> 
            <oasis:colspec colnum="2" colname="col2" colwidth="80pt"/> 
            <oasis:colspec colnum="3" colname="col3" colwidth="80pt"/> 
            <oasis:colspec colnum="4" colname="col4" colwidth="80pt"/> 
            <oasis:colspec colnum="5" colname="col5" colwidth="80pt"/> 
            <oasis:thead> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left"></oasis:entry> 
                    <oasis:entry namest="col2" nameend="col3" rowsep="1" align="center">Human exposures</oasis:entry> 
                    <oasis:entry namest="col4" nameend="col5" rowsep="1" align="center">Fatal exposures<xref ref-type="table-fn" rid="TF16"><sup>a</sup></xref></oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">No. of Substances</oasis:entry> 
                    <oasis:entry colname="col2" align="center"><italic>N</italic></oasis:entry> 
                    <oasis:entry colname="col3" align="center">&#x0025;</oasis:entry> 
                    <oasis:entry colname="col4" align="center"><italic>N</italic></oasis:entry> 
                    <oasis:entry colname="col5" align="center">&#x0025;</oasis:entry> 
                </oasis:row> 
            </oasis:thead> 
            <oasis:tbody valign="top"> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">1</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">1,858,385</oasis:entry> 
                    <oasis:entry colname="col3" align="right">87.86</oasis:entry> 
                    <oasis:entry colname="col4" align="right">598</oasis:entry> 
                    <oasis:entry colname="col5" align="right">43.08</oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">2</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">159,710</oasis:entry> 
                    <oasis:entry colname="col3" align="right">7.55</oasis:entry> 
                    <oasis:entry colname="col4" align="right">327</oasis:entry> 
                    <oasis:entry colname="col5" align="right">23.56</oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">3</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">53,855</oasis:entry> 
                    <oasis:entry colname="col3" align="right">2.55</oasis:entry> 
                    <oasis:entry colname="col4" align="right">214</oasis:entry> 
                    <oasis:entry colname="col5" align="right">15.42</oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">4</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">22,485</oasis:entry> 
                    <oasis:entry colname="col3" align="right">1.06</oasis:entry> 
                    <oasis:entry colname="col4" align="right">97</oasis:entry> 
                    <oasis:entry colname="col5" align="right">6.99</oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">5</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">9,764</oasis:entry> 
                    <oasis:entry colname="col3" align="right">0.46</oasis:entry> 
                    <oasis:entry colname="col4" align="right">74</oasis:entry> 
                    <oasis:entry colname="col5" align="right">5.33</oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">6</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">4,814</oasis:entry> 
                    <oasis:entry colname="col3" align="right">0.23</oasis:entry> 
                    <oasis:entry colname="col4" align="right">24</oasis:entry> 
                    <oasis:entry colname="col5" align="right">1.73</oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">7</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">2,504</oasis:entry> 
                    <oasis:entry colname="col3" align="right">0.12</oasis:entry> 
                    <oasis:entry colname="col4" align="right">22</oasis:entry> 
                    <oasis:entry colname="col5" align="right">1.59</oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">8</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">1,427</oasis:entry> 
                    <oasis:entry colname="col3" align="right">0.07</oasis:entry> 
                    <oasis:entry colname="col4" align="right">9</oasis:entry> 
                    <oasis:entry colname="col5" align="right">0.65</oasis:entry> 
                </oasis:row>
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">&#x003E;&#x2009;&#x003D;9</oasis:entry> 
                    <oasis:entry colname="col2" align="char" char=".">2,242</oasis:entry> 
                    <oasis:entry colname="col3" align="right">0.11</oasis:entry> 
                    <oasis:entry colname="col4" align="right">23</oasis:entry> 
                    <oasis:entry colname="col5" align="right">1.66</oasis:entry> 
                </oasis:row> 
                <oasis:row> 
                    <oasis:entry colname="col1" align="left">Total</oasis:entry> 
                    <oasis:entry colname="col2" align="left">2,115,186</oasis:entry> 
                    <oasis:entry colname="col3" align="right">100.00</oasis:entry> 
                    <oasis:entry colname="col4" align="right">1,388</oasis:entry> 
                    <oasis:entry colname="col5" align="right">100.00</oasis:entry> 
                </oasis:row> 
            </oasis:tbody> 
        </oasis:tgroup> 
    </oasis:table> 
    <table-wrap-foot> <fn id="TF16"><label><sup>a</sup></label><p>Includes cases with RCF of 1-Undoubtedly responsible, 2-Probably responsible, or 3-Contributory. This excludes reports with outcome of Death INDIRECT.</p></fn> 
    </table-wrap-foot>