/* * 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 . */ pragma Singleton import QtQuick 2.4 import QtQuick.Window 2.0 import Lomiri.Components 1.3 import Lomiri.Components.ListItems 1.3 import Lomiri.Components.Popups 1.3 /*! \qmltype PickerPanel \inqmlmodule Lomiri.Components \ingroup ubuntu-pickers \brief Provides a panel for opening a DatePicker in place of the input panel or as Popover, depending on the form factor. PickerPanel is a singleton component designed to open a DatePicker in the input panel area or in a Popover, depending on the form factor, following the design guides on date pickers. \qml import QtQuick 2.4 import Lomiri.Components 1.3 MainWindow { width: units.gu(40) height: units.gu(71) Page { title: "PickerPanel" Button { id: dateButton property date date: new Date() text: Qt.formatDateTime(date, "yyyy/MMMM") onClicked: PickerPanel.openDatePicker(dateButton, "date", "Years|Months") } } } \endqml The opened panel is closed automatically when the user taps/presses outside of the panel or Popover area. */ Item { /*! The function opens a DatePicker component in the input method area or in a popover, depending on the availability of an input method provider in the system and whether the size of the main screen width/height defines a phone form factor. The picked date will be read from and reported to the \a property of the \a caller as date type. This implies that the caller must have defined the given property of type date. On failure, the function returns null. On success, the returned object has the following properties: \code Item { property DatePicker picker property string pickerMode property date date property Item caller property string callerProperty signal closed() } \endcode \table \header \li Property \li Description \row \li \b picker \li instance of the DatePicker component shown in the panel/popup \row \li \b pickerMode \li represents the \l DatePicker::mode to be used. This is an optional parameter and if not defined, the default mode will be used. \row \li \b date \li represents the date selected \row \li \b caller \li the instance of the component opening the panel \row \li \b callerProperty \li the property of the caller holding the date value which will be updated by the picker. \header \li Signal \li Description \row \li closed() \li the signal is emitted when the panel or popover gets closed. The signal is handy when actions are performed upon panel close. \endtable */ function openDatePicker(caller, property, mode) { if (mode === undefined) { mode = "Years|Months|Days"; } var params = { "date": caller[property], "pickerMode": mode, "callerProperty": property } // hide OSK if eventually open if (Qt.inputMethod.visible) { Qt.inputMethod.hide(); } if (!internal.isPhone) { // we have no input panel defined, or the therefore we show the picker in a Popover return internal.openPopover(caller, params); } // OSK panel return internal.openPanel(caller, params); } QtObject { id: internal objectName: "PickerPanel_Internals" property bool formFactorPhone: Screen.width <= units.gu(40) && Screen.height <= units.gu(71) // present in a property so we can test it in property bool isPhone: false Component.onCompleted: isPhone = formFactorPhone && (QuickUtils.inputMethodProvider !== "") function openPopover(caller, params) { var popover = PopupUtils.open(datePickerPopover, caller, params); // Avoid confusing TypeError if popover couldn't be created if (popover) popover.parent = QuickUtils.rootItem(caller); return popover; } function openPanel(caller, params) { params["caller"] = caller; var panel = datePickerPanel.createObject(QuickUtils.rootItem(caller), params); return panel; } } // popover Component { id: datePickerPopover Popover { property alias picker: picker property alias date: picker.date property alias pickerMode: picker.mode property string callerProperty signal closed() contentWidth: frame.width contentHeight: frame.height Item { id: frame width: picker.width + units.gu(4) height: picker.height + units.gu(4) DatePicker { id: picker StyleHints { highlightBackgroundColor: theme.palette.normal.raised highlightColor: LomiriColors.jet } anchors.centerIn: parent Binding { target: caller property: callerProperty when: callerProperty != undefined value: picker.date } } } Component.onDestruction: closed() } } // OSK panel Component { id: datePickerPanel Rectangle { property alias picker: picker property alias date: picker.date property alias pickerMode: picker.mode property string callerProperty property Item caller signal closed() id: panel // no additional styling is needed color: theme.palette.normal.overlaySecondaryText width: parent.width height: Qt.inputMethod.keyboardRectangle.height > 0 ? Qt.inputMethod.keyboardRectangle.height : units.gu(26) y: parent.height ThinDivider { anchors.bottom: parent.top } DatePicker { id: picker StyleHints { highlightBackgroundColor: theme.palette.normal.raised highlightColor: LomiriColors.jet } anchors { fill: panel margins: units.gu(2) } Binding { target: caller property: callerProperty when: callerProperty != undefined value: picker.date } } InverseMouseArea { anchors.fill: parent onPressed: panel.state = '' } Component.onCompleted: state = 'opened' states: [ State { name: 'opened' PropertyChanges { target: panel y: parent.height - height } } ] transitions: [ Transition { from: '' to: 'opened' LomiriNumberAnimation { target: panel property: 'y' } }, Transition { from: 'opened' to: '' SequentialAnimation { LomiriNumberAnimation { target: panel property: 'y' } ScriptAction { script: { closed(); panel.destroy(); } } } } ] } } }