quasar 2.9.2 → 2.10.1

package/src/components/tabs/QRouteTab.json

@@ -51,7 +51,6 @@
           "returns": {
             "type": "Promise<any>",
             "desc": "Returns the router's navigation promise",
-            "__exemption": [ "examples" ],
             "addedIn": "v2.9"
           }
         }

package/src/components/tabs/QTabs.js

@@ -597,13 +597,6 @@ export default createComponent({
       }
     }
 
-    /*
-     * Vue has an aggressive diff (in-place replacement) so we cannot
-     * ensure that the instance getting destroyed is the actual tab
-     * reported here. As a result, we cannot use its name or check
-     * if it's a route one to make the necessary updates. We need to
-     * always check the existing list again and infer the changes.
-     */
     function unregisterTab (tabData) {
       tabDataList.splice(tabDataList.indexOf(tabData), 1)
       tabDataListLen.value--

package/src/components/tabs/QTabs.json

@@ -35,7 +35,6 @@
       "desc": "Horizontal alignment the tabs within the tabs container",
       "default": "center",
       "values": [ "left", "center", "right", "justify" ],
-      "examples": [ "right" ],
       "category": "content"
     },
 
@@ -43,7 +42,6 @@
       "type": [ "Number", "String" ],
       "desc": "Breakpoint (in pixels) of tabs container width at which the tabs automatically turn to a justify alignment",
       "default": 600,
-      "examples": [ ":breakpoint=\"500\"" ],
       "category": "content|behavior"
     },
 
@@ -77,7 +75,7 @@
       "desc": "The class to be set on the active tab",
       "examples": [ "my-active-class" ],
       "category": "style",
