<refrange> (Reference Range) Description .email comment.
Description
This element contains a range of references of any of the reference element types:
<refrange>
  <citationref>...</citationref>
  <citationref>...</citationref>
</refrange>
The value of the text attribute captures the original formatting of the range in the text, so that the same formatting can be applied when the article is rendered (but does not include surrounding brackets):
See
<refrange text="19,20">
  <citationref linkend="CIT0019">19</citationref>
  <citationref linkend="CIT0020">20</citationref>
</refrange>.
See (19,20).
However, individual reference numbers are also usually found in the enclosed reference elements (as shown above), so that they can be displayed as hypertext links in an online publication to the individually referenced objects.
Parent Elements
The elements listed below may directly contain this element. They are "parent" elements. Elements in referenced groups are included, up to two levels of group nesting.
Model Diagram
The DTD model for this element:
--+(repeatable choice)
  |  
  |--+(choice) [Links from Text]
  |  |  
  |  |-- xref  -- (TEXT and elements)
  |  |  
  |  |-- chemeqnref  -- (TEXT and elements)
  |  |  
  |  |-- chemformref  -- (TEXT and elements)
  |  |  
  |  |-- matheqnref  -- (TEXT and elements)
  |  |  
  |  |-- tableref  -- (TEXT and elements)
  |  |  
  |  |-- citationref  -- (TEXT and elements)
  |  |  
  |  |-- figureref  -- (TEXT and elements)
  |  |  
  |  |-- suppmatref  -- (TEXT and elements)
  |  |  
  |  |-- listref  -- (TEXT and elements)
  |  |  
  |  |-- listitemref  -- (TEXT and elements)
  |  |  
  |  |-- chemstructureref  -- (TEXT and elements)
  |  |  
  |  |-- footnoteref  -- (TEXT and elements)
  |  |  
  |  |-- endnoteref  -- (TEXT and elements)
  |  |  
  |  |-- textref  -- (TEXT and elements)
  |  |  
  |  |-- enunciationref  -- (TEXT and elements)
DTD Definition
The DTD contains the following element and attribute definitions (note that embedded links are to definitions within the DTD page of this guide):
<!ELEMENT refrange                       (%LinksFromText;)+>
<!ATTLIST refrange
                display                  (popup | main | dropdown | other
                                          )  #IMPLIED 
                text                     CDATA  #REQUIRED 
               %a-group-CommonIDAttrs;>
.
Defined in DTD section Inline-level Content : Linking
General Attributes (shared with other elements)
Common Optional ID Attributes (a-group-CommonIDAttrs)
Local Attributes (defined for this element alone)
Attribute: display
Description
This attribute can be used to suggest how on an interactive application should present the range of links, and includes the values:
-
"popup" = pop-up small window
-
"main" = show in-line in main window
-
"dropdown" = show as a drop-down list if items in main window
-
"other" = do none of the above actions
There is no default value, so if the attribute is not used this can be taken as an indication that no preferenced have been made.
Specification
This attribute is not required. The allowed values are "popup", "main", "dropdown" and "other".
DTD Definition
                display                  (popup | main | dropdown | other
                                          )  #IMPLIED 
.
Attribute: text
Description
This attribute is used to hold the formatted text equivalent of the range, such as "13 to16" or "13-16" or "13, 14, 15 and 16". Its content may be used when rendering the article to reproduce the content as the author intended.
Specification
This attribute is required. It has text content.
DTD Definition
                text                     CDATA  #REQUIRED 
.