Ideal Image Slider - Captions Extension
Ideal Image Slider - Captions Extension
Adds captions support to the Ideal Image Slider.
Requirements
- Ideal Image Slider v1.3.0+
Usage
Captions are taken from the alt
attribute of the image tag or, if defined, the data-caption
attribute. The data-caption
attribute will override the alt
attribute. You can add an optional title to your caption which is taken from the title
attribute of the image tag.
While you can put HTML in the alt
attribute it is better to create an external caption in a separate div and put the selector in the data-caption
attribute (e.g. data-caption="#my-caption"
). Make sure and hide the external caption container so it is not visible on the page.
<div id="slider">
<img src="img/1.jpg" title="Baloons" alt="This is the caption content">
<img data-src="img/2.jpg" src="" title="Skateboard" alt="Captions <em>can</em> contain <strong>HTML</strong>">
<img data-src="img/3.jpg" src="" alt="This will be overridden" data-caption="#caption-3">
<img data-src="img/4.jpg" src="" title="A title without a caption" alt="">
</div>
<div id="caption-3" style="display:none;">
<h3>External Caption</h3>
<p>When using <a href="#">HTML in captions</a> it might be better to use an external caption.</p>
</div>
The iis-captions.js
must be included after ideal-image-slider.js
. The styles for the captions extension are included in the theme CSS.
<script src="ideal-image-slider.js"></script>
<script src="extensions/captions/iis-captions.js"></script>
<script>
var slider = new IdealImageSlider.Slider('#slider');
slider.addCaptions();
slider.start();
</script>