-      "addedIn": "2.1.4"
+      "addedIn": "v2.1.4"
     },
 
     "left-icon": {

package/src/components/tabs/use-tab.js

@@ -6,7 +6,7 @@ import Ripple from '../../directives/Ripple.js'
 
 import { hMergeSlot } from '../../utils/private/render.js'
 import { isKeyCode, shouldIgnoreKey } from '../../utils/private/key-composition.js'
-import { tabsKey } from '../../utils/private/symbols.js'
+import { tabsKey, emptyRenderFn } from '../../utils/private/symbols.js'
 import { stopAndPrevent } from '../../utils/event.js'
 import uid from '../../utils/uid.js'
 import { isDeepEqual } from '../../utils/is.js'
@@ -41,9 +41,11 @@ export const useTabProps = {
 }
 
 export default function (props, slots, emit, routeData) {
-  const $tabs = inject(tabsKey, () => {
+  const $tabs = inject(tabsKey, emptyRenderFn)
+  if ($tabs === emptyRenderFn) {
     console.error('QTab/QRouteTab component needs to be child of QTabs')
-  })
+    return emptyRenderFn
+  }
 
   const { proxy } = getCurrentInstance()
 

package/src/components/time/QTime.json

@@ -43,18 +43,15 @@
       "params": {
         "hr": {
           "type": "Number",
-          "desc": "Hour",
-          "examples": [ 15 ]
+          "desc": "Hour"
         },
         "min": {
           "type": [ "Number", "null" ],
-          "desc": "Minutes",
-          "examples": [ 38 ]
+          "desc": "Minutes"
         },
         "sec": {
           "type": [ "Number", "null" ],
-          "desc": "Seconds",
-          "examples": [ 12 ]
+          "desc": "Seconds"
         }
       },
       "returns": null,
@@ -124,44 +121,37 @@
             "year": {
               "type": "Number",
               "required": true,
-              "desc": "The year",
-              "__exemption": [ "examples" ]
+              "desc": "The year"
             },
             "month": {
               "type": "Number",
               "required": true,
-              "desc": "The month",
-              "__exemption": [ "examples" ]
+              "desc": "The month"
             },
             "day": {
               "type": "Number",
               "required": true,
-              "desc": "The day of the month",
-              "__exemption": [ "examples" ]
+              "desc": "The day of the month"
             },
             "hour": {
               "type": "Number",
               "required": true,
-              "desc": "The hour",
-              "__exemption": [ "examples" ]
+              "desc": "The hour"
             },
             "minute": {
               "type": "Number",
               "required": true,
-              "desc": "The minute",
-              "__exemption": [ "examples" ]
+              "desc": "The minute"
             },
             "second": {
               "type": "Number",
               "required": true,
-              "desc": "The second",
-              "__exemption": [ "examples" ]
+              "desc": "The second"
             },
             "millisecond": {
               "type": "Number",
               "required": true,
-              "desc": "The millisecond",
-              "__exemption": [ "examples" ]
+              "desc": "The millisecond"
             },
             "changed": {
               "type": "Boolean",

package/src/components/timeline/QTimelineEntry.js

@@ -4,7 +4,7 @@ import QIcon from '../icon/QIcon.js'
 
 import { createComponent } from '../../utils/private/create.js'
 import { hSlot, hUniqueSlot } from '../../utils/private/render.js'
-import { timelineKey } from '../../utils/private/symbols.js'
+import { timelineKey, emptyRenderFn } from '../../utils/private/symbols.js'
 
 export default createComponent({
   name: 'QTimelineEntry',
@@ -32,9 +32,11 @@ export default createComponent({
   },
 
   setup (props, { slots }) {
-    const $timeline = inject(timelineKey, () => {
+    const $timeline = inject(timelineKey, emptyRenderFn)
+    if ($timeline === emptyRenderFn) {
       console.error('QTimelineEntry needs to be child of QTimeline')
-    })
+      return emptyRenderFn
+    }
 
     const classes = computed(() =>
       `q-timeline__entry q-timeline__entry--${ props.side }`

package/src/components/toolbar/QToolbar.js

@@ -16,6 +16,6 @@ export default createComponent({
       + (props.inset === true ? ' q-toolbar--inset' : '')
     )
 
-    return () => h('div', { class: classes.value }, hSlot(slots.default))
+    return () => h('div', { class: classes.value, role: 'toolbar' }, hSlot(slots.default))
   }
 })

package/src/components/tooltip/QTooltip.js

@@ -94,7 +94,7 @@ export default createComponent({
 
     const { registerTick, removeTick } = useTick()
     const { registerTimeout } = useTimeout()
-    const { transition, transitionStyle } = useTransition(props, showing)
+    const { transitionProps, transitionStyle } = useTransition(props)
     const { localScrollTarget, changeScrollEvent, unconfigureScrollTarget } = useScrollTarget(props, configureScrollTarget)
 
     const { anchorEl, canShow, anchorEvents } = useAnchor({ showing, configureAnchorEl })
@@ -285,16 +285,13 @@ export default createComponent({
             attrs.style,
             transitionStyle.value
           ],
-          role: 'complementary'
+          role: 'tooltip'
         }, hSlot(slots.default))
         : null
     }
 
     function renderPortalContent () {
-      return h(Transition, {
-        name: transition.value,
-        appear: true
-      }, getTooltipContent)
+      return h(Transition, transitionProps.value, getTooltipContent)
     }
 
     onBeforeUnmount(anchorCleanup)

package/src/components/tooltip/QTooltip.json

@@ -35,7 +35,6 @@
         "bottom left", "bottom middle", "bottom right", "bottom start", "bottom end"
       ],
       "default": "bottom middle",
-      "examples": [ "top left", "bottom right" ],
       "category": "position"
     },
 
@@ -48,7 +47,6 @@
         "bottom left", "bottom middle", "bottom right", "bottom start", "bottom end"
       ],
       "default": "top middle",
-      "examples": [ "top left", "bottom right" ],
       "category": "position"
     },
 
@@ -86,7 +84,6 @@
       "type": "Number",
       "desc": "Configure Tooltip to appear with delay",
       "default": 0,
-      "examples": [ ":delay=\"550\"" ],
       "category": "behavior"
     },
 
@@ -94,7 +91,6 @@
       "type": "Number",
       "desc": "Configure Tooltip to disappear with delay",
       "default": 0,
-      "examples": [ ":hide-delay=\"650\"" ],
       "category": "behavior"
     }
   },

