Wijmo UI for the Web
AngularJS and wijcombobox
Wijmo User Guide > AngularJS Directives > AngularJS and wijcombobox
Show All
Hide All

In this Angular getting started guide, you'll learn how to use the wijcombobox 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.20161.90.min.js" type="text/javascript"></script>
<script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20161.90.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.20161.90.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.       
    • We use a $scope parameter on the controller to control data context.
    • We create two scopes, the val scope sets the initial value to use.
    • The states scope provides the list of names and values for all of the states for the combobox.
    Script
    Copy Code 
    <script type="text/javascript">
    var app = angular.module("MyApp", ["wijmo"]);
    function MyController($scope) {
        $scope.val = "PA";
        $scope.states = [
            { name: "Alabama", value: "AL" },
            { name: "Alaska", value: "AK" },
            { name: "Arizona", value: "AZ" },
            { name: "Arkansas", value: "AR" },
            { name: "California", value: "CA" },
            { name: "Colorado", value: "CO" },
            { name: "Connecticut", value: "CT" },
            { name: "Delaware", value: "DE" },
            { name: "Florida", value: "FL" },
            { name: "Georgia", value: "GA" },
            { name: "Hawaii", value: "HI" },
            { name: "Idaho", value: "ID" },
            { name: "Illinois", value: "IL" },
            { name: "Indiana", value: "IN" },
            { name: "Iowa", value: "IA" },
            { name: "Kansas", value: "KS" },
            { name: "Kentucky", value: "KY" },
            { name: "Louisiana", value: "LA" },
            { name: "Maine", value: "ME" },
            { name: "Maryland", value: "MD" },
            { name: "Massachusetts", value: "MA" },
            { name: "Michigan", value: "MI" },
            { name: "Minnesota", value: "MN" },
            { name: "Mississippi", value: "MS" },
            { name: "Missouri", value: "MO" },
            { name: "Montana", value: "MT" },
            { name: "Nebraska", value: "NE" },
            { name: "Nevada", value: "NV" },
            { name: "New Hampshire", value: "NH" },
            { name: "New Jersey", value: "NJ" },
            { name: "New Mexico", value: "NM" },
            { name: "New York", value: "NY" },
            { name: "North Carolina", value: "NC" },
            { name: "North Dakota", value: "ND" },
            { name: "Ohio", value: "OH" },
            { name: "Oklahoma", value: "OK" },
            { name: "Oregon", value: "OR" },
            { name: "Pennsylvania", value: "PA" },
            { name: "Rhode Island", value: "RI" },
            { name: "South Carolina", value: "SC" },
            { name: "South Dakota", value: "SD" },
            { name: "Tennessee", value: "TN" },
            { name: "Texas", value: "TX" },
            { name: "Utah", value: "UT" },
            { name: "Vermont", value: "VT" },
            { name: "Virginia", value: "VA" },
            { name: "Washington", value: "WA" },
            { name: "West Virginia", value: "WV" },
            { name: "Wisconsin", value: "WI" },
            { name: "Wyoming", value: "WY" }];
        };
</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 ComboBox Quick Start.
    • We use a <wij-wijcombobox> directive to create the widget, and set several options as attributes within the element:
      • We set the dataSource option (data-source directive) to specify "states" from our controller.
      • We set the selectedValue option (selected-value directive) to specify "val" from our controller to set the value displayed initially in the combobox to Pennsylvania.
      • We set the dropDownHeight (drop-down-height) and dropDownWidth (drop-down-width) options.
    • We use nested elements in the markup to set the data, label, and value options.
      • Inside our data directive, we nest the label and value options.
      • We bind the data label to the "name" for each state specified in our controller.
      • We bind the data value to the "value" for each state specified in our controller.
    Markup
    Copy Code 
    <p><label id="output">Where do you live?</label></p>
<wij-combobox data-source="states" drop-down-height="150" drop-down-width="200" selected-value="val">
    <data>
        <label bind="name"></label>
        <value bind="value"></value>
    </data>
 </wij-combobox>
  5. 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
Getting Started with AngularJS

Reference

wijcombobox API
dataSource Option
dropdownHeight Option
dropdownWidth Option
selectedValue Option
data Option

Widgets

ComboBox Quick Start

 

 

Copyright © GrapeCity, Inc. All rights reserved.

Product Support Forum | Print this page