Wrapper element for a complete table, including the tabular material (rows and columns), caption (including title), footnotes, and alternative descriptions of the table for purposes of accessibility.
Table Content: This element has been designed to capture a construct named “table”, whether that structure contains an explicit <table> element or contains non-tabular structures such as graphics, lists, or paragraphs. Many publishers associate table captions and table numbers with material that is not explicitly tabular. Within the <table-wrap> element, row and column tags that describe the table cells should be defined by either the <table> element of the NISO JATS table model (based on and designed to be converted easily to the XHTML 1.1 table model) or, less typically, by the OASIS XML Exchange (CALS) table model.
Related Essay: For a discussion on the use of <table-wrap>, see Table, Table Wrapper, and Table Group.
Design Note: Many journal Tag Sets use an element called “Table Footnote” (with a tag such as <tblfn>) for footnotes inside a table. This Tag Set uses <fn> inside tables, as well as everywhere else, relying instead on context to differentiate table footnotes. Footnotes inside a <table-wrap> are assumed to be footnotes to the table and, as part of the table, are displayed at the bottom of the table, usually as part of the <table-wrap-foot>, rather than at the bottom of the page or otherwise separated from the display of the table.
Position: The @position attribute may be used to indicate whether a <table-wrap> must be anchored at its exact location within the text or whether it may float, for example, to the top of the next page, into the next column, to the end of a logical file, or within a separate window.
NISO JATS Table Processing Note: In building the NISO JATS table model from the XHTML model, the <caption> element was removed from within the <table> element, because, in the NISO JATS Tag Suite, the <caption> element has been made part of the <table-wrap> element.
<!ELEMENT table-wrap %table-wrap-model; >
((object-id)*, label?, (caption)?, (abstract)*, (kwd-group)*, (alt-text | long-desc | email | ext-link | uri)*, (disp-quote | speech | statement | verse-group | def-list | list | alternatives | chem-struct-wrap | code | graphic | media | preformat | table)*, (table-wrap-foot | attrib | permissions)*)
The following, in order:
<abstract>, <ack>, <app>, <app-group>, <bio>, <body>, <boxed-text>, <disp-quote>, <fig>, <floats-group>, <glossary>, <license-p>, <named-content>, <notes>, <p>, <ref-list>, <sec>, <styled-content>, <supplementary-material>, <table-wrap-group>, <trans-abstract>
A table wrapper containing the label and caption for a <table>:
...
<table-wrap id="t2" orientation="portrait" position="float">
<label>Table II.</label>
<caption>
<p>Models to approximate the bound frequencies as waves
in X→M (<inline-graphic id="g1" xlink:href="d1"/>: Rotational,
<inline-graphic id="g2" xlink:href="d2"/>: Vibrate in <italic>y</italic>
direction, <inline-graphic id="g3" xlink:href="d3"/>: Vibrate in
<italic>x</italic> direction, <inline-graphic id="g4" xlink:href="d4"/>:
Vibrate mainly in <italic>y</italic> direction including a small
portion of vibration in <italic>x</italic> direction,
<inline-graphic id="g5" xlink:href="d5"/>: Vibrate mainly in
<italic>x</italic> direction including a small portion of vibration
in <italic>y</italic> direction).</p>
</caption>
<table border="1">...</table>
</table-wrap>
...
A table wrapper showing the interior table:
...
<table-wrap id="TN0.170">
<caption>
<title>Patient Care at End of Follow Up</title>
<p>Numbers of patients receiving institutional care at
the end of scheduled follow up and use of hospital beds
among those allocated to day hospital or alternative
services</p>
</caption>
<table>
<tbody>
<tr>
<th></th>
<th colspan="3" align="center"
rowspan="1">Institutional care</th>
<th></th>
<th colspan="2" align="center"
rowspan="1"> Bed use (days)</th>
</tr>
<tr>
<td colspan="3"><hr/></td>
<td colspan="2"><hr/></td>
</tr>
<tr><th>Control group</th>
<th align="center">Day hospital</th>
<th align="center">Control</th>
<th align="center">Odds ratio (95% CI)</th>
<th></th>
<th></th>
<th align="center">Day hospital</th>
<th align="center">Control</th>
</tr>
<tr>
<td colspan="7"><hr/></td></tr>
<tr>
<td>Comprehensive care (5 trials)</td>
<td align="center">151/597<xref ref-type="table-fn"
rid="TF1-150"></xref></td>
<td align="center">159/584</td>
<td align="center">0.91 (0.70 to 1.19)</td>
<td></td>
<td align="center">20.5</td>
<td align="center">21.4</td></tr>
<tr>
<td>Domiciliary care (4 trials)</td>
<td align="center">20/216</td>
<td align="center"> 19/227</td>
<td align="center">1.61 (0.30 to 8.55)</td>
<td></td>
<td align="center"> 7.7</td>
<td align="center">11.1</td>
</tr>
<tr>
<td>No comprehensive care (3 trials)</td>
<td align="center">37/411</td>
<td align="center"> 66/403</td>
<td align="center">0.50<xref ref-type="table-fn"
rid="TF1-151"></xref> (0.26 to 0.96)</td>
<td></td>
<td align="center">11.2</td>
<td align="center">11.7</td>
</tr>
<tr>
<td>Total</td>
<td align="center">208/1224</td>
<td align="center">244/1214</td>
<td align="center">0.77 (0.52 to 1.13)</td>
<td></td>
<td align="center">15.0</td><td align="center">16.4</td>
</tr>
</tbody>
</table>
<table-wrap-foot>
<fn-group>
<fn id="TF1-150"><p>Data not available for 1 trial.</p></fn>
<fn id="TF1-151"><p>P<0.05 (random effects model).</p></fn>
</fn-group>
</table-wrap-foot>
</table-wrap>
...
JATS-display1.ent