package/src/components/tree/QTree.js

@@ -78,9 +78,9 @@ export default createComponent({
     'update:expanded',
     'update:ticked',
     'update:selected',
-    'lazy-load',
-    'after-show',
-    'after-hide'
+    'lazyLoad',
+    'afterShow',
+    'afterHide'
   ],
 
   setup (props, { slots, emit }) {
@@ -329,7 +329,7 @@ export default createComponent({
         if (Array.isArray(node[ props.childrenKey ]) !== true) {
           node[ props.childrenKey ] = []
         }
-        emit('lazy-load', {
+        emit('lazyLoad', {
           node,
           key,
           done: children => {
@@ -476,11 +476,11 @@ export default createComponent({
     }
 
     function onShow () {
-      emit('after-show')
+      emit('afterShow')
     }
 
     function onHide () {
-      emit('after-hide')
+      emit('afterHide')
     }
 
     function getNode (node) {

package/src/components/tree/QTree.json

@@ -147,13 +147,11 @@
       "params": {
         "node": {
           "type": "Object",
-          "desc": "Node currently being filtered",
-          "__exemption": [ "examples" ]
+          "desc": "Node currently being filtered"
         },
         "filter": {
           "type": "String",
-          "desc": "Filter text to match against",
-          "__exemption": [ "examples" ]
+          "desc": "Filter text to match against"
         }
       },
       "returns": {
@@ -167,7 +165,6 @@
       "type": "Number",
       "desc": "Toggle animation duration (in milliseconds)",
       "default": 300,
-      "examples": [ ":duration=\"500\"" ],
       "category": "style"
     },
 
@@ -207,13 +204,11 @@
         },
         "node": {
           "type": "Object",
-          "desc": "Node object",
-          "__exemption": [ "examples" ]
+          "desc": "Node object"
         },
         "key": {
           "type": "Any",
-          "desc": "Node's key",
-          "__exemption": [ "examples" ]
+          "desc": "Node's key"
         },
         "color": {
           "type": "String",
@@ -247,13 +242,11 @@
         },
         "node": {
           "type": "Object",
-          "desc": "Node object",
-          "__exemption": [ "examples" ]
+          "desc": "Node object"
         },
         "key": {
           "type": "Any",
-          "desc": "Node's key",
-          "__exemption": [ "examples" ]
+          "desc": "Node's key"
         },
         "color": {
           "type": "String",
@@ -287,13 +280,11 @@
         },
         "node": {
           "type": "Object",
-          "desc": "Node object",
-          "__exemption": [ "examples" ]
+          "desc": "Node object"
         },
         "key": {
           "type": "Any",
-          "desc": "Node's key",
-          "__exemption": [ "examples" ]
+          "desc": "Node's key"
         },
         "color": {
           "type": "String",
@@ -327,13 +318,11 @@
         },
         "node": {
           "type": "Object",
-          "desc": "Node object",
-          "__exemption": [ "examples" ]
+          "desc": "Node object"
         },
         "key": {
           "type": "Any",
-          "desc": "Node's key",
-          "__exemption": [ "examples" ]
+          "desc": "Node's key"
         },
         "color": {
           "type": "String",
@@ -370,8 +359,7 @@
             "node": {
               "type": "Object",
               "required": true,
-              "desc": "The node to which the new nodes (the children) will be appended",
-              "__exemption": [ "examples" ]
+              "desc": "The node to which the new nodes (the children) will be appended"
             },
             "key": {
               "type": "String",
@@ -387,8 +375,7 @@
                 "children": {
                   "type": "Array",
                   "desc": "Array of nodes",
-                  "default": "[]",
-                  "__exemption": [ "examples" ]
+                  "default": "[]"
                 }
               },
               "returns": null
@@ -449,8 +436,7 @@
       },
       "returns": {
         "type": "Object",
-        "desc": "Requested node",
-        "__exemption": [ "examples" ]
+        "desc": "Requested node"
       }
     },
 
@@ -458,8 +444,7 @@
       "desc": "Get array of nodes that are ticked",
       "returns": {
         "type": "Array",
-        "desc": "Ticked node objects",
-        "__exemption": [ "examples" ]
+        "desc": "Ticked node objects"
       }
     },
 
@@ -467,8 +452,7 @@
       "desc": "Get array of nodes that are expanded",
       "returns": {
         "type": "Array",
-        "desc": "Expanded node objects",
-        "__exemption": [ "examples" ]
+        "desc": "Expanded node objects"
       }
     },
 

package/src/components/uploader/QUploader.json

@@ -94,8 +94,7 @@
       "params": {
         "files": {
           "type": "Array",
-          "desc": "Array of files that were added",
-          "__exemption": ["examples"]
+          "desc": "Array of files that were added"
         }
       }
     },
@@ -105,8 +104,7 @@
       "params": {
         "files": {
           "type": "Array",
-          "desc": "Array of files that were removed",
-          "__exemption": ["examples"]
+          "desc": "Array of files that were removed"
         }
       }
     },
@@ -145,10 +143,9 @@
       "desc": "Remove specified file from the queue",
       "params": {
         "file": {
-          "type": "Object",
-          "desc": "File to remove (instance of File)",
-          "required": true,
-          "__exemption": ["examples"]
+          "type": "File",
+          "desc": "The file to remove",
+          "required": true
         }
       }
     },
@@ -157,10 +154,9 @@
       "desc": "Update the status of a file",
       "params": {
         "file": {
-          "type": "Object",
-          "desc": "File to update (instance of File)",
-          "required": true,
-          "__exemption": ["examples"]
+          "type": "File",
+          "desc": "The file to update",
+          "required": true
         },
         "status": {
           "type": "String",
@@ -171,8 +167,7 @@
         "uploadedSize": {
           "type": "Number",
           "desc": "The number of uploaded bytes of the file; Is required explicitly only when status is NOT 'uploaded'",
-          "required": true,
-          "__exemption": ["examples"]
+          "required": true
         }
       }
     },
@@ -211,26 +206,22 @@
   "computedProps": {
     "files": {
       "type": "Array",
-      "desc": "List of all files",
-      "__exemption": [ "examples" ]
+      "desc": "List of all files"
     },
 
     "queuedFiles": {
       "type": "Array",
-      "desc": "List of files that are waiting to be uploaded",
-      "__exemption": [ "examples" ]
+      "desc": "List of files that are waiting to be uploaded"
     },
 
     "uploadedFiles": {
       "type": "Array",
-      "desc": "List of files that have been uploaded",
-      "__exemption": [ "examples" ]
+      "desc": "List of files that have been uploaded"
     },
 
     "uploadedSize": {
       "type": "Number",
-      "desc": "Size of all uploaded files in bytes",
-      "examples": [ 1024 ]
+      "desc": "Size of all uploaded files in bytes"
     },
 
     "uploadSizeLabel": {

package/src/components/uploader/QUploaderAddTrigger.js

@@ -1,14 +1,18 @@
 import { inject } from 'vue'
 
 import { createComponent } from '../../utils/private/create.js'
-import { uploaderKey } from '../../utils/private/symbols.js'
+import { uploaderKey, emptyRenderFn } from '../../utils/private/symbols.js'
 
 export default createComponent({
   name: 'QUploaderAddTrigger',
 
   setup () {
-    return inject(uploaderKey, () => {
+    const $trigger = inject(uploaderKey, emptyRenderFn)
+
+    if ($trigger === emptyRenderFn) {
       console.error('QUploaderAddTrigger needs to be child of QUploader')
-    })
+    }
+
+    return $trigger
   }
 })

package/src/components/uploader/xhr-uploader-plugin.js

@@ -104,7 +104,7 @@ function injectPlugin ({ props, emit, helpers }) {
           helpers.queuedFiles.value = helpers.queuedFiles.value.concat(files)
           files.forEach(f => { helpers.updateFileStatus(f, 'failed') })
 
-          emit('factory-failed', err, files)
+          emit('factoryFailed', err, files)
           workingThreads.value--
         }
       }