Wijmo UI for the Web
Quick Start
Wijmo User Guide > Widgets > SuperPanel > Quick Start

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

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

    Drop down and copy references to paste inside the head tags

    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.20183.140.min.css" rel="stylesheet" type="text/css" />
    
    <!--Wijmo Widgets JavaScript-->
    <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>
    <script src="http://cdn.wijmo.com/interop/wijmo.data.ajax.3.20183.140.js" type="text/javascript"></script>
     
    <!--Knockout JS Library-->
    <script src="http://cdn.wijmo.com/external/knockout-3.1.0.js" type="text/javascript"></script>
      
    <!--Wijmo Knockout Integration Library-->
    <script src="http://cdn.wijmo.com/interop/knockout.wijmo.3.20183.140.js" type="text/javascript"></script>
  3. Add the following markup within the <body> tags to create the widget. The <div> element creates the superpanel widget; its id option is set to 'superpanel', which we call in the jQuery script to initialize the widget. The nested <table> element sets up a table of images to display inside the superpanel. The width option is narrower than the table so that the scroll buttons appear.

    Drop down and copy markup to paste inside the body tags

                
    Markup
    Copy Code
    <div id="superpanel">
        <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><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/6/6f/So_cute_blush.svg/200px-So_cute_blush.svg.png"/>>
            </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><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/5/51/So_cute_draw.svg/200px-So_cute_draw.svg.png"/>>
            </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><img src="http://upload.wikimedia.org/wikipedia/commons/thumb/2/2a/So_cute_bot.svg/200px-So_cute_bot.svg.png"/>>
            </tr>
        </table>
    </div>
  4. Within the <head> tags, below the references, add the following script to initialize the widget and customize it.
    • The allowResize option is set to true so that users can grab an edge or corner of the superpanel and drag it to change the size.
    • The autoRefresh option is set 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.
    • The scrollMode options for both vertical and horizontal scrollers are set to appear as buttons that scroll when the user hovers the pointer over them.

    Drop down and copy script to paste inside the head tags

                
    Script
    Copy Code
    <script type="text/javascript">
       $(document).ready(function () {
          $("#superpanel").wijsuperpanel({
              allowResize: true,
              autoRefresh: true,
              hScroller: {
                    scrollMode: 'buttonshover'
                    },
              vScroller: {
                    scrollMode: 'buttonshover'
                    }
              });
    });
    </script>
  5. 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">
         #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. Click the scroller buttons to see the scrolling action.
See Also

KO

Reference