# Mojo.Widget.IntegerPicker

## Namespace Detail

### Overview

The IntegerPicker offers selection of a single integer field. It is one of the simple picker widgets which present their choices as a linear sequence of values that wraps around; when you scroll to the end of the sequence, it simply continues back at the beginning.

### Declaration

>     <div x-mojo-element="IntegerPicker" id="integerpickerId"
>       class="integerpickerClass" name="integerpickerName"></div>

Properties | Required | Value | Description
--- | --- | --- | ---
x-mojo-element | Required | IntegerPicker | Declares the widget as type 'IntegerPicker'.
id | Required | Any String | Identifies the widget element for use when instantiating or rendering.
class | Optional | Any String | There is no default class for IntegerPicker, but you can assign one if you want to apply custom styling.
name | Optional | Any String | Adds a unique name to the IntegerPicker widget; generally used in templates.

### Events

>     this.controller.listen(this.controller.get("integerpickerId"),
>       Mojo.Event.propertyChange, this.handleUpdate);

Event Type | Value | Event Handling
--- | --- | ---
Mojo.Event.propertyChange | event.value or model.time | Respond to IntegerPicker value change or model.time

### Instantiation

>     this.controller.setupWidget("integerpickerId",
>       this.attributes = {
>           label: 'Number',
>           modelProperty: 'value',
>           min: 0,
>           max: 20
>       },
>       this.model = {
>           value: 5
>       }
>     );

### Attribute Properties

Attribute Property | Type | Required | Default | Description
--- | --- | --- | --- | ---
label | String | Optional | 'Value' | Label displayed for the widget controls.
labelPlacement | String | Optional | Mojo.Widget.labelPlacementLeft | Mojo.Widget.labelPlacementRight: places label on right, value on left. Mojo.Widget.labelPlacementLeft: places label on left, value on right
modelProperty | String | Optional | value | Model property name for integer.
min | Integer | Required | none | Minimum selection option.
max | Integer | Required | none | Maximum selection option.
padNumbers | Boolean | Optional | false | Specify whether or not to add padding to single-digit numbers.

### Model Properties

Model Property | Type | Required | Default | Description
--- | --- | --- | --- | ---
value | Integer | Required | null | Initial widget value and updated value after user selection.

### Methods

The IntegerPicker widget has no methods.