The widget looks good.
Just some comments:
- Use 4 spaces instead of tab for indentation
- Remember to add the license header to the new files (It is missing in
ui/js/widgets/samples/gauge-sample.html)
- Name the sample file as the css/js file (ie, gauge-flat.html)
- There are also some whitespaces in the sample file.
On 20/01/2015 01:26, Wen Wang wrote:
V3 -> V4:
1) Add comments of how to use the widget.
2) Minor style changes.
V2 -> V3:
Adding Samples of gauge.
V1 -> V2:
Change the time of the copyright.
New widget accept two options: "value" and "color". value varies from
0
to 100 and color contains "red", "blue", "yellow" and
"purple".
Signed-off-by: Wen Wang <wenwang(a)linux.vnet.ibm.com>
---
ui/css/theme-default/gauge-flat.css | 52 +++++++++++++
ui/js/widgets/gauge-flat.js | 127 ++++++++++++++++++++++++++++++++
ui/js/widgets/samples/gauge-sample.html | 34 +++++++++
3 files changed, 213 insertions(+)
create mode 100755 ui/css/theme-default/gauge-flat.css
create mode 100755 ui/js/widgets/gauge-flat.js
create mode 100644 ui/js/widgets/samples/gauge-sample.html
diff --git a/ui/css/theme-default/gauge-flat.css b/ui/css/theme-default/gauge-flat.css
new file mode 100755
index 0000000..f5b52e5
--- /dev/null
+++ b/ui/css/theme-default/gauge-flat.css
@@ -0,0 +1,52 @@
+/*
+ * Project Kimchi
+ *
+ * Copyright IBM, Corp. 2015
+ *
+ * Licensed under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *
http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an 'AS IS' BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+.ui-gauge-flat {
+ height: 15px;
+ width: 100px;
+ text-align: left;
+ overflow: hidden;
+ background: #E6E7E8;
+ border: 0 none;
+ border-radius: 0;
+}
+
+.ui-gauge-flat .ui-gauge-flat-value {
+ margin: -1px;
+ height: 100%;
+ border-radius: 0;
+}
+
+.ui-gauge-flat .red {
+ background: #D9182D;
+ border:1px solid #D9182D;
+}
+
+.ui-gauge-flat .blue {
+ background: #008ABF;
+ border:1px solid #008ABF;
+}
+
+.ui-gauge-flat .yellow {
+ background: #FDB813;
+ border:1px solid #FDB813;
+}
+
+.ui-gauge-flat .purple {
+ background: #7F1C7D;
+ border:1px solid #7F1C7D;
+}
\ No newline at end of file
diff --git a/ui/js/widgets/gauge-flat.js b/ui/js/widgets/gauge-flat.js
new file mode 100755
index 0000000..c073a2f
--- /dev/null
+++ b/ui/js/widgets/gauge-flat.js
@@ -0,0 +1,127 @@
+/*
+ * Project Kimchi
+ *
+ * Copyright IBM, Corp. 2015
+ *
+ * Licensed under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *
http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an 'AS IS' BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * How to use:
+ * $(".selector").gaugeFlat({
+ * value: 25, // Value that you the gauge is going to show, varies from 0 to 100.
+ * color: "red" // Color showed, currently only "red",
"yellow", "blue" and "purple" are supported.
+ * });
+ *
+ * Set value:
+ * $(".selector").gaugeFlat("value", <value>); // Replace
<value> with the value that is going to be showed.
+ *
+ * Get value:
+ * $(".selector").gaugeFlat("value"); // This returns the value of
gauge.
+ *
+ */
+
+(function( $ ) {
+
+return $.widget( "kimchi.gaugeFlat", {
+ version: "@VERSION",
+ options: {
+ max: 100,
+ value: 0,
+ color: "red"
+ },
+
+ min: 0,
+
+ _create: function() {
+ this.oldValue = this.options.value = this._constrainedValue();
+
+ this.element
+ .addClass( "ui-gauge-flat ui-widget ui-widget-content ui-corner-all" )
+ .attr({
+ role: "gaugeflat",
+ "aria-valuemin": this.min
+ });
+ var color = this.options.color;
+ if(color != "red" && color != "yellow" && color !=
"blue" && color != "purple") {
+ color = "red";
+ }
+
+
+ this.valueDiv = $( "<div class='ui-gauge-flat-value " + color +
" ui-widget-header ui-corner-left'></div>" )
+ .appendTo( this.element );
+
+ this._refreshValue();
+ },
+
+ _destroy: function() {
+ this.element
+ .removeClass( "ui-gauge-flat ui-widget ui-widget-content ui-corner-all" )
+ .removeAttr( "role" )
+ .removeAttr( "aria-valuemin" )
+ .removeAttr( "aria-valuemax" )
+ .removeAttr( "aria-valuenow" );
+
+ this.valueDiv.remove();
+ },
+
+ value: function( newValue ) {
+ if ( newValue === undefined ) {
+ return this.options.value;
+ }
+
+ this.options.value = this._constrainedValue( newValue );
+ this._refreshValue();
+ },
+
+ _constrainedValue: function( newValue ) {
+ if ( newValue === undefined ) {
+ newValue = this.options.value;
+ }
+
+ this.indeterminate = newValue === false;
+
+ if ( typeof newValue !== "number" ) {
+ newValue = 0;
+ }
+
+ return this.indeterminate ? false :
+ Math.min( this.options.max, Math.max( this.min, newValue ) );
+ },
+
+ _setOptions: function( options ) {
+ var value = options.value;
+ delete options.value;
+
+ this._super( options );
+
+ this.options.value = this._constrainedValue( value );
+ this._refreshValue();
+ },
+
+ _percentage: function() {
+ return this.indeterminate ? 100 : 100 * ( this.options.value - this.min ) / (
this.options.max - this.min );
+ },
+
+ _refreshValue: function() {
+ var value = this.options.value,
+ percentage = this._percentage();
+
+ this.valueDiv
+ .toggle( this.indeterminate || value > this.min )
+ .toggleClass( "ui-corner-right", value === this.options.max )
+ .width( percentage.toFixed(0) + "%" );
+ }
+});
+
+})(jQuery);
diff --git a/ui/js/widgets/samples/gauge-sample.html
b/ui/js/widgets/samples/gauge-sample.html
new file mode 100644
index 0000000..971d9a8
--- /dev/null
+++ b/ui/js/widgets/samples/gauge-sample.html
@@ -0,0 +1,34 @@
+<!--Sample code of gauge-->
+<!DOCTYPE html>
+<html>
+ <head>
+ <meta charset="UTF-8">
+ <title>Gauge Demo</title>
+ <script
src="../../../libs/jquery-1.10.0.min.js"></script>
+ <script src="../../../libs/jquery-ui.min.js"></script>
+ <script src="../gauge-flat.js"></script>
+ <link rel="stylesheet"
href="../../../libs/themes/base/jquery-ui.min.css">
+ <link rel="stylesheet"
href="../../../css/theme-default/gauge-flat.css">
+ </head>
+ <body>
+ <div class="gauge-demo"></div>
+ <script>
+ $(document).ready(function() {
+ console.log("test started1");
+ var gauged = $(".gauge-demo");
+ gauged.gaugeFlat({
+ value: 25,
+ color: "red"
+ });
+ var gaugeAdd = function() {
+ var gaugeValue = gauged.gaugeFlat("value");
+ gauged.gaugeFlat("value", gaugeValue + 1);
+ if (gaugeValue < 99) {
+ setTimeout(gaugeAdd, 300);
+ }
+ }
+ gaugeAdd();
+ });
+ </script>
+ </body>
+</html>
\ No newline at end of file