/* * Copyright 2015 Canonical Ltd. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published by * the Free Software Foundation; version 3. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this program. If not, see . */ import QtQuick 2.4 import Lomiri.Components 1.3 /*! \qmltype DatePicker \inqmlmodule Lomiri.Components.Pickers 1.0 \ingroup ubuntu-pickers \brief DatePicker component provides date and time value picking functionality. DatePicker combines up to three Picker elements providing different date or time value selection possibilities. It can be used to select full date (year, month, day), full time (hours, minutes, seconds) as well as to select a combination of year and month, month and day, hours and minutes, minutes and seconds or individual time units (i.e. year, month or day as well as hours, minutes or seconds). The selected date as well as the initial one is provided by the \l date property. For convenience the component provides also the \a year, \a month, \a day, \a week, \a hours, \a minutes and \a seconds values as separate properties, however these properties are not writable, and their initialization can happen only through the \l date property. \qml import QtQuick 2.4 import Lomiri.Components 1.3 import Lomiri.Components.Pickers 1.0 Column { Label { text: "Selected date: W" + datePicker.week + " - " + Qt.formatDate(datePicker.date, "dddd, dd-MMMM-yyyy") } DatePicker { id: datePicker } } \endqml The \l mode property specifies what time units should be shown by the picker. The property holds a string, combining \b Years, \b Months, \b Days, \b Hours, \b Minutes and \b Seconds strings sepatared with '|' character. A DatePicker which shows only year and month date units would look as follows: \qml import QtQuick 2.4 import Lomiri.Components 1.3 import Lomiri.Components.Pickers 1.0 Column { Label { text: "Selected month: " + Qt.formatDate(datePicker.date, "MMMM-yyyy") } DatePicker { id: datePicker mode: "Years|Months" } } \endqml The \b mode of the DatePicker is set to date picking. In case time picking is needed, the model should be set to contain the time specific mode flags. The following example demonstrates how to use DatePicker for time picking. \qml import QtQuick 2.4 import Lomiri.Components 1.3 import Lomiri.Components.Pickers 1.0 Column { Label { text: "Selected time: " + Qt.formatTime(datePicker.date, "hh:mm:ss") } DatePicker { id: datePicker mode: "Hours|Minutes|Seconds" } } \endqml Note that the order in which the mode flags are specified does not influence the order the pickers are arranged. That is driven by the date format of the \l locale used in the picker. Also not all combinations of mode flags are supported. See \l mode for the supported combinations. The default interval the date values are chosen is a window starting at the current date ending 50 years later. This window is defined by the \a minimum and \a maximum properties. The interval can be altered considering the following rules: \list \li \a minimum must be less or equal than the \l date; if the \a date value is less than the given \a minimum, the date will be set to the minimum's value \li \a maximum value must be greater than the \a minimum, or invalid. When the maximum is smaller than the \l date, the \l date property will be updated to get the maximum value. When set to invalid date (see Date.getInvalidDate()), the upper limit of the date interval becomes infinite, meaning the year picker will extend infinitely. This leads to increased memory use and should be avoided if possible. Invalid date will make hours picker presenting 24 hours. \endlist \qml import QtQuick 2.4 import Lomiri.Components 1.3 import Lomiri.Components.Pickers 1.0 Column { Label { text: "Selected date: " + Qt.formatDate(datePicker.date, "dddd, dd-MMMM-yyyy") } DatePicker { id: datePicker minimum: { var d = new Date(); d.setFullYear(d.getFullYear() - 1); return d; } maximum: Date.prototype.getInvalidDate.call() } } \endqml \b Note: do not use the \l date property when initializing minimum and maximum as it will cause binding loops. \section2 Layout As mentioned earlier, DatePicker combines up to three Picker tumblers depending on the mode requested. These tumblers are laid out in a row in the order the default date format of the \l locale is. \section3 Date picker layout rules The date picker consist of three pickers: year, month, and date. The exact contents of the month and date pickers depends on the available width: \list \li full name for month, number and full day for date (“August” “28 Wednesday”) \li otherwise full name for month, number and abbreviated day for date (“August” “28 Wed”); \li otherwise full name for month, number for date (“August” “28”); \li otherwise abbreviated name for month, number for date (“Aug” “28”). \li otherwise number for month, number for date (“08” “28”). \endlist \a{If the currently selected date becomes impossible due to year change (from a leap to a non-leap year when the date is set to February 29) or month change (e.g. from a month that has 31 days to one that has fewer when the date is set to 31), the date reduces automatically to the last day of the month (i.e February 28 or 30th day of the month).} \section3 Time picker layout rules Time units are shown in fixed width picker tumblers, numbers padded with leading zeroes. There is no other special rule on the formatting of the time unit numbers. \section3 How minimum/maximum affects the tumblers If minimum and maximum are within the same year, the year picker will be insensitive. If minimum and maximum are within the same month, the month picker will also be insensitive. */ StyledItem { id: datePicker /*! Specifies what kind of date value selectors should be shown by the picker. This is a string of 'flags' separated by '|' separator, where flags are: \table \header \li {2, 1} Date picker modes \header \li Value \li Description \row \li Years \li Specifies to show the year picker \row \li Months \li Specifies to show the month picker \row \li Days \li Specifies to show the day picker \header \li {2, 1} Time picker modes \header \li Value \li Description \row \li Hours \li Specifies to show the hours picker \row \li FiveMinutes \li Specifies to show a minute picker in five minute intervals \row \li Minutes \li Specifies to show the minutes picker \row \li Seconds \li Specifies to show the seconds picker \endtable With some exceptions, any combination of these flags is allowed within the same group. Date and time picker modes cannot be combined. The supported combinations are: \a{Years|Months|Days}, \a{Years|Months}, \a{Months|Days}, \a{Hours|FiveMinutes|Seconds}, \a{Hours|Minutes|Seconds}, \a{Hours|FiveMinutes}, \a{Hours|Minutes}, \a{FiveMinutes|Seconds}, and \a{Minutes|Seconds}, as well as each mode flag individually. The default value is "\a{Years|Months|Days}". */ property string mode: "Years|Months|Days" /*! The date chosen by the DatePicker. The default value is the date at the component creation time. The property automatically updates year, month and day properties. */ property date date: Date.prototype.midnight.call(new Date()) /*! \qmlproperty int minimum The minimum date (inclusive) to be shown in the picker. Both year and month values will be considered from the properties. The year and month picker values are filled based on these values. The year picker will be infinite (extending infinitely) if the maximum is an invalid date. If the distance between maximum and minimum is less than a year, the year picker will be shown disabled. The month picker will be circular if the distance between maximum and minimum is at least one year, or if the maximum date is invalid. The default values are the current date for the minimum, and 50 year distance value for maximum. */ property date minimum: Date.prototype.midnight.call(new Date()) /*! \qmlproperty int maximum The maximum date (inclusive) to be shown in the picker. Both year and month values will be considered from the properties. See \l minimum for more details. */ property date maximum: { var d = Date.prototype.midnight.call(new Date()); d.setFullYear(d.getFullYear() + 50); return d; } /*! For convenience, the \b year value of the \l date property. */ readonly property int year: datePicker.date.getFullYear() /*! For convenience, the \b month value of the \l date property. */ readonly property int month: datePicker.date.getMonth() /*! For convenience, the \b day value of the \l date property. */ readonly property int day: datePicker.date.getDate() /*! For convenience, the \b week value of the \l date property. */ readonly property int week: datePicker.date.getWeek() /*! For convenience, the \b hours value of the \l date property. */ readonly property int hours: datePicker.date.getHours() /*! For convenience, the \b minutes value of the \l date property. */ readonly property int minutes: datePicker.date.getMinutes() /*! For convenience, the \b seconds value of the \l date property. */ readonly property int seconds: datePicker.date.getSeconds() /*! The property defines the locale used in the picker. The default value is the system locale. \qml DatePicker { locale: Qt.locale("hu_HU") } \endqml */ property var locale: Qt.locale() /*! \qmlproperty bool moving \readonly The property holds whether the component's pickers are moving. \sa Picker::moving */ readonly property alias moving: positioner.moving implicitWidth: units.gu(36) implicitHeight: units.gu(20) activeFocusOnPress: true /*! \internal */ onMinimumChanged: { if (internals.completed && !minimum.isValid()) { // set the minimum to the date minimum = date; } // adjust date if (date !== undefined && Date.prototype.isValid.call(minimum) && date < minimum && internals.completed) { date = minimum; } } /*! \internal */ onMaximumChanged: { // adjust date if (date !== undefined && Date.prototype.isValid.call(maximum) && date > maximum && maximum > minimum && internals.completed) { date = maximum; } } /*! \internal */ onWidthChanged: { // use dayPicker narrowFormatLimit even if the dayPicker is hidden // and clamp the width so it cannot have less width that the sum of // the three tumblers' narrowFormatLimit var minWidth = 0.0; for (var i = 0; i < tumblerModel.count; i++) { minWidth += tumblerModel.get(i).pickerModel.narrowFormatLimit; } width = Math.max(width, minWidth); } /*! \internal */ onModeChanged: internals.updatePickers() /*! \internal */ onLocaleChanged: internals.updatePickers() Component.onCompleted: { if (minimum === undefined) { minimum = date; } internals.completed = true; internals.updatePickers(); } // models YearModel { id: yearModel mainComponent: datePicker pickerCompleted: internals.completed && internals.showYearPicker pickerWidth: (!pickerItem) ? 0 : narrowFormatLimit function syncModels() { dayModel.syncModels(); } } MonthModel { id: monthModel mainComponent: datePicker pickerCompleted: internals.completed && internals.showMonthPicker pickerWidth: { if (!pickerItem) { return 0; } return MathUtils.clamp(datePicker.width - yearModel.pickerWidth - dayModel.pickerWidth, narrowFormatLimit, longFormatLimit); } function syncModels() { dayModel.syncModels(); } } DayModel { id: dayModel mainComponent: datePicker pickerCompleted: internals.completed && internals.showDayPicker pickerWidth: { if (!pickerItem) { return 0; } var w = Math.max(datePicker.width * internals.dayPickerRatio, narrowFormatLimit); if (w < longFormatLimit && w >= shortFormatLimit) { return shortFormatLimit; } return w; } } HoursModel { id: hoursModel mainComponent: datePicker pickerCompleted: internals.completed && internals.showHoursPicker pickerWidth: { if (!pickerItem) { return 0; } return narrowFormatLimit; } } FiveMinutesModel { id: fiveMinutesModel mainComponent: datePicker pickerCompleted: internals.completed && internals.showFiveMinutesPicker pickerWidth: { if (!pickerItem) { return 0; } return narrowFormatLimit; } } FifteenMinutesModel { id: fifteenMinutesModel mainComponent: datePicker pickerCompleted: internals.completed && internals.showFifteenMinutesPicker pickerWidth: { if (!pickerItem) { return 0; } return narrowFormatLimit; } } MinutesModel { id: minutesModel mainComponent: datePicker pickerCompleted: internals.completed && internals.showMinutesPicker pickerWidth: { if (!pickerItem) { return 0; } return narrowFormatLimit; } } SecondsModel { id: secondsModel mainComponent: datePicker pickerCompleted: internals.completed && internals.showSecondsPicker pickerWidth: { if (!pickerItem) { return 0; } return narrowFormatLimit; } } styleName: "DatePickerStyle" Binding { target: __styleInstance property: "view" value: positioner } Binding { target: __styleInstance property: "pickerModels" value: tumblerModel } Binding { target: __styleInstance property: "unitSeparator" value: (internals.showHoursPicker || internals.showFiveMinutesPicker || internals.showMinutesPicker || internals.showSecondsPicker) ? ":" : "" } // tumbler positioner PickerRow { id: positioner parent: (datePicker.__styleInstance && datePicker.__styleInstance.hasOwnProperty("tumblerHolder")) ? datePicker.__styleInstance.tumblerHolder : datePicker mainComponent: datePicker model: tumblerModel margins: internals.margin anchors { top: parent.top bottom: parent.bottom horizontalCenter: parent.horizontalCenter } } // tumbler model ListModel { /* Model to hold tumbler order for repeaters. Roles: - pickerModel - pickerName */ id: tumblerModel /* Signal triggered when the model is about to remove a picker. We cannot rely on rowAboutToBeRemoved, as by the time the signal is called the list element is already removed from the model. */ signal pickerRemoved(int index) // the function checks whether a pickerModel was added or not // returns the index of the model object the pickerModel was found // or -1 on error. function pickerModelIndex(name) { for (var i = 0; i < count; i++) { if (get(i).pickerName === name) { return i; } } return -1; } // the function checks whether a pickerModel is present in the list; // moves the existing one to the given index or inserts it if not present function setPickerModel(model, name, index) { var idx = pickerModelIndex(name); if (idx >= 0) { move(idx, index, 1); } else { append({"pickerModel": model, "pickerName": name}); } } // removes the given picker function removePicker(name) { var idx = pickerModelIndex(name); if (idx >= 0) { pickerRemoved(idx); remove(idx); } } } // component to calculate text fitting Label { id: textSizer; visible: false } QtObject { id: internals property bool completed: false property real margin: units.gu(1.5) property real dayPickerRatio: 0.1 property bool showYearPicker: true property bool showMonthPicker: true property bool showDayPicker: true property bool showHoursPicker: false property bool showFiveMinutesPicker: false property bool showFifteenMinutesPicker: false property bool showMinutesPicker: false property bool showSecondsPicker: false /* Update pickers. */ function updatePickers() { if (completed) { // check mode flags first // FIXME: The js split(/\W/g) terminates the process on armhf with Qt 5.3 (v4 js) (https://bugreports.qt-project.org/browse/QTBUG-39255) var modes = datePicker.mode.match(/\w+/g); showYearPicker = showMonthPicker = showDayPicker = showHoursPicker = showFiveMinutesPicker = showFiveMinutesPicker = showMinutesPicker = showSecondsPicker = false; while (modes.length > 0) { var modeFlag = modes.pop(); switch (modeFlag) { case "Years": showYearPicker = true; break; case "Months": showMonthPicker = true; break; case "Days": showDayPicker = true; break; case "Hours": showHoursPicker = true; break; case "FiveMinutes": showFiveMinutesPicker = true; break; case "FifteenMinutes": showFifteenMinutesPicker = true; break; case "Minutes": showMinutesPicker = true; break; case "Seconds": showSecondsPicker = true; break; default: console.warn("Unhandled mode flag: " + modeFlag + ". Mode will not be set!"); return; } } if(showFiveMinutesPicker && showMinutesPicker || showFifteenMinutesPicker && showMinutesPicker) { console.warn("Invalid DatePicker mode: " + datePicker.mode); return; } // filter unaccepted date picking mode if (!showMonthPicker && showYearPicker && showDayPicker) { console.warn("Invalid DatePicker mode: " + datePicker.mode); return; } // filter unaccepted time picking mode if (showHoursPicker && showSecondsPicker && !(showMinutesPicker || showFiveMinutesPicker) && !(showFifteenMinutesPicker || showFiveMinutesPicker)) { console.warn("Invalid DatePicker mode: " + datePicker.mode); return; } // date and time picking not allowed at the same time if ((showYearPicker || showMonthPicker || showDayPicker) && (showHoursPicker || showFiveMinutesPicker || showFifteenMinutesPicker || showMinutesPicker || showSecondsPicker)) { console.warn("Date and Time picking not allowed at the same time."); return; } arrangeTumblers(); resetPickers(); } } /* Resets the pickers. Pickers will update their models with the given date, minimum and maximum values. */ function resetPickers() { if (!completed) return; for (var i = 0; i < tumblerModel.count; i++) { var pickerItem = tumblerModel.get(i).pickerModel.pickerItem; pickerItem.resetPicker(); } // calculate the ratio for the dayPicker var maxWidth = 0.0; maxWidth += showYearPicker ? yearModel.longFormatLimit : 0.0; maxWidth += showMonthPicker ? monthModel.longFormatLimit : 0.0; maxWidth += showDayPicker ? dayModel.longFormatLimit : 0.0; if (showDayPicker && maxWidth > 0.0) { dayPickerRatio = (dayModel.longFormatLimit / maxWidth).toPrecision(3); } } /* Detects the tumbler order from the date format of the locale */ function arrangeTumblers() { // disable completion so avoid accidental date changes completed = false; // use short format to exclude any extra characters // FIXME: The js split(/\W/g) terminates the process on armhf with Qt 5.3 (v4 js) (https://bugreports.qt-project.org/browse/QTBUG-39255) var format = datePicker.locale.dateFormat(Locale.ShortFormat).match(/\w+/g); // loop through the format to decide the position of the tumbler var formatIndex = 0; for (var i in format) { if (!format[i].length) continue; // check the first two characters switch (format[i].substr(0, 1).toLowerCase()) { case 'y': if (showYearPicker) { tumblerModel.setPickerModel(yearModel, "YearPicker", formatIndex); formatIndex++; } else { tumblerModel.removePicker("YearPicker"); } break; case 'm': if (showMonthPicker) { tumblerModel.setPickerModel(monthModel, "MonthPicker", formatIndex); formatIndex++; } else { tumblerModel.removePicker("MonthPicker"); } break; case 'd': if (showDayPicker) { tumblerModel.setPickerModel(dayModel, "DayPicker", formatIndex); formatIndex++; } else { tumblerModel.removePicker("DayPicker"); } break; } } // check hms if (showHoursPicker) { tumblerModel.setPickerModel(hoursModel, "HoursPicker", formatIndex); formatIndex++; } else { tumblerModel.removePicker("HoursPicker"); } if (showFiveMinutesPicker) { tumblerModel.setPickerModel(fiveMinutesModel, "FiveMinutesPicker", formatIndex); formatIndex++; } else { tumblerModel.removePicker("FiveMinutesPicker"); } if (showFifteenMinutesPicker) { tumblerModel.setPickerModel(fifteenMinutesModel, "FifteenMinutesPicker", formatIndex); formatIndex++; } else { tumblerModel.removePicker("FifteenMinutesPicker"); } if (showMinutesPicker) { tumblerModel.setPickerModel(minutesModel, "MinutesPicker", formatIndex); formatIndex++; } else { tumblerModel.removePicker("MinutesPicker"); } if (showSecondsPicker) { tumblerModel.setPickerModel(secondsModel, "SecondsPicker", formatIndex); formatIndex++; } else { tumblerModel.removePicker("SecondsPicker"); } // re-enable completion completed = true; } } }