In this Angular getting started guide, you'll learn how to use the wijlineargauge 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 Gauges 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>
|
- 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>
|
- 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 add an optional $locale parameter on the controller.
- We set the value parameter that we use for both wijlineargauge and wijslider.
| Script |
Copy Code |
<script type="text/javascript">
var app = angular.module("MyApp", ["wijmo"]);
function MyController($scope, $locale) {
$scope.value = 70;
}
</script> |
- Add the following markup within the <body> tags to create the widgets. To see how this is done in jQuery without Angular, see Connect to a Slider.
- We use a <wij-lineargauge> directive to create the gauge widget, and set several options as attributes within the element:
- We set the value option to specify the "value" from our controller.
- We set the height and width options.
- We set the max and min options to control the values displayed on the gauge.
- We use nested elements in the markup to set the animation, face, labels, pointer, and ranges options.
- Inside our animation directive, we set the enabled, duration, and easing attributes.
- We set the style attribute of the face directive to set the background and outline color for the gauge.
- We set the style attribute of the labels directive to specify styles for the label font.
- We set the style attribute of the pointer directive to specify background and outline color for the pointer.
- Inside our ranges directive, we nest a range directive with a number of attributes set:
startValue (start-value), endValue (end-value), startDistance (start-distance), endDistance (end-distance), startWidth (start-width), endWidth (end-width).
- Inside the nested range directive, we set the style attribute to set the color and opacity of the range.
- We use a <wij-slider> directive to create the slider widget, and set a couple of options as attributes within the element:
- We set the value option to specify the "value" from our controller.
- We set the width option.
| Markup |
Copy Code |
<wij-lineargauge value="value" height="120" width="400" max="100" min="0">
<animation enabled="true" duration="400" easing=">"></animation>
<face>
<style fill="270-#FFFFFF-#D9E3F0" stroke="#7BA0CC" stroke-width="2"></style>
</face>
<labels>
<style fill="#1E395B" font-size="12" font-weight="800"></style>
</labels>
<pointer shape="rect" length="0.6">
<style fill="#1E395B" stroke="#7BA0CC" stroke-width="1" opacity="1"></style>
</pointer>
<ranges>
<range start-value="80" end-value="100" start-distance="0.85" end-distance="0.85" start-width="0.5" end-width="0.5">
<style fill="90-#3DA1D8-#3A6CAC" opacity="1" stroke="none"></style>
</range>
</ranges>
</wij-lineargauge>
<p>Drag and release the slider to change the gauge's value.</p>
<wij-slider value="value" width="400px"></wij-slider> |
- 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
