bombond / ember-mobile-inputs

Mobile friendly input helpers http://annotationsro.github.io/ember-mobile-inputs/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status

DEMO: http://annotationsro.github.io/ember-mobile-inputs/

Ember-mobile-inputs

HTML 5 introduced input types that are really great for mobile devices, but not that great for the good old desktops. Mainly because every browser implements it in a little bit different way (speaking of UI), which is sometimes not that great (e.g. number input in Firefox on Windows is simply disgusting...). And of course they are sometimes a little bit buggy (looking at you Firefox....) Also, it would be sometimes nice to enhance or alter the way these inputs behave on desktop - give them a little bit more glamour, right?

So what this addon does? On mobile (touch) devices it makes use of HTML5 power (renders a simple HTML <input type="whatever">) and on desktop it provides some extra fun:

  • input type number - decimal numbers only (pretty standard, but without the ugly stepper that I guess nobody uses anyway)
  • input type text - well just a simple input, nothing fancy here
  • input type date - masked input with the ability to customize the format + Pikaday calendar popup + nice calendar button

Requires Ember >= 2.15.0 because of Ember.assign - or use a shim

Install

ember install ember-mobile-inputs

Usage

Number

{{mobile-input id="numberInput" type='number' value=valueNumber disabled=isDisabled onValueChanged=(action 'callback')}}

You can customize the decimal point mark - whether to use comma or dot or both. You can do this by setting decimalMark attribute to:

  • comma
  • dot
  • both

Text

{{mobile-input id="textInput" type='text' value=valueText disabled=isDisabled onValueChanged=(action 'callback')}}

Password

{{mobile-input id="passInput" type='password' value=valuePass disabled=isDisabled onValueChanged=(action 'callback')}}

Date

With default date format - dd.mm.yyyy

{{mobile-input id="dateInput" type='date' value=valueDate disabled=isDisabled onValueChanged=(action 'callback')}}

With custom format

{{mobile-input id="customDateInput" type='date' value=valueDateFormat format='YYYY-MM-DD' disabled=isDisabled}}

showOn attribute with possible values:

  • button - show Pikaday calendar popup only when user clicks on the calendar button
  • input - show Pikaday whne you click on the input (calendar button is not visible)
  • both - combination of the both options above
  • none - no calendar popup at all

Configuration

You can add a global configuration into your config/enbironment.js file:

ENV['ember-mobile-inputs'] = {
  date:{
    firstDay: 0, // Pikaday configuration
    calendarButtonClass: 'fa fa-calendar', // font icon CSS classes to be used in place of calendar button
    format: 'DD.MM.YYYY',
    showOn: 'both' //available options: 'both', 'input', 'button', 'none',
  },
  number:{
    decimalMark: 'both', //available options: 'comma', 'dot', 'both'
    selectOnClick: false, //selects the whole number on focus
    formatOnDisabled: false //format numbers when input is disabled
  },
  text:{
      selectOnClick: false //selects the whole text on focus
  }
}

For more Pikaday (calendar popup) configuration information, please have a look at the Pikaday guide. You can use any configuration parameter, except onSelect and field that are used internally by this addon. You can also pass options parameter to the component - this is currently used only by date input to customize Pikaday calendar (content of options is merged with Pikaday config).

There is an option to add callback onBlurChanged that will be called on input blur, but only when value has changed since on-focus event. There is a service mobile-input-event-bus where you can subscribe to input changes on input blur - don't forget to enable these events in the config:

config/enbironment.js

ENV['ember-mobile-inputs'] = {
  eventOnBlurChanged: true
}

subscribe for events

mobileInputEventBus: Ember.inject.service('mobile-input-event-bus'),

this.get('mobileInputEventBus').subscribe('blurChanged', (newValue, oldValue, element)=>{
  window.console.log(`EVENT: newValue: ${newValue}, oldValue: ${oldValue}`);
});

You can pass custom attributes to the element using data-custom attribute:

  {{mobile-input value=value data-custom="hello world"}}

which will render:

<span data-custom="hello world" class="ember-mobile-input ember-mobile-input-text ember-view">
 <!-- some more stuff here -->
</span>

About

Mobile friendly input helpers http://annotationsro.github.io/ember-mobile-inputs/

License:MIT License


Languages

Language:JavaScript 80.2%Language:HTML 19.2%Language:CSS 0.6%