Code Monkey home page Code Monkey logo

skwas-cordova-plugin-datetimepicker's Introduction

npm version

skwas-cordova-plugin-datetimepicker

Cordova Plugin for showing a native date, time or datetime picker.

Installation

cordova plugin add skwas-cordova-plugin-datetimepicker

or for latest

cordova plugin add https://github.com/skwasjer/skwas-cordova-plugin-datetimepicker.git

Supported platforms

  • Android 4.4 and higher
  • iOS 9 and higher

Methods

show

show(options)
Show the plugin with specified options.

show(options, successCallback, errorCallback)
Show the plugin with specified options and callbacks.

This was the original way to call the plugin, and is kept for compatibility.

Note: The successCallback and errorCallback respectively will be ignored if the success or error callback is provided on the options argument.

Options

Name Type Default Android iOS
mode String date date, time, datetime date, time, datetime The display mode
date Date required required The initial date to display
allowOldDates boolean true Supported Supported Allow older dates to be selected
allowFutureDates boolean true Supported Supported Allow future dates to be selected
minDate Date Supported Supported Set the minimum date that can be selected
maxDate Date Supported Supported Set the maximum date that can be selected
minuteInterval int 1 >= Honeycomb Supported For minute spinner the number of minutes per step
locale String (user default) - Supported The locale to use for text and date/time
okText String (os default) Supported Supported The text to use for the ok button
cancelText String (os default) Supported Supported The text to use for the cancel button
clearText String Supported Supported The text to use for the clear button
titleText String Depends on theme Supported The text to use for the dialog title
success Function(date) - Supported Supported The success callback
cancel Function() - Supported Supported The cancel callback
error Function(err) - Supported Supported The error callback
android Object {} optional ignored Android specific options

When providing the clearText property, an extra button is shown with intent to clear the current date. When the user taps this button, the success callback will be called with an undefined date. From a UI perspective, this button should be hidden by application code when no date is currently set by omitting the property, but this is up to you.

Android options

Name Type Default Description
theme int Theme_DeviceDefault_Dialog android.R.style theme
is24HourView boolean true Use a 24 hour clock

On Lollipop and upwards the date and time pickers changed to calendar and radial pickers. If you want to use spinners (for example to use minuteInterval), use a built-in android.R.style theme that shows a date and time picker with spinners or read up here how to customize this.

Example

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {

    var myDate = new Date(); // From model.

    cordova.plugins.DateTimePicker.show({
        mode: "date",
        date: myDate,
        success: function(newDate) {
            // Handle new date.
            console.info(newDate);
            myDate = newDate;
        }
    });
}

hide

hide()
Hide the date time picker.

If the picker is currently being shown and a cancel-callback was provided in the options, the callback will be called when the picker is hidden.

Example

cordova.plugins.DateTimePicker.hide();

Changelog

For a list of all changes see here.

Build requirements

  • Cordova 7 and higher
  • Xcode 11 and higher (iOS)

Contributors

skwas-cordova-plugin-datetimepicker's People

Contributors

emanfu avatar lemaik avatar masimplo avatar skwasjer avatar turshija avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.