<figure> element is not necessary to display a
<media> element. Use
<figure> when you want to set your multimedia content apart from the surrounding text, add a title or caption, or create a numbered figure label for your media. If you just want your media to display inline, only use the
<media> element.The<Subfigure>Element
You can place two or more images within the same figure using the
subfigure tag. This is useful when you have two
related images that you want to display side-by-side or oneabove the other. The following CNXML snippet can be used to display two subfigures side-by-side:
<figure id="figure-2" orient="horizontal"><subfigure id="subfigure-1"><title>Blue on Blue</title><media id="sub_example" alt="An envelope with a blue page"><image mime-type="image/png" src="Xenvelope-blue-on-blue.png"/><caption>Subfigure 1.</caption></media></subfigure><subfigure id="subfigure-2"><title>Orange on White</title><media id="sub_example2" alt="An envelope with a white page"><image mime-type="image/png" src="Xenvelope.png"/><caption>Subfigure 2.</caption></media></subfigure><caption>Two images displayed horizontally in one figure.</caption></figure>
The resulting figure is displayed below:
Blue on blue
Orange on white
The optional
orient attribute determines how the subfigures are arranged
respective to one another. This attribute can have a value of either
horizontal (default) or
vertical . Modifying the previous example so that
orient="vertical" results in the following:
Blue on blue
Orange on white
Including alternate media for print
Connexions allows you to insert an alternate media file in your module that can be formatted and sizedspecifically for the print version of your content. For example, you may want to provide a color image for online use and a black-and-white image for print. You can also use this feature to provide alternatemedia types, such as using a Java applet for online use and an image for print.
To create an alternate image for print,
simply include two
image elements (or, say, a
video element and an
image element) inside the
media tag. Use the
for attribute to specify whether this element should be used for the online version, the
PDF version, or used as the default selection.
The following code gives one example for including an alternate
print image. In this case, online users will see
image.png , while
image.eps will be used for the print version of the module.
<figure id='printimage'><media id="print_image_example"><image mime-type='image/png' src='image.png'/><image mime-type='application/postscript' src='image.eps' for="pdf"/></media></figure>
Possible values for the
for attribute include:
- (Default) This element is used for both PDF and online versions unless another, version-specific element is present.
- This element is used only for the online version of the content.
- This element is used only for the pdf version of the content.
image.png ") is the default and will be automatically used for the online version of the content, while the second image ("
image.eps ") is explicitly assigned to the PDF version of the content. If no default had been specified, then no image would have appeared in the online version of the content.