Measurement

• 'fade'
• 'flip'
• 'pop'
• 'swing'
• 'slidevertical'
• 'slidehorizontal'
• 'slidedown'
• 'slideup'

• 'set' - Sets the value.
• 'clear' - Clears the value.
• 'cancel' - Dismisses the popup.

• text String - Text of the button.
• handler String, Function - The function which will run when the button is pressed. If a string, it must be one of the predefined button handlers:
  • 'set' - Sets the value.
  • 'clear' - Clears the value.
  • 'cancel' - Dismisses the popup.
• icon String (Optional) - Icon of the button.
• cssClass String (Optional) - Css class of the button.

buttons: [
    'set',
    {
        text: 'Custom',
        icon: 'checkmark',
        cssClass: 'my-btn', 
        handler: function (event) {
            alert('Custom button clicked!');
        }
    },
    'cancel'
]

buttons: [
    'set',
    {
        text: 'Hide',
        handler: 'cancel',
        icon: 'close',
        cssClass: 'my-btn'
    }
]

• 'center' - The component appears as a popup at the center of the viewport.
• 'inline' - If called on div element, the component is placed inside the div (overwriting existing content), otherwise is placed after the original element.
• 'bubble' - The component appears as a bubble positioned to the element defined by the anchor option. By default the anchor is the original element.
• 'top' - The component appears docked to the top of the viewport.
• 'bottom' - The component appears docked to the bottom of the viewport.

• 'liquid' - Wheels will expand to the maximum available width, but will not exceed the width set by the maxWidth setting. If maxWidth is not specified, the total width of all wheels will not exceed 600px. In 'top' or 'bottom' display mode this is the default behavior.
• 'fixed' or undefined - Wheels will expand to the size of the longest wheel value, but will not exceed the width set by the maxWidth setting.

• xsmall - min-width: 0px
• small - min-width: 576px
• medium - min-width: 768px
• large - min-width: 992px
• xlarge - min-width: 1200px

responsive: {
    small: {
        display: 'bottom'
    },
    custom: { // Custom breakpoint
        breakpoint: 600,
        display: 'center'
    },
    large: {
        display: 'bubble'
    }
}

Sets the visual appearance of the component.

If it is 'auto' or undefined, the theme will automatically be chosen based on the platform.

If the theme for the specific platform is not present, it will default to the Mobiscroll theme.

• 'bootstrap' - Bootstrap themes
• 'ios' - iOS theme
• 'material' - Material theme
• 'mobiscroll' - Mobiscroll theme
• 'windows' - Windows theme

Controls which variant of the theme will be used (light or dark).

• 'light' - Use the light variant of the theme.
• 'dark' - Use the dark variant of the theme.
• 'auto' or undefined - Detect the preferred system theme on devices where this is supported.

If not set, only the theme setting will determine which theme to use.

To use the option with custom themes, make sure to create two custom themes, where the dark version has the same name as the light one, suffixed with '-dark', e.g.: 'my-theme' and 'my-theme-dark'.

Use true to render a touch optimized user interface, or false for a user interface optimized for pointer devices (mouse, touchpad).

Can be used with the responsive option to change the user interface based on viewport width.

Parameters

• event: Object - The event object has the following properties:
  • valueText: String - The selected value as text.
  • button: String - The name of the button which triggered the component to close ('set', or 'cancel').
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onBeforeClose: function (event, inst) {
    }
});

Parameters

• event: Object - The event object.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onBeforeShow: function (event, inst) {
    }
});

Parameters

• event: Object - The event object has the following properties:
  • valueText: String - The selected value as text.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onCancel: function (event, inst) {
    }
});

Parameters

• event: Object - The event object has the following properties:
  • valueText: String - The selected value as text.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onChange: function (event, inst) {
    }
});

Parameters

• event: Object - The event object.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onClear: function (event, inst) {
    }
});

Parameters

• event: Object - The event object has the following properties:
  • valueText: String - The selected value as text.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onClose: function (event, inst) {
    }
});

Parameters

• event: Object - The event object.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onDestroy: function (event, inst) {
    }
});

Parameters

• event: Object - The event object.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onInit: function (event, inst) {
    }
});

Parameters

• event: Object - The event object has the following properties:
  • target: HTMLElement - The DOM element of the tapped item.
  • selected: Boolean - Selected state of the tapped item.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onItemTap: function (event, inst) {
    }
});

Parameters

• event: Object - The event object has the following properties:
  • target: Object - The DOM element containing the generated html.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onMarkupReady: function (event, inst) {
    }
});

