AngularJS and wijcarousel

In this Angular getting started guide, you'll learn how to use the wijcarousel in an HTML project using HTML markup, jQuery script, and AngularJS directives.

For more complex samples that have the controller and model in separate files, see the AngularJS Directive Gallery on our web site.

To create a new HTML page in your favorite text editor, add the following code and save the document with an .html extension. Notice that the <HTML> and <body> tags are different from our usual tags.
- The <HTML> tag is marked as an Angular app with the ng-app directive, in our script, we will specify that it uses Wijmo.
- The <body> tag is used to define the scope of the Angular controller that we create. You can use another tag such as a <div> for the scope, but for our purposes, we will use the entire body. The ng-controller directive specifies the controller to use within this scope.
Drop down and copy markup
Paste in your favorite text editor.
Copy Code

<!DOCTYPE HTML> <HTML ng-app="MyApp"> <head> </head> <body ng-controller="MyController"> </body> </HTML>

Paste in your favorite text editor.	Copy Code
<!DOCTYPE HTML> <HTML ng-app="MyApp"> <head> </head> <body ng-controller="MyController"> </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. Along with our usual references, we add two script references for Angular that must come after the jQuery references, so they are the last two lines:

One is for AngularJS itself.
The other is for Wijmo's Angular javascript integration library.

References	Copy Code
<!-- jQuery --> <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js" type="text/javascript"></script> <script src="https://ajax.googleapis.com/ajax/libs/jqueryui/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 Scripts --> <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> <!-- Angular --> <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/angularjs/1.2.0/angular.min.js"></script> <script src="http://cdn.wijmo.com/interop/angular.wijmo.3.20162.99.min.js"></script>

References

Copy Code

<!-- jQuery -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js" type="text/javascript"></script>
<script src="https://ajax.googleapis.com/ajax/libs/jqueryui/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 Scripts -->
<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>

<!-- Angular -->
<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/angularjs/1.2.0/angular.min.js"></script>
<script src="http://cdn.wijmo.com/interop/angular.wijmo.3.20162.99.min.js"></script>

Within the <head> tags, below the references, add the following script to set the app to use Wijmo, and to create a simple controller with a $scope parameter to control data context.
Script
Copy Code
<script type="text/javascript"> var app = angular.module("MyApp", ["wijmo"]); function MyController($scope) {} </script>

Script	Copy Code
<script type="text/javascript"> var app = angular.module("MyApp", ["wijmo"]); function MyController($scope) {} </script>

Add the following markup within the <body> tags to create the widget. To see how this is done in jQuery without Angular, see Quick Start.

We use a <wij-carousel> directive to create the widget, and set several options as attributes within the element:
- We set the display option to "1" so that one image shows in the view area at a time.
- We set the showTimer option (show-timer directive) to true so that users can see how much time is left before the image changes when playing.
- We set the showPager option (show-pager directive) to true so that users can see the page turner buttons.
- We set the loop option to true to play images continuously when the end of the list of images is reached.
- We set the showControlsOnHover option (show-controls-on-hover directive) to true so that the control buttons disappear when the mouse is away from that area.
- We set the style attribute to control the height and width of the widget.
We use nested elements in the markup to set the images and captions in an unordered list.
- The <ul> element creates the list.
- The <li> elements create each item to display in the carousel.
- Nested inside each item is an image and a span for the image caption.

Markup	Copy Code
<wij-carousel display="1" show-timer="true" show-pager="true" loop="true" show-controls-on-hover="true" style="width:600px; height:300px;"> <ul> <li> <img src="Images\sports1.png" alt="Sports 1" /> <span>Word Caption 1</span></li> <li> <img src="Images\sports2.png" alt="Sports 2" /> <span>Word Caption 2</span></li> <li> <img src="Images\sports3.png" alt="Sports 3" /> <span>Word Caption 3</span></li> <li> <img src="Images\sports4.png" alt="Sports 4" /> <span>Word Caption 4</span></li> <li> <img src="Images\sports5.png" alt="Sports 5" /> <span>Word Caption 5</span></li> <li> <img src="Images\sports7.png" alt="Sports 6" /> <span>Word Caption 6</span></li> <li> <img src="Images\sports6.png" alt="Sports 7" /> <span>Word Caption 7</span></li> <li> <img src="Images\sports4.png" alt="Sports 8" /> <span>Word Caption 8</span></li> </ul> </wij-carousel>

Markup

Copy Code

<wij-carousel display="1" show-timer="true" show-pager="true" loop="true" show-controls-on-hover="true" style="width:600px; height:300px;">
  <ul>
    <li>
        <img src="Images\sports1.png" alt="Sports 1" />
        <span>Word Caption 1</span></li>
    <li>
        <img src="Images\sports2.png" alt="Sports 2" />
        <span>Word Caption 2</span></li>
    <li>
        <img src="Images\sports3.png" alt="Sports 3" />
        <span>Word Caption 3</span></li>
    <li>
        <img src="Images\sports4.png" alt="Sports 4" />
        <span>Word Caption 4</span></li>
    <li>
        <img src="Images\sports5.png" alt="Sports 5" />
        <span>Word Caption 5</span></li>
    <li>
        <img src="Images\sports7.png" alt="Sports 6" />
        <span>Word Caption 6</span></li>
    <li>
        <img src="Images\sports6.png" alt="Sports 7" />
        <span>Word Caption 7</span></li>
    <li>
        <img src="Images\sports4.png" alt="Sports 8" />
        <span>Word Caption 8</span></li>
  </ul>
 </wij-carousel>

Save your HTML file and open it in a browser. The widget appears like the following live widget.

MISSING WIDGET TYPE: The "Live Widget" Widget Type could not be found. The "Live Widget" Widget Type may have been deleted since this Widget was created.

Reference

showControlsOnHover Option

Widgets

Carousel Quick Start