<filename>doc/kendo-api/mobile/ui/button.json
{"name":"kendo.mobile.ui.Button","children":[{"name":"Events","children":[{"name":"click","children":[{"name":"Event Data","children":[{"name":"e.button `jQuery`"},{"name":"e.target `jQuery`"}]},{"name":"Example"}],"description":"Fires when the user taps the button.","args":["e.button","e.target"]}]},{"name":"Methods","children":[{"name":"enable","children":[{"name":"Example"},{"name":"Parameters","children":[{"name":"enable `Boolean`"}]}],"parameters":[{"name":"enable `Boolean`","description":"Whether to enable or disable the widget."}],"description":"Changes the enabled state of the widget."},{"name":"destroy","children":[{"name":"Example"}],"parameters":[],"description":"Prepares the **Button** 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.> **Important:** This method does not remove the Button element from DOM."},{"name":"badge","children":[{"name":"Example - remove the badge"},{"name":"Example"},{"name":"Returns"},{"name":"Parameters","children":[{"name":"value `String|Boolean`"}]}],"parameters":[{"name":"value `String|Boolean`","description":"The target value to be set or `false` to be removed."}],"description":"**Introduced in Q1 2013 SP** Sets a badge on the **Button** with the specified value. If invoked without parameters, returns the current badge value. Set the value to `false` to remove the badge."}]},{"name":"Configuration","children":[{"name":"icon","children":[{"name":"Example"}],"type":"String","description":" The icon of the button. It can be either one of the built-in icons, or a custom one."},{"name":"enable","children":[{"name":"Example - initialize disabled button."}],"type":"Boolean","default":" true","description":"If set to `false` the widget will be disabled and will not allow the user to click it. The widget is enabled by default."},{"name":"clickOn","children":[{"name":"Example - button which reacts immediately when pressed"}],"type":"String","description":"Configures the DOM event used to trigger the button click event/navigate in the mobile application. Can be set to `\"down\"` as an alias for `touchstart`, `mousedown`, `MSPointerDown`, and `PointerDown` vendor specific events.Setting the `clickOn` to `down` usually makes sense for buttons in the header or in non-scrollable views for increased responsiveness.By default, buttons trigger click/navigate when the user taps the button (a press + release action sequence occurs)."},{"name":"badge","children":[{"name":"Example - configuration based on jQuery plugin syntax"},{"name":"Example - configuration based on data attributes"}],"type":"String","description":" The badge of the button."}]}]}