Wijmo UI for the Web
AngularJS and wijsuperpanel
Wijmo User Guide > AngularJS Directives > AngularJS and wijsuperpanel

In this Angular getting started guide, you'll learn how to use the SuperPanel widget 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.

  1. 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>
    
  2. 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.

    Drop down and copy references to paste inside the head tags

    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.20183.140.min.css" rel="stylesheet" type="text/css" />
    
    <!-- Wijmo Scripts -->
    <script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20183.140.min.js" type="text/javascript"></script>
    <script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20183.140.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.20183.140.min.js"></script>
  3. 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>
  4. Add the following markup within the <body> tags to create the widget. To see how this is done in jQuery without Angular, see SuperPanel Quick Start.
    • We use a <wij-superpanel> directive to create the widget, and set a couple of options as attributes within the element:
      • We set the allowResize option (allow-resize directive) to true so that when the user mouses over an edge of the widget, the cursor becomes a resize handle.
      • We set the autoRefresh option (auto-refresh directive) to true because images do not load until after the document ready function is completed. Since we did not specify heights for the images in the table, the vertical scroll buttons would not appear without autoRefresh.
    • We use nested elements in the markup to set up the scroll buttons and add content to the widget.
      • We nest vScroller and hScroller objects (v-scroller and h-scroller directives) and set the scrollMode option (scroll-mode directive) so that the vertical and horizontal scrollers show buttons that scroll the content on mouse hover.
      • We add a table that is wider than the size of the widget to show scrolling.
    Markup
    Copy Code
    <wij-superpanel id="superpanel" allow-resize="true" auto-refresh="true">
        <h-scroller scroll-mode="buttonshover"> </h-scroller>
        <v-scroller scroll-mode="buttonshover"> </v-scroller>
        <table style="background-color: rgb( 115, 59, 132 );" width="400" border="1">
            <tr>
                <td><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/9/95/So_cute_twinkle.svg/200px-So_cute_twinkle.svg.png"/></td>
                <td><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/6/6f/So_cute_blush.svg/200px-So_cute_blush.svg.png"/></td>
            </tr>
            <tr>
                <td><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/7/79/So_cute_masked.svg/200px-So_cute_masked.svg.png"/></td>
                <td><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/5/51/So_cute_draw.svg/200px-So_cute_draw.svg.png"/></td>
            </tr>
            <tr>
                <td><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/6/61/So_cute_talkative.svg/200px-So_cute_talkative.svg.png"/></td>
                <td><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/2/2a/So_cute_bot.svg/200px-So_cute_bot.svg.png"/></td>
            </tr>
        </table>
    </wij-superpanel>
  5. Within the <head> tags, above the script to initialize the widget, set the height and width of the superpanel using CSS.
    Style
    Copy Code
    <style type="text/css">
         #superpanel
        {
            width: 300px;
            height: 130px;
        }
    </style>
  6. 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.
See Also

Reference

Widgets