feat(QDate): docs + new method setViewTo(year, month)

Author: rstoenescu

docs/src/pages/vue-components/date.md

@@ -19,7 +19,7 @@ For handling date and/or time, also check out [Quasar Date Utils](/quasar-utils/
 ## Usage
 
 ::: warning
-Notice that the model is a String only.
+Notice that the actual date(s) of the model are all in String format.
 :::
 
 ### Basic
@@ -42,12 +42,16 @@ Clicking on an already selected day will deselect it.
 
 ### Range selection <q-badge align="top" label="v1.13+" />
 
-Notice in the examples below that the model is an Array of Arrays.
+Notice in the examples below that the model is an Object (single selection) or an Array of Objects (multiple selection).
 
-Clicking on an already selected day will deselect it.
+::: tip TIPS
+* Clicking on an already selected day will deselect it.
+* The user's current editing range can also be set programmatic through the `setEditingRange` method (check the API card).
+* There are two useful events in regards to the current editing range: `range-start` and `range-end` (check the API card).
+:::
 
 ::: warning
-The `range` property is partially compatible with the `options` prop: selected ranges might also include "unselectable" days.
+The `range` property is only partially compatible with the `options` prop: selected ranges might also include "unselectable" days.
 :::
 
 <doc-example title="Single Range" file="QDate/SelectionRange" overflow />

ui/src/components/date/QDate.js

@@ -147,7 +147,7 @@ export default Vue.extend({
       return this.normalizedModel
         .filter(date => Object(date) === date && date.from !== void 0 && date.to !== void 0)
         .map(range => ({ from: fn(range.from), to: fn(range.to) }))
-        .filter(range => range.from.dateHash !== null && range.to.dateHash !== null)
+        .filter(range => range.from.dateHash !== null && range.to.dateHash !== null && range.from.dateHash < range.to.dateHash)
     },
 
     getNativeDateFn () {
@@ -686,8 +686,7 @@ export default Vue.extend({
   methods: {
     setToday () {
       this.__toggleDate(this.today, this.__getMonthHash(this.today))
-      this.view = 'Calendar'
-      this.__updateViewModel(this.today.year, this.today.month)
+      this.setViewTo(this.today.year, this.today.month)
     },
 
     setView (view) {
@@ -704,6 +703,11 @@ export default Vue.extend({
       }
     },
 
+    setViewTo (year, month) {
+      this.view = 'Calendar'
+      this.__updateViewModel(year, month)
+    },
+
     setEditingRange (from, to) {
       if (this.range === false || !from) {
         this.editRange = void 0
@@ -722,8 +726,7 @@ export default Vue.extend({
         finalHash: this.__getDayHash(final)
       }
 
-      this.view = 'Calendar'
-      this.__updateViewModel(init.year, init.month)
+      this.setViewTo(init.year, init.month)
     },
 
     __getMask () {
@@ -1216,13 +1219,13 @@ export default Vue.extend({
             ? { from: this.editRange.init, to: day }
             : { from: day, to: this.editRange.init }
 
+        this.editRange = void 0
+        this.__addToModel(initHash === finalHash ? day : payload)
+
         this.$emit('range-end', {
           from: this.__getPublicData(payload.from),
           to: this.__getPublicData(payload.to)
         })
-
-        this.editRange = void 0
-        this.__addToModel(initHash === finalHash ? day : payload)
       }
     },
 

ui/src/components/date/QDate.json

@@ -265,7 +265,7 @@
       "params": {
         "from": {
           "type": "Object",
-          "desc": "Definition of the current view (year, month)",
+          "desc": "Definition of date from where the range begins",
           "definition": {
             "year": {
               "type": "Number",
@@ -297,7 +297,7 @@
           "definition": {
             "from": {
               "type": "Object",
-              "desc": "Definition of the current view (year, month)",
+              "desc": "Definition of date from where the range begins",
               "definition": {
                 "year": {
                   "type": "Number",
@@ -318,7 +318,7 @@
             },
             "to": {
               "type": "Object",
-              "desc": "Definition of the current view (year, month)",
+              "desc": "Definition of date to where the range ends",
               "definition": {
                 "year": {
                   "type": "Number",
@@ -352,15 +352,32 @@
 
     "setView": {
       "desc": "Change current view",
-      "addedIn": "v1.1.7",
       "params": {
         "view": {
           "type": "String",
           "desc": "QDate view name",
           "required": true,
           "values": [ "Calendar", "Months", "Years" ]
         }
-      }
+      },
+      "addedIn": "v1.1.7"
+    },
+
+    "setViewTo": {
+      "desc": "Change current year and month of the Calendar view; It gets corrected if using navigation-min/max-year-month and sets the current view to Calendar",
+      "params": {
+        "year": {
+          "type": "Number",
+          "desc": "The year",
+          "__exemption": [ "examples" ]
+        },
+        "month": {
+          "type": "Number",
+          "desc": "The month",
+          "__exemption": [ "examples" ]
+        }
+      },
+      "addedIn": "v1.13.0"
     },
 
     "offsetCalendar": {
@@ -385,7 +402,7 @@
       "params": {
         "from": {
           "type": "Object",
-          "desc": "Definition of the current view (year, month)",
+          "desc": "Definition of date from where the range begins",
           "definition": {
             "year": {
               "type": "Number",
@@ -406,7 +423,7 @@
         },
         "to": {
           "type": "Object",
-          "desc": "Definition of the current view (year, month)",
+          "desc": "Definition of date to where the range ends",
           "definition": {
             "year": {
               "type": "Number",