本文转自:https://market.ionic.io/plugins/ionicdatepicker
##Introduction:
This is an ionic-datepicker
bower component, which can be used in any Ionic framework's application. No additional plugins required for this component.
##Prerequisites.
- node.js
- npm
- bower
- gulp
##How to use:
1) In your project repository install the ionic-datepicker using bower
bower install ionic-datepicker --save
This will install the latest version released.
2) Give the path of ionic-datepicker.bundle.min.js
in your index.html
file.
<!-- path to ionic/angularjs -->
<script src="lib/ionic-datepicker/dist/ionic-datepicker.bundle.min.js"></script>
3) In your application module inject the dependency ionic-datepicker
, in order to work with the ionic time picker
angular.module('mainModuleName', ['ionic', 'ionic-datepicker']){
//
}
4) Use the below format in your template's corresponding controller
$scope.datepickerObject = {
titleLabel: 'Title', //Optional
todayLabel: 'Today', //Optional
closeLabel: 'Close', //Optional
setLabel: 'Set', //Optional
setButtonType : 'button-assertive', //Optional
todayButtonType : 'button-assertive', //Optional
closeButtonType : 'button-assertive', //Optional
inputDate: new Date(), //Optional
mondayFirst: true, //Optional
disabledDates: disabledDates, //Optional
weekDaysList: weekDaysList, //Optional
monthList: monthList, //Optional
templateType: 'popup', //Optional
showTodayButton: 'true', //Optional
modalHeaderColor: 'bar-positive', //Optional
modalFooterColor: 'bar-positive', //Optional
from: new Date(2012, 8, 2), //Optional
to: new Date(2018, 8, 25), //Optional
callback: function (val) { //Mandatory
datePickerCallback(val);
}
dateFormat: 'dd-MM-yyyy', //Optional
closeOnSelect: false, //Optional
};
$scope.datepickerObject is the main object, that we need to pass to the directive. The properties of this object are as follows.
a) titleLabel(Optional) : The label for 'Title' of the ionic-datepicker popup. Default value is Select Date
b) todayLabel(Optional) : The label for Today
button. Default value is Today
c) closeLabel(Optional) : The label for Close
button. Default value is Close
d) setLabel(Optional) : The label for Set
button. Default value is Set
e) setButtonType(Optional) : This the type of the Set
button. Default value is button-positive
. You can give any valid ionic framework's button classes.
f) todayButtonType(Optional) : This the type of the Today
button. Default value is button-stable
. You can give any valid ionic framework's button classes.
g) closeButtonType(Optional) : This the type of the Close
button. Default value is button-stable
. You can give any valid ionic framework's button classes.
h) inputDate(Optional) : This is the date object to pass to the directive. You can give any date object to this property. Default value is new Date()
. But if you wish to show the initial date in the HTML page, then you should define this property.
i) mondayFirst(Optional) : Set true
if you wish to show monday as the first day. Default value is false
.
j) disabledDates(Optional) : If you have a list of dates to disable, you can create an array like below. Default value is an empty array.
var disabledDates = [
new Date(1437719836326),
new Date(),
new Date(2015, 7, 10), //months are 0-based, this is August, 10th!
new Date('Wednesday, August 12, 2015'), //Works with any valid Date formats like long format
new Date("08-14-2015"), //Short format
new Date(1439676000000) //UNIX format
];
k) weekDaysList(Optional) : This is an array with a list of all week days. You can use this if you want to show months in some other language or format or if you wish to use the modal instead of the popup for this component (Refer to point l), you can define the weekDaysList
array in your controller as shown below.
var weekDaysList = ["Sun", "Mon", "Tue", "Wed", "thu", "Fri", "Sat"];
The default values are
["S", "M", "T", "W", "T", "F", "S"];
l) monthList(Optional) : This is an array with a list of all months. You can use this if you want to show months in some other language or format. You can create an array like below.
var monthList = ["Jan", "Feb", "March", "April", "May", "June", "July", "Aug", "Sept", "Oct", "Nov", "Dec"];
The default values are
["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
m) templateType(Optional) : This is string type which takes two values i.e. modal
or popup
. Default value is modal
. If you wish to open in a popup, you can specify the value as popup
or else you can ignore it.
n) modalHeaderColor(Optional) : This takes any valid ionic framework's header color. Default value is bar-stable
o) modalFooterColor(Optional) : This takes any valid ionic framework's footer color. Default value is bar-stable
p) from(Optional) : This is a date object, from which you wish to enable the dates. You can use this property to disable previous dates by specifying from: new Date()
. By default all the dates are enabled. Please note that months are 0 based.
q) to(Optional) : This is a date object, to which you wish to enable the dates. You can use this property to disable future dates by specifying to: new Date()
. By default all the dates are enabled. Please note that months are 0 based.
r) callback(Mandatory) : This the callback function, which will get the selected date in to the controller. You can define this function as follows.
var datePickerCallback = function (val) {
if (typeof(val) === 'undefined') {
console.log('No date selected');
} else {
console.log('Selected date is : ', val)
}
};
s) dateFormat(Optional) : This is date format used in template. Defaults to dd-MM-yyyy
. For how to format date, see: http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.1.15
t) closeOnSelect(Optional) : Boolean to indicate wheteher datepicker will be closed after date selection. If set to true
, "Set" button will be hidden. Defaults to false
.
5) Then use the below format in your template / html file
<ionic-datepicker input-obj="datepickerObject">
<button class="button button-block button-positive"> {{datepickerObject.inputDate | date:'dd - MMMM - yyyy'}}</button>
</ionic-datepicker>
a) ionic-datepicker is the directive, to which we can pass required vales.
b) input-obj(Mandatory) : This is an object. We have to pass an object as shown above.
##Screen Shots:
Once you are successfully done with the above steps, you should be able to see the below screen shots. I have used two buttons here.
The first screen shot shows only the buttons before clicking on them. Once you click on the button you should see the second screen shot.