Parameters

• event: Object - The event object has the following properties:
  • target: Object - The DOM element containing the generated html.
  • windowWidth: Number - The window width.
  • windowHeight: Number - The window height.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onPosition: function (event, inst) {
    }
});

Parameters

• event: Object - The event object has the following properties:
  • valueText: String - The selected value as text (if any).
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onSet: function (event, inst) {
    }
});

Parameters

• event: Object - The event object has the following properties:
  • target: Object - The DOM element containing the generated html.
  • valueText: String - The selected value as text.
• inst: Object - The instance object of the measurement.

Example

$('#mobiscroll').mobiscroll().measurement({
    onShow: function (event, inst) {
    }
});

Example

// With selector
$('#mobiscroll').mobiscroll('cancel');

// With instance
mobiscrollInstance.cancel();

Example

// With selector
$('#mobiscroll').mobiscroll('clear');

// With instance
mobiscrollInstance.clear();

Returns: Object

• Returns the element back to its pre-init state.

Example

// With selector
$('#mobiscroll').mobiscroll('destroy');

// With instance
mobiscrollInstance.destroy();

Example

// With selector
$('#mobiscroll').mobiscroll('disable');

// With instance
mobiscrollInstance.disable();

Example

// With selector
$('#mobiscroll').mobiscroll('enable');

// With instance
mobiscrollInstance.enable();

Returns: Object

• The object instance.

Example

// With selector
$('#mobiscroll').mobiscroll('getInst');

// With instance
mobiscrollInstance.getInst();

Parameters

• temp (Optional): Boolean - If true, returns the temporary values (prior clicking the Set button).

Returns: String

• The selected measurement value.

Example

// With selector
$('#mobiscroll').mobiscroll('getVal');

// With instance
mobiscrollInstance.getVal();

Parameters

• prevAnim (Optional): Boolean - If true, hide will not be animated.
• btn (Optional): String - Specifies which button caused the component to hide, and it's passed to the onBeforeClose event.

Example

// With selector
    $('#mobiscroll').mobiscroll('hide');

    // With instance
    mobiscrollInstance.hide();
    

Returns: Boolean

• True if the component is visible, false if it's not.

Example

// With selector
$('#mobiscroll').mobiscroll('isVisible');

// With instance
mobiscrollInstance.isVisible();

Parameters

• options: Object - A map of option-value pairs to set.

Example

// With selector
$('#mobiscroll').mobiscroll('option', {
    display: 'bottom',
    lang: 'de'
});

// With instancee
mobiscrollInstance.option({
    display: 'bottom',
    lang: 'de'
});

Parameters

• check (Optional): Boolean - If true, the function checks if viewport size changed after last position call, if false or ommitted, position is recalculated anyway.

Example

// With selector
$('#mobiscroll').mobiscroll('position');

// With instance
mobiscrollInstance.position();

Example

// With selector
$('#mobiscroll').mobiscroll('select');

// With instance
mobiscrollInstance.select();

Parameters

• value: String - The measurement value.
• fill (Optional): Boolean - If true, the associated input element is also updated with the new value.
• change (Optional): Boolean - If false, change event won't be triggered on the input element.
• temp (Optional): Boolean - If true, only temporary value is set.
• time (Optional): Number - Specifies the duration of the animation in seconds to scroll the wheels to the new values. There is no animation, if time is omitted or 0.

Example

Parameters

• prevAnim (Optional): Boolean - If true, show will not be animated.
• prevFocus (Optional): Boolean - If true, the popup will not be focused right after show.

Example

// With selector
$('#mobiscroll').mobiscroll('show');

// With instance
mobiscrollInstance.show();

Parameters

• el: Object - The element with tap event.
• handler: Function - If the action was initiated with touch event, handler is called on touchend, otherwise on click.

Example

// With selector
$('#mobiscroll').mobiscroll('tap', $('#element'), function () { alert("It's a tap!"); });

// With instance
mobiscrollInstance.tap('#element', function () { alert("It's a tap!"); });

• c - Celsius
• k - Kelvin
• f - Fahrenheit
• r - Rankine

Parameters

• value: String - The measurement value.
• fill (Optional): Boolean - If true, the associated input element is also updated with the new value.
• change (Optional): Boolean - If false, change event won't be triggered on the input element.
• temp (Optional): Boolean - If true, only temporary value is set.
• time (Optional): Number - Specifies the duration of the animation in seconds to scroll the wheels to the new values. There is no animation, if time is omitted or 0.

