Defines the initially selected Button.

Sets the DOM event used to select the button. Accepts "up" as an alias for touchend, mouseup and MSPointerUp vendor specific events.

By default, buttons are selected immediately after the user presses the button (on touchstart or mousedown or MSPointerDown, depending on the mobile device). However, if the widget is placed in a scrollable view, the user may accidentally press the button when scrolling. In such cases, it is recommended to set this option to "up".

Introduced in Q1 2013 SP Sets a badge on one of the ButtonGroup buttons with the specified value. If invoked without parameters, returns the button's current badge value. Set the value to false to remove the badge.

Returns

String|kendo.mobile.ui.Button Returns the badge value if invoked without parameters, otherwise returns the ButtonGroup object.

Example

var buttongroup = $("#buttonGroup").data("kendoMobileButtonGroup");

// Set the first button badge value to 5
buttongroup.badge(0, 5);

// Get the current badge value on the first button.
buttongroup.badge(0);

// Remove the first button badge
buttongroup.badge("li:first", false);

Get the currently selected Button.

Returns

jQuery the jQuery object representing the currently selected button.

Prepares the ButtonGroup for safe removal from DOM. Detaches all event handlers and removes jQuery.data attributes to avoid memory leaks. Calls destroy method of any child Kendo widgets.

Example

var buttonGroup = $("#buttonGroup").data("kendoMobileButtonGroup");

// detach events
buttonGroup.destroy();

Select a Button.

Example

var buttongroup = $("#buttongroup").data("kendoMobileButtonGroup");

// selects by jQuery object
buttongroup.select(buttongroup.element.children().eq(0));

// selects by index
buttongroup.select(1);

Fires when a Button is selected.

Handle select event

<ul id="buttongroup" data-role="buttongroup">
  <li>Option 1</li>
  <li>Option 2</li>
</ul>

<script>
 $("#buttongroup").data("kendoMobileButtonGroup").bind("select", function(e) {
     //handle select event
 }
</script>