AngularJS and wijlinechart

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

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>

Within the <head> tags, below the references, add the following script to set the app to use Wijmo, and to create a model and controller.

We use a model to specify four data fields that we link to data supplied in the controller.
We use a $scope parameter on the controller to control data context for the model
We add an optional $locale parameter on the controller.
We add three data rows to the list in the controller.

To see how this is done in jQuery without Angular, see Data Binding (the Multi-Series Chart with Different Data Members section).

Script	Copy Code
<script type="text/javascript"> var app = angular.module("MyApp", ["wijmo"]); //Region class function Region(data) { this.RegionName = data.RegionName; this.Desktops = data.Desktops; this.Notebooks = data.Notebooks; this.Tablets = data.Tablets; }; function MyController($scope, $locale) { $scope.list = [ new Region( { RegionName: "West", Desktops: 5, Notebooks: 3, Tablets: 7 }), ({ RegionName: "Central", Desktops: 1, Notebooks: 6, Tablets: 8 }), ({ RegionName: "East", Desktops: 2, Notebooks: 4, Tablets: 3 }) ]; } </script>

Script

Copy Code

<script type="text/javascript">
    var app = angular.module("MyApp", ["wijmo"]);
    //Region class
    function Region(data) {
        this.RegionName = data.RegionName;
        this.Desktops = data.Desktops;
        this.Notebooks = data.Notebooks;
        this.Tablets = data.Tablets;
    };
    function MyController($scope, $locale) {
        $scope.list = [
            new Region(
                {
                    RegionName: "West", 
                    Desktops: 5,
                    Notebooks: 3,
                    Tablets: 7
                }),
                ({
                    RegionName: "Central", 
                    Desktops: 1,
                    Notebooks: 6,
                    Tablets: 8
                }),
                ({
                    RegionName: "East", 
                    Desktops: 2,
                    Notebooks: 4,
                    Tablets: 3
                })
        ];
    }
</script>

Add the following markup within the <body> tags to create the widget.

We use a <wij-LineChart> directive to create the widget, and set several options as attributes within the element:
- We set the dataSource option (data-source directive) to specify the "list" from our controller.
- We set the height and width options.
- We set the showChartLabels option (show-chart-labels directive) to false.
We use nested elements in the markup to set the axis, data, header, and seriesList options.
- Inside our axis directive, we nest the y axis, and set the origin option to zero.
- We set the x bind attribute of the data directive to bind to our RegionName field here so it applies to all series in the series list.
- We set the header text to show the title for the chart.
- Inside our series-list directive, we nest each series with a label for the hint (tooltip text) and legend, and a data directive with nested y options that bind to the data fields in the model.

Markup	Copy Code
<wij-linechart data-source="list" height="400" width="600" show-chart-labels="false"> <axis> <y origin="0"></y> </axis> <data> <x bind="RegionName"></x> </data> <header text="Hardware Distribution"></header> <series-list> <series label="Desktops"> <data> <y bind="Desktops"></y> </data> </series> <series label="Notebooks"> <data> <y bind="Notebooks"></y> </data> </series> <series label="Tablets"> <data> <y bind="Tablets"></y> </data> </series> </series-list> </wij-linechart>

Markup

Copy Code

<wij-linechart data-source="list" height="400" width="600" show-chart-labels="false">
    <axis>
        <y origin="0"></y>
    </axis>
    <data>
        <x bind="RegionName"></x>
    </data>
    <header text="Hardware Distribution"></header>
    <series-list>
        <series label="Desktops">
            <data>
                <y bind="Desktops"></y>
            </data>
        </series>
        <series label="Notebooks">
            <data>
                <y bind="Notebooks"></y>
            </data>
        </series>
        <series label="Tablets">
            <data>
                <y bind="Tablets"></y>
            </data>
        </series>
    </series-list>
</wij-linechart>

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

Concepts

Data Binding