dojox/mobile/Badge¶
Authors: | Yoshiroh Kamiyama |
---|---|
Developers: | Yoshiroh Kamiyama |
since: | V1.8 |
Introduction¶
dojox/mobile/Badge is not a widget that inherits from dijit/_WidgetBase but a simple utility class for creating and updating a badge node. A badge consists of a simple DOM button. It is intended to be used from other widgets such as dojox/mobile/IconItem or dojox/mobile/TabBarButton.
Constructor Parameters¶
Parameter | Type | Default | Description |
value | String | “0” | A text to show in a badge. |
className | String | “mblDomButtonRedBadge” | A class name of a DOM button. |
fontSize | Number | 16 | Font size in pixel. The other style attributes are determined by the DOM button itself. |
Examples¶
Declarative example¶
<!-- Need to load the CSS stylesheets for the badge classes you use -->
<link href="dojox/mobile/themes/common/domButtons/DomButtonRedBadge.css" rel="stylesheet"/>
<link href="dojox/mobile/themes/common/domButtons/DomButtonGreenBadge.css" rel="stylesheet"/>
<link href="dojox/mobile/themes/common/domButtons/DomButtonBlueBadge.css" rel="stylesheet"/>
require([
"dojox/mobile",
"dojox/mobile/parser",
"dojox/mobile/Badge"
]);
<!-- Using default style -->
<div data-dojo-type="dojox/mobile/Badge" data-dojo-props='value:"10"'></div>
<!-- Specifying className -->
<div data-dojo-type="dojox/mobile/Badge" class="mblDomButtonRedBadge" data-dojo-props='value:"20"'></div>
<div data-dojo-type="dojox/mobile/Badge" class="mblDomButtonBlueBadge" data-dojo-props='value:"30"'></div>
<div data-dojo-type="dojox/mobile/Badge" class="mblDomButtonGreenBadge" data-dojo-props='value:"40"'></div>
<!-- Specifying fontSize -->
<div data-dojo-type="dojox/mobile/Badge" data-dojo-props='value:"50", fontSize:11'></div>
<div data-dojo-type="dojox/mobile/Badge"
class="mblDomButtonBlueBadge" data-dojo-props='value:"60", fontSize:11'></div>
<div data-dojo-type="dojox/mobile/Badge"
class="mblDomButtonGreenBadge" data-dojo-props='value:"70", fontSize:11'></div>
Programmatic example¶
<!-- Need to load the CSS stylesheets for the badge classes you use -->
<link href="dojox/mobile/themes/common/domButtons/DomButtonRedBadge.css" rel="stylesheet"/>
<link href="dojox/mobile/themes/common/domButtons/DomButtonGreenBadge.css" rel="stylesheet"/>
<link href="dojox/mobile/themes/common/domButtons/DomButtonBlueBadge.css" rel="stylesheet"/>
require([
"dojo/_base/window",
"dojo/ready",
"dojox/mobile/Badge",
"dojox/mobile",
"dojox/mobile/parser"
], function(win, ready, Badge){
ready(function(){
// Using default style
var badge1 = new Badge({value:"10"});
win.body().appendChild(badge1.domNode);
// Specifying className
var badge2 = new Badge({value:"20", className:"mblDomButtonRedBadge"});
win.body().appendChild(badge2.domNode);
var badge3 = new Badge({value:"30", className:"mblDomButtonBlueBadge"});
win.body().appendChild(badge3.domNode);
var badge4 = new Badge({value:"40", className:"mblDomButtonGreenBadge"});
win.body().appendChild(badge4.domNode);
// Specifying fontSize
var badge5 = new Badge({value:"50", fontSize:11});
win.body().appendChild(badge5.domNode);
var badge6 = new Badge({value:"60", fontSize:11, className:"mblDomButtonBlueBadge"});
win.body().appendChild(badge6.domNode);
var badge7 = new Badge({value:"70", fontSize:11, className:"mblDomButtonGreenBadge"});
win.body().appendChild(badge7.domNode);
});
});
Getting/Setting the value¶
You can get/set the value of badge by calling getValue()/setValue(value) functions as described in the example below.
<!-- Need to load the CSS stylesheets for the badge classes you use -->
<link href="dojox/mobile/themes/common/domButtons/DomButtonRedBadge.css" rel="stylesheet"/>
require([
"dojo/ready",
"dojo/_base/window",
"dojox/mobile/Badge",
"dojox/mobile",
"dojox/mobile/parser"
], function(ready, win, Badge){
ready(function(){
// Create a badge
var badge = new Badge({value:"10"});
win.body().appendChild(badge.domNode);
// Get the value of the badge
console.log(badge.getValue()); // "10"
// Set the value of the badge
badge.setValue("100");
console.log(badge.getValue()); // "100"
});
});