Example

// With selector
$('#mobiscroll').mobiscroll('setVal', '5.00 °C');

// With instance
mobiscrollInstance.setVal('5.00 °C');

• kph - Kilometers per hour
• mph - Miles per hour
• mps - Meters per second
• fps - Feet per second
• knot - Knot

Parameters

• value: String - The measurement value.
• fill (Optional): Boolean - If true, the associated input element is also updated with the new value.
• change (Optional): Boolean - If false, change event won't be triggered on the input element.
• temp (Optional): Boolean - If true, only temporary value is set.
• time (Optional): Number - Specifies the duration of the animation in seconds to scroll the wheels to the new values. There is no animation, if time is omitted or 0.

Example

// With selector
$('#mobiscroll').mobiscroll('setVal', '50.00 km/h');

// With instance
mobiscrollInstance.setVal('50.00 km/h');

• mm - Milimeters
• cm - Centimeters
• dm - Decimeters
• m - Meters
• dam - Decameters
• hm - Hectometers
• km - Kilometers
• in - Inches
• ft - Feet
• yd - Yards
• ch - Chains
• fur - Furlongs
• mi - Miles
• lea - Leagues

Parameters

• value: String - The measurement value.
• fill (Optional): Boolean - If true, the associated input element is also updated with the new value.
• change (Optional): Boolean - If false, change event won't be triggered on the input element.
• temp (Optional): Boolean - If true, only temporary value is set.
• time (Optional): Number - Specifies the duration of the animation in seconds to scroll the wheels to the new values. There is no animation, if time is omitted or 0.

Example

// With selector
$('#mobiscroll').mobiscroll('setVal', '50.00 km');

// With instance
mobiscrollInstance.setVal('50.00 km');

• mg - Miligrams
• cg - Centigrams
• dg - Decigrams
• g - grams
• dag - Decagrams
• hg - Hectograms
• kg - Kilograms
• drc - Drachm
• oz - Ounces
• lb - Pounds
• st - Stones
• cwt - Hundredweights
• tlong - Long ton
• tshort - Short ton

Parameters

• value: String - The measurement value.
• fill (Optional): Boolean - If true, the associated input element is also updated with the new value.
• change (Optional): Boolean - If false, change event won't be triggered on the input element.
• temp (Optional): Boolean - If true, only temporary value is set.
• time (Optional): Number - Specifies the duration of the animation in seconds to scroll the wheels to the new values. There is no animation, if time is omitted or 0.

Example

// With selector
$('#mobiscroll').mobiscroll('setVal', '50.00 kg');

// With instance
mobiscrollInstance.setVal('50.00 kg');

• N - Newton
• kp - Kilopond
• lbf - Pound-force
• pdl - Poundal

Parameters

• value: String - The measurement value.
• fill (Optional): Boolean - If true, the associated input element is also updated with the new value.
• change (Optional): Boolean - If false, change event won't be triggered on the input element.
• temp (Optional): Boolean - If true, only temporary value is set.
• time (Optional): Number - Specifies the duration of the animation in seconds to scroll the wheels to the new values. There is no animation, if time is omitted or 0.

Example

// With selector
$('#mobiscroll').mobiscroll('setVal', '50.00 N');

// With instance
mobiscrollInstance.setVal('50.00 N');

• Arabic: 'ar'
• Bulgarian: 'bg'
• Catalan: 'ca'
• Czech: 'cs'
• Chinese: 'zh'
• Croatian: 'hr'
• Danish: 'da'
• Dutch: 'nl'
• English: 'en' or 'en-US' or undefined
• English (UK): 'en-UK' or 'en-GB'
• Farsi: 'fa'
• German: 'de'
• Greek: 'el'
• Spanish: 'es'
• Finnish: 'fi'
• French: 'fr'
• Hebrew: 'he'
• Hindi: 'hi'
• Hungarian: 'hu'
• Italian: 'it'
• Japanese: 'ja'
• Korean: 'ko'
• Lithuanian: 'lt'
• Norwegian: 'no'
• Polish: 'pl'
• Portuguese (Brazilian): 'pt-BR'
• Portuguese (European): 'pt-PT'
• Romanian: 'ro'
• Russian: 'ru'
• Russian (UA): 'ru-UA'
• Slovak: 'sk'
• Serbian: 'sr'
• Thai: 'th'
• Swedish: 'sv'
• Turkish: 'tr'
• Ukrainian: 'ua'
• Vietnamese: 'vi'