◇◆
<table-wrap> Table Wrapper
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.
Usage/Remarks
Table Content
This element has been designed to
capture a construct named “table”, whether that structure contains an
explicit <table> (or <oasis: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 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.
Design Note
Many 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.
JATS Table Processing Note
In building the
JATS table model from the XHTML model, the <caption> element was removed from within the <table> element, because, in the JATS Tag Suite, the <caption> element has been made part of the <table-wrap> element.
Attributes
Models and Context
May be contained in
<abstract>, <ack>, <answer>, <app>, <app-group>, <bio>, <body>, <book-app-group>, <boxed-text>, <disp-quote>, <explanation>, <fig>, <floats-group>, <glossary>, <index>, <index-div>, <index-group>, <legend>, <license-p>, <named-book-part-body>, <named-content>, <notes>, <option>, <p>, <question>, <question-preamble>, <ref-list>, <sec>, <styled-content>, <supplementary-material>, <table-wrap-group>, <toc>, <toc-div>, <toc-entry>, <toc-group>, <trans-abstract>
Description
The following, in order:
- <object-id> Object Identifier, zero or more
- <label> Label (of an Equation, Figure, Reference, etc.), zero or one
- <caption> Caption of a Figure, Table, etc., zero or one
- <legend> Legend, zero or more
- <contrib-group> Contributor Group, zero or more
- <abstract> Abstract, zero or more
- <kwd-group> Keyword Group, zero or more
- <subj-group> Subject Group, zero or more
- Any combination of:
- Accessibility Elements
- Linking Elements
- Any combination of:
- <disp-quote> Quote, Displayed
- <speech> Speech
- <statement> Statement, Formal
- <verse-group> Verse Form for Poetry
- Lists
- <alternatives> Alternatives For Processing
- <chem-struct-wrap> Chemical Structure Wrapper
- <code> Code
- <disp-formula> Formula, Display
- <graphic> Graphic
- <media> Media Object
- <preformat> Preformatted Text
- <table> Table (JATS table model)
- <xref> X (cross) Reference
- Any combination of:
- <table-wrap-foot> Table Wrapper Footer
- Ownership Elements
Content Model
<!ELEMENT table-wrap %table-wrap-model; >
Expanded Content Model
((object-id)*, label?, (caption)?, (legend)*, (contrib-group)*, (abstract)*, (kwd-group)*, (subj-group)*, (alt-text | long-desc | email | ext-link | uri)*, (disp-quote | speech | statement | verse-group | def-list | list | alternatives | chem-struct-wrap | code | disp-formula | graphic | media | preformat | table | xref)*, (table-wrap-foot | attrib | permissions)*)
Tagged Samples
With <label> and <caption>
...
<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>
...
With <caption>, <table>, and <table-wrap-foot>
...
<table-wrap id="bid.269">
<label>1</label>
<caption>
<title>Files on the taxonomy FTP site.</title>
</caption>
<table frame="box" rules="all" cellpadding="5">
<thead>
<tr>
<th align="left" valign="top">File</th>
<th align="left" valign="top">Uncompresses to</th>
<th align="left" valign="top">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left" valign="top">taxdump.tar.Z<xref ref-type="fn"
rid="mul2"><sup><italic>a</italic></sup></xref></td>
<td align="left" valign="top">readme.txt</td>
<td align="left" valign="top">A terse description of the
dmp files</td>
</tr>
<tr>
<td align="left" valign="top"></td>
<td align="left" valign="top">nodes.dmp</td>
<td align="left" valign="top">Structure of the database;
lists each taxid with its parent taxid, rank, and other
values associated with each node (genetic codes, etc.)</td>
</tr>
<tr>...</tr>
...
</tbody>
</table>
<table-wrap-foot>
<fn symbol="a" id="mul2">
<p>For non-UNIX users, the file taxdmp.zip includes the
same (zip compressed) data.</p>
</fn>
</table-wrap-foot>
</table-wrap>
...
With <contrib-group>
...
<table-wrap id="t5" position="float">
<label>Table 5</label>
<caption><title>Comparison of Popular Non-sporting Dogs for Size,
Disposition, and Other Characteristics</title></caption>
<contrib-group>
<contrib>
<name><surname>Lapeyre</surname>
<given-names>Deborah A.</given-names></name>
</contrib>
</contrib-group>
<table rules="cols">
<tbody>...</tbody>
</table>
</table-wrap>
...
@headers attribute
...
<table-wrap position="float" id="ch1.tab2" orientation="portrait">
<label>Table B</label>
<caption>...</caption>
<table frame="hsides" rules="groups">
<thead>
<tr>
<th headers="hd_h_ch1.tab2_1_1_1_1" id="hd_h_ch1.tab2_1_1_1_1"
valign="bottom" align="left" rowspan="2"
colspan="1">Bariatric Procedure</th>
<th id="hd_h_ch1.tab2_1_1_1_2" valign="bottom" align="center"
rowspan="1" colspan="4">Method of surgery</th>
</tr>
<tr>
<th headers="hd_h_ch1.tab2_1_1_1_2" id="hd_h_ch1.tab2_1_1_2_1"
valign="bottom" align="left" rowspan="1"
colspan="1">Open only</th>
<th headers="hd_h_ch1.tab2_1_1_1_2" id="hd_h_ch1.tab2_1_1_2_2"
valign="bottom" align="left" rowspan="1"
colspan="1">Laparoscopic only</th>
<th headers="hd_h_ch1.tab2_1_1_1_2" id="hd_h_ch1.tab2_1_1_2_3"
valign="bottom" align="left" rowspan="1"
colspan="1">Either open or laparoscopic</th>
<th headers="hd_h_ch1.tab2_1_1_1_2" id="hd_h_ch1.tab2_1_1_2_4"
valign="bottom" align="left" rowspan="1"
colspan="1">Not reported</th>
</tr>
</thead>
<tbody>
<tr>
<td headers="hd_h_ch1.tab2_1_1_1_1" valign="top"
align="left" rowspan="1" colspan="1">AGB</td>
<td headers="hd_h_ch1.tab2_1_1_1_2 hd_h_ch1.tab2_1_1_2_1"
valign="top" align="left" rowspan="1" colspan="1"/>
<td headers="hd_h_ch1.tab2_1_1_1_2 hd_h_ch1.tab2_1_1_2_2"
valign="top" align="left" rowspan="1" colspan="1">23</td>
<td headers="hd_h_ch1.tab2_1_1_1_2 hd_h_ch1.tab2_1_1_2_3"
valign="top" align="left" rowspan="1" colspan="1"/>
<td headers="hd_h_ch1.tab2_1_1_1_2 hd_h_ch1.tab2_1_1_2_4"
valign="top" align="left" rowspan="1" colspan="1">1</td>
</tr>
...
</tbody>
</table>
<table-wrap-foot>...</table-wrap-foot>
</table-wrap>
...
Related Resources
- For a discussion on the use of <table-wrap>, see Table, Table Wrapper, and Table Group.
- See: Hierarchy diagram - Table Wrapper