Welcome to the Mobiscroll API Reference. You can find the most up to date information about usage and customization options here.

Supported Platforms - Android 4.1+ including Android Marshmallow, iOS 6+ including iOS 10, Windows Phone 10 and all major mobile and desktop browsers

Having trouble? Ask for help.

Getting Started

Mobiscroll lets you easily create and customize touch friendly spinner/scroller controls.
Thanks to its architecture, the mobiscroll core provides the scrolling functionality and it can be used not just for date & time picking, but for rendering scrollable lists, selects, radiobutton lists, basically everything that lets you select a value.

To get started, follow these easy steps and create your first component.
The component is tied to either an input or a select element.

1. Download Mobiscroll

When building your package, select the required components on the download page.

2. Load the necessary scripts

<script src="js/mobiscroll.custom-3.2.1.min.js"></script>
<link href="css/mobiscroll.custom-3.2.1.min.css" rel="stylesheet" type="text/css">

3. Add an input to your HTML markup

<input id="scroller" />

4. Initialize your component

Default time picker
// create a datepicker with default settings'#scroller');
Default time picker
// create a timepicker with default settings
Default datetime picker
// create a datetimepicker with default settings

For more examples check out the demo page.

Using module loaders

Mobiscroll can be loaded as a module as well. It implements the Universal Module Definition (UMD) pattern, meaning that it can be used with module loaders supporting the Asynchronous Module Definition (AMD) (e.g. RequireJS, Webpack, SystemJS) or CommonJS (e.g. Browserify, Webpack, SystemJS) syntax.

To load Mobiscroll as a module, download the mobiscroll package and use it as you would use any other module:

CommonJS example
var mobiscroll = require('path/to/mobiscroll/js/mobiscroll.custom-3.2.1.min');'#test');
AMD example
require(['path/to/mobiscroll/js/mobiscroll.custom-3.2.1.min'], function (mobiscroll) {'#test');

Global Settings



The global mobiscroll object is the place where you can set all the options that you'll be needing across your application or page. It should contain the settings that need to be the same across all components.

// Sets the theme to iOS and localization to German
mobiscroll.settings = {
    theme: 'ios',
    lang: 'de'
Preorder available for Ember JS
What you'll get:
- Exclusive Early Beta Access
- Show your interest in the product. Based on the preorders we'll set the development and shipping priorities
- Get access to the full Framework until we ship
- Support and Maintenance is on us until we release the Mobiscroll for Ember
- We believe in delivering great products so if for any reason you are not satisfied, you'll get a full refund