Quick Start

In this quick start, you'll learn how to add the LightBox widget to an HTML project using HTML markup and jQuery script.

To create a new HTML page in your favorite text editor, add the following code and save the document with an .html extension.
Drop down and copy markup
Paste in your favorite text editor.
Copy Code

<!DOCTYPE HTML> <HTML> <head> </head> <body> </body> </HTML>

Paste in your favorite text editor.	Copy Code
<!DOCTYPE HTML> <HTML> <head> </head> <body> </body> </HTML>

Add links to the dependencies to your HTML page within the <head> tags. Find the latest dependencies in the content delivery network (CDN) file at wijmo cdn.

References	Copy Code
<!--jQuery References--> <script src="http://code.jquery.com/jquery-1.11.1.min.js" type="text/javascript"></script> <script src="http://code.jquery.com/ui/1.11.0/jquery-ui.min.js" type="text/javascript"></script> <!--Theme--> <link href="http://cdn.wijmo.com/themes/aristo/jquery-wijmo.css" rel="stylesheet" type="text/css" /> <!--Wijmo Widgets CSS--> <link href="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20162.99.min.css" rel="stylesheet" type="text/css" /> <!--Wijmo Widgets JavaScript--> <script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20162.99.min.js" type="text/javascript"></script> <script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20162.99.min.js" type="text/javascript"></script> <script src="http://cdn.wijmo.com/interop/wijmo.data.ajax.3.20162.99.js" type="text/javascript"></script>

References

Copy Code

<!--jQuery References--> 
<script src="http://code.jquery.com/jquery-1.11.1.min.js" type="text/javascript"></script>
<script src="http://code.jquery.com/ui/1.11.0/jquery-ui.min.js" type="text/javascript"></script>

<!--Theme-->
<link href="http://cdn.wijmo.com/themes/aristo/jquery-wijmo.css" rel="stylesheet" type="text/css" />

<!--Wijmo Widgets CSS-->
<link href="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20162.99.min.css" rel="stylesheet" type="text/css" />

<!--Wijmo Widgets JavaScript-->
<script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20162.99.min.js" type="text/javascript"></script>
<script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20162.99.min.js" type="text/javascript"></script>
<script src="http://cdn.wijmo.com/interop/wijmo.data.ajax.3.20162.99.js" type="text/javascript"></script>

Add the following markup within the <body> tags to create the widget. The <div> element creates the widget, and we call its id attribute in jQuery to initialize it. The hyperlink and image elements set up the images to display.

Markup	Copy Code
<div id="lightbox1" class=""> <a href="Images/sports1.png" rel="wijlightbox[stock];player=img"> <img src="Images/sports1.png" title="Sports 1" alt="Lorem ipsum dolor sit amet, consectetur adipiscing elit." /></a> <a href="Images/sports2.png" rel="wijlightbox[stock];player=img"> <img src="Images/sports2.png" title="Sports 2" alt="Lorem ipsum dolor sit amet, consectetur adipiscing elit." /></a> <a href="Images/sports3.png" rel="wijlightbox[stock];player=img"> <img src="Images/sports3.png" title="Sports 3" alt="Lorem ipsum dolor sit amet, consectetur adipiscing elit." /></a> <a href="Images/sports4.png" rel="wijlightbox[stock];player=img"> <img src="Images/sports4.png" title="Sports 4" alt="Lorem ipsum dolor sit amet, consectetur adipiscing elit. " /></a> </div>

Markup

Copy Code

<div id="lightbox1" class="">
    <a href="Images/sports1.png" rel="wijlightbox[stock];player=img">
        <img src="Images/sports1.png" title="Sports 1" alt="Lorem ipsum dolor sit amet, consectetur adipiscing elit." /></a>
    <a href="Images/sports2.png" rel="wijlightbox[stock];player=img">
        <img src="Images/sports2.png" title="Sports 2" alt="Lorem ipsum dolor sit amet, consectetur adipiscing elit." /></a>
    <a href="Images/sports3.png" rel="wijlightbox[stock];player=img">
        <img src="Images/sports3.png" title="Sports 3" alt="Lorem ipsum dolor sit amet, consectetur adipiscing elit." /></a>
    <a href="Images/sports4.png" rel="wijlightbox[stock];player=img">
        <img src="Images/sports4.png" title="Sports 4" alt="Lorem ipsum dolor sit amet, consectetur adipiscing elit. " /></a>
</div>

Within the <head> tags, below the references, add the following script to initialize the widget and display buttons and controls, set the position of the controls, and display the selected image as a modal box (meaning that the page cannot be interacted with when an image is open).

Script	Copy Code
<script id="scriptInit" type="text/javascript"> $(document).ready(function () { $("#lightbox1").wijlightbox({ modal: true, controlsPosition: 'outside', ctrlButtons: 'play\|stop', dialogButtons: 'close\|fullsize' }); }); </script>

Script

Copy Code

<script id="scriptInit" type="text/javascript">
    $(document).ready(function () {
        $("#lightbox1").wijlightbox({
            modal: true,
            controlsPosition: 'outside',
            ctrlButtons: 'play|stop',
            dialogButtons: 'close|fullsize'
        });
    });   
</script>

Within the <head> tags, above the script to initialize the widget, set the size of the widget using CSS.
Drop down and copy markup to paste inside the head tags
Style
Copy Code

<style type="text/css"> #lightbox1 { width: 640px; } </style>
Save your HTML file and open it in a browser. The widget appears like the following live widget. Click an image to see it in larger size, with the alt text showing as caption text.

Style	Copy Code
<style type="text/css"> #lightbox1 { width: 640px; } </style>

KO

KO LightBox Binding

Reference

wijlightbox API