<fig>

Figure

Block of graphical or textual material that is identified as a figure, usually bearing a caption and a label such as “Figure 3.” or “Figure”.

Remarks

A <fig> is defined as an element that would appear in the Table of Figures, if there were one.
Related Resource: For a discussion on the use of <fig>, see Figures and Graphics.
Usage: The content of a <fig> need not be graphical in nature; the content of a figure may be a graphic, a list, several paragraphs, an equation, a display quote, a table, etc., or a mixture of several of these.
Position: The @position attribute may be used to indicate whether this element 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.
Best Practice: Tag unlabeled graphics as <graphic> elements rather than as <fig> elements. A common test to determine if an object is a <fig> versus a <graphic> is to ask, “If there were a “List of Figures” for this document, should this object appear in that list?”
Associating Supplementary Data with a Figure: When the data (such as a spreadsheet or dataset) associated with a document has been described using a <supplementary-material> element, then a figure can use an internal <xref> to point to that <supplementary-material>. This provides a mechanism to expose the data behind the figure. For example, assume that a figure (<fig>) is associated with three pieces of supplementary material (each described in a <supplementary-material> element). Three cross references (<xref>) can be embedded in the figure tagging to associate the figure with all three supplementary items, which may be datasets, additional figures, spreadsheets, etc.

Attributes

fig-type Type of Figure
id Document Internal Identifier
orientation Orientation
position Position
specific-use Specific Use
xml:base Base
xml:lang Language

Content Model

<!ELEMENT  fig          %fig-model;                                  >

Expanded Content Model

((object-id)*, (caption)?, (alt-text | long-desc)*, (disp-formula | disp-formula-group | chem-struct-wrap | disp-quote | speech | statement | verse-group | table-wrap | p | def-list | list | code | graphic | media | preformat | xref)*, attrib?, permissions?)

Description

The following, in order:

This element may be contained in:

<answer>, <app>, <bio>, <body>, <boxed-text>, <explanation>, <license-p>, <named-content>, <option>, <p>, <question>, <question-preamble>, <sec>, <styled-content>

Example 1

A simple captionless figure with a graphic:
... 
<fig id="f1" orientation="portrait" position="float">
<graphic xlink:href="f1"/>
<attrib>Brookhaven National Laboratory</attrib>
</fig>
...

Example 2

A labeled, captioned figure with a graphic:
... 
<fig id="f8" orientation="portrait" position="float">
<caption>
<p>Time difference between events F and A as a function of the 
length of entering plug for bifurcations B to BXXX, where X stands 
for 0 or 1.</p>
</caption>
<graphic orientation="portrait" position="float" xlink:href="f8"/>
</fig>
...

Example 3

A more complex figure with a graphic:
...
<sec sec-type="results">
<title>Results</title>
<p>We identified 703 abstracts, of which 687 were 
not relevant ... Details of randomisation procedures,
treatment schedules, and numbers of patients followed
up are given on the <italic>BMJ</italic> website.</p>
<fig id="F1">
<caption>
<title>Deaths among patients receiving day hospital care
or alternative services.</title>
<p>Odds ratios of death by end of follow up were calculated by 
fixed effects model. Heterogeneity between trials is presented as
&#x03C7;<sup>2</sup></p>
</caption>
<alt-text>Deaths in hospitals or with alternative services</alt-text>
<graphic xmlns:xlink="http://www.w3.org/1999/xlink"
xlink:href="fors2662.f1">
<object-id>456472</object-id>
</graphic>
</fig>
...
</sec>
...

Article Authoring Tag Library NISO JATS Version 1.3d1 (ANSI/NISO Z39.96-2019)

Version of October 2019

Back to Top