quasar 2.10.0 → 2.10.1

package/src/components/menu/QMenu.js

@@ -79,7 +79,7 @@ export default createComponent({
 
   emits: [
     ...useModelToggleEmits,
-    'click', 'escape-key'
+    'click', 'escapeKey'
   ],
 
   setup (props, { slots, emit, attrs }) {
@@ -100,7 +100,7 @@ export default createComponent({
     const isDark = useDark(props, $q)
     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 } = useAnchor({ showing })
@@ -180,7 +180,10 @@ export default createComponent({
         let node = innerRef.value
 
         if (node && node.contains(document.activeElement) !== true) {
-          node = node.querySelector('[autofocus], [data-autofocus]') || node
+          node = node.querySelector('[autofocus][tabindex], [data-autofocus][tabindex]')
+            || node.querySelector('[autofocus] [tabindex], [data-autofocus] [tabindex]')
+            || node.querySelector('[autofocus], [data-autofocus]')
+            || node
           node.focus({ preventScroll: true })
         }
       })
@@ -317,7 +320,7 @@ export default createComponent({
     }
 
     function onEscapeKey (evt) {
-      emit('escape-key')
+      emit('escapeKey')
       hide(evt)
     }
 
@@ -345,7 +348,7 @@ export default createComponent({
     function renderPortalContent () {
       return h(
         Transition,
-        { name: transition.value, appear: true },
+        transitionProps.value,
         () => (
           showing.value === true
             ? h('div', {

package/src/components/menu/QMenu.json

@@ -30,7 +30,6 @@
         "center left", "center middle", "center right", "center start", "center end",
         "bottom left", "bottom middle", "bottom right", "bottom start", "bottom end"
       ],
-      "examples": [ "top left", "bottom right" ],
       "category": "position"
     },
 
@@ -42,7 +41,6 @@
         "center left", "center middle", "center right", "center start", "center end",
         "bottom left", "bottom middle", "bottom right", "bottom start", "bottom end"
       ],
-      "examples": [ "top left", "bottom right" ],
       "category": "position"
     },
 

package/src/components/option-group/QOptionGroup.json

@@ -56,7 +56,6 @@
       "desc": "The type of input component to be used",
       "values": [ "radio", "checkbox", "toggle" ],
       "default": "radio",
-      "examples": [ "checkbox" ],
       "category": "content"
     },
 
@@ -124,8 +123,7 @@
               "desc": "Any other props from QToggle, QCheckbox, or QRadio",
               "examples": [ "val=\"car\"", ":true-value=\"trueValue\"", "checked-icon=\"visibility\"" ]
             }
-          },
-          "__exemption": [ "examples" ]
+          }
         }
       },
       "addedIn": "v2.2"
@@ -159,8 +157,7 @@
               "desc": "Any other props from QToggle, QCheckbox, or QRadio",
               "examples": [ "val=\"car\"", ":true-value=\"trueValue\"", "checked-icon=\"visibility\"" ]
             }
-          },
-          "__exemption": [ "examples" ]
+          }
         }
       },
       "addedIn": "v2.2"

package/src/components/page/QPage.json

@@ -16,19 +16,16 @@
       "params": {
         "offset": {
           "type": "Number",
-          "desc": "Header + Footer height (in pixels)",
-          "examples": [ 152 ]
+          "desc": "Header + Footer height (in pixels)"
         },
         "height": {
           "type": "Number",
-          "desc": "Value in pixels of container height (if containerized) or window height otherwise",
-          "examples": [ 1200 ]
+          "desc": "Value in pixels of container height (if containerized) or window height otherwise"
         }
       },
       "returns": {
         "type": "Object",
-        "desc": "Object with CSS properties to apply to Page DOM element",
-        "__exemption": [ "examples" ]
+        "desc": "Object with CSS properties to apply to Page DOM element"
       },
       "default": "(see source code)",
       "examples": [ "(see source code)" ],

package/src/components/page-scroller/QPageScroller.json

@@ -10,7 +10,6 @@
       "type": "Number",
       "desc": "Scroll offset (in pixels) from which point the component is shown on page; Measured from the top of the page (or from the bottom if in 'reverse' mode)",
       "default": 1000,
-      "examples": [ 550 ],
       "category": "behavior"
     },
 
@@ -24,7 +23,6 @@
       "type": "Number",
       "desc": "Duration (in milliseconds) of the scrolling until it reaches its target",
       "default": 300,
-      "examples": [ 500 ],
       "category": "behavior"
     },
 

package/src/components/page-sticky/QPageSticky.json

@@ -13,7 +13,6 @@
         "bottom-right", "bottom-left",
         "top", "right", "bottom", "left"
       ],
-      "examples": [ "top-right" ],
       "category": "position"
     },
 

package/src/components/pagination/QPagination.json

@@ -7,15 +7,13 @@
     "model-value": {
       "extends": "model-value",
       "type": "Number",
-      "desc": "Current page (must be between min/max)",
-      "examples": [ 3 ]
+      "desc": "Current page (must be between min/max)"
     },
 
     "min": {
       "type": [ "Number", "String" ],
       "desc": "Minimum page (must be lower than 'max')",
       "default": 1,
-      "examples": [ 3 ],
       "category": "model"
     },
 
@@ -23,7 +21,6 @@
       "type": [ "Number", "String" ],
       "desc": "Number of last page (must be higher than 'min')",
       "required": true,
-      "examples": [ 10 ],
       "category": "model"
     },
 
@@ -71,14 +68,12 @@
       "params": {
         "page": {
           "type": "Number",
-          "desc": "Page number to navigate to",
-          "examples": [ 2 ]
+          "desc": "Page number to navigate to"
         }
       },
       "returns": {
         "type": [ "Object", "String" ],
-        "desc": "Object or String that can be passed to a <router-link> as `to` parameter",
-        "__exemption": [ "examples" ]
+        "desc": "Object or String that can be passed to a <router-link> as `to` parameter"
       },
       "examples": [ ":to-fn=\"page => ({ query: { page } })\"" ],
       "category": "content"
@@ -112,7 +107,6 @@
       "type": [ "Number", "String" ],
       "default": 0,
       "desc": "Maximum number of page links to display at a time; 0 means Infinite",
-      "examples": [ 5 ],
       "category": "content"
     },
 
@@ -252,8 +246,7 @@
       "params": {
         "pageNumber": {
           "type": "Number",
-          "desc": "Page number to go to",
-          "examples": [ 3 ]
+          "desc": "Page number to go to"
         }
       }
     },
@@ -263,8 +256,7 @@
       "params": {
         "offset": {
           "type": "Number",
-          "desc": "Offset page, can be negative or positive",
-          "examples": [ 3 ]
+          "desc": "Offset page, can be negative or positive"
         }
       }
     }

package/src/components/parallax/QParallax.json

@@ -21,14 +21,12 @@
       "type": "Number",
       "desc": "Height of component (in pixels)",
       "default": 500,
-      "examples": [ ":height=\"1000\"" ],
       "category": "style"
     },
 
     "speed": {
       "type": "Number",
       "desc": "Speed of parallax effect (0.0 < x < 1.0)",
-      "examples": [ ":speed=\"0.24\"" ],
       "category": "behavior"
     },
 
@@ -51,8 +49,7 @@
       "scope": {
         "percentScrolled": {
           "type": "Number",
-          "desc": "Percentage (0.0 < x < 1.0) of scroll in regards to QParallax",
-          "examples": [ 0.241 ]
+          "desc": "Percentage (0.0 < x < 1.0) of scroll in regards to QParallax"
         }
       }
     }
@@ -64,8 +61,7 @@
       "params": {
         "percentage": {
           "type": "Number",
-          "desc": "Number between 0.0 and 1.0 defining the scrolled percentage of the component",
-          "examples": [ 0.234 ]
+          "desc": "Number between 0.0 and 1.0 defining the scrolled percentage of the component"
         }
       }
     }

package/src/components/popup-edit/QPopupEdit.js

@@ -43,7 +43,7 @@ export default createComponent({
 
   emits: [
     'update:modelValue', 'save', 'cancel',
-    'before-show', 'show', 'before-hide', 'hide'
+    'beforeShow', 'show', 'beforeHide', 'hide'
   ],
 
   setup (props, { slots, emit }) {
@@ -107,7 +107,7 @@ export default createComponent({
       validated = false
       initialValue.value = clone(props.modelValue)
       currentModel.value = clone(props.modelValue)
-      emit('before-show')
+      emit('beforeShow')
     }
 
     function onShow () {
@@ -125,7 +125,7 @@ export default createComponent({
         }
       }
 
-      emit('before-hide')
+      emit('beforeHide')
     }
 
     function onHide () {

package/src/components/popup-edit/QPopupEdit.json

@@ -93,7 +93,6 @@
         "center left", "center middle", "center right", "center start", "center end",
         "bottom left", "bottom middle", "bottom right", "bottom start", "bottom end"
       ],
-      "examples": [ "top left", "bottom right" ],
       "category": "position"
     },
 
@@ -105,7 +104,6 @@
         "center left", "center middle", "center right", "center start", "center end",
         "bottom left", "bottom middle", "bottom right", "bottom start", "bottom end"
       ],
-      "examples": [ "top left", "bottom right" ],
       "category": "position"
     },
 
@@ -232,13 +230,11 @@
       "params": {
         "value": {
           "type": "Any",
-          "desc": "Validated value to be saved",
-          "__exemption": [ "examples" ]
+          "desc": "Validated value to be saved"
         },
         "initialValue": {
           "type": "Any",
-          "desc": "Initial value, before changes",
-          "__exemption": [ "examples" ]
+          "desc": "Initial value, before changes"
         }
       }
     },
@@ -248,13 +244,11 @@
       "params": {
         "value": {
           "type": "Any",
-          "desc": "Edited value",
-          "__exemption": [ "examples" ]
+          "desc": "Edited value"
         },
         "initialValue": {
           "type": "Any",
-          "desc": "Initial value, before changes",
-          "__exemption": [ "examples" ]
+          "desc": "Initial value, before changes"
         }
       }
     }

package/src/components/popup-proxy/QPopupProxy.json

@@ -17,7 +17,6 @@
       "type": [ "Number", "String" ],
       "desc": "Breakpoint (in pixels) of window width/height (whichever is smaller) from where a Menu will get to be used instead of a Dialog",
       "default": 450,
-      "examples": [ 992, ":breakpoint=\"1024\"" ],
       "category": "behavior"
     }
   },

package/src/components/radio/QRadio.json

@@ -89,8 +89,7 @@
         "value": {
           "type": "Any",
           "desc": "New model value",
-          "required": true,
-          "__exemption": [ "examples" ]
+          "required": true
         },
         "evt": {
           "extends": "evt",

package/src/components/range/QRange.json

@@ -13,13 +13,11 @@
       "definition": {
         "min": {
           "type": [ "Number", "null" ],
-          "desc": "Model value for left thumb",
-          "examples": [ 2 ]
+          "desc": "Model value for left thumb"
         },
         "max": {
           "type": [ "Number", "null" ],
-          "desc": "Model value for right thumb",
-          "examples": [ 12 ]
+          "desc": "Model value for right thumb"
         }
       },
       "examples": [ "v-model=\"positionModel\"" ]

package/src/components/rating/QRating.json

@@ -16,7 +16,6 @@
       "type": [ "Number", "String" ],
       "desc": "Number of icons to display",
       "default": 5,
-      "examples": [ "3", ":max=\"5\"" ],
       "category": "general"
     },
 

package/src/components/resize-observer/QResizeObserver.json

@@ -24,14 +24,12 @@
             "height": {
               "type": "Number",
               "required": true,
-              "desc": "Layout height",
-              "examples": [ 822 ]
+              "desc": "Layout height"
             },
             "width": {
               "type": "Number",
               "required": true,
-              "desc": "Layout width",
-              "examples": [ 822 ]
+              "desc": "Layout width"
             }
           }
         }

package/src/components/scroll-area/QScrollArea.js

@@ -1,4 +1,4 @@
-import { h, ref, computed, withDirectives, onActivated, onDeactivated, onBeforeUnmount, getCurrentInstance } from 'vue'
+import { h, ref, computed, watch, withDirectives, onActivated, onDeactivated, onBeforeUnmount, getCurrentInstance } from 'vue'
 
 import useDark, { useDarkProps } from '../../composables/private/use-dark.js'
 
@@ -142,7 +142,7 @@ export default createComponent({
     scroll.horizontal.percentage = computed(() => {
       const diff = scroll.horizontal.size.value - container.horizontal.value
       if (diff <= 0) { return 0 }
-      const p = between(scroll.horizontal.position.value / diff, 0, 1)
+      const p = between(Math.abs(scroll.horizontal.position.value) / diff, 0, 1)
       return Math.round(p * 10000) / 10000
     })
     scroll.horizontal.thumbHidden = computed(() =>
@@ -168,7 +168,7 @@ export default createComponent({
       return {
         ...props.thumbStyle,
         ...props.horizontalThumbStyle,
-        left: `${ scroll.horizontal.thumbStart.value }px`,
+        [ proxy.$q.lang.rtl === true ? 'right' : 'left' ]: `${ scroll.horizontal.thumbStart.value }px`,
         width: `${ scroll.horizontal.thumbSize.value }px`
       }
     })
@@ -362,6 +362,15 @@ export default createComponent({
 
     let scrollPosition = null
 
+    watch(() => proxy.$q.lang.rtl, rtl => {
+      if (targetRef.value !== null) {
+        setHorizontalScrollPosition(
+          targetRef.value,
+          Math.abs(scroll.horizontal.position.value) * (rtl === true ? -1 : 1)
+        )
+      }
+    })
+
     onDeactivated(() => {
       scrollPosition = {
         top: scroll.vertical.position.value,
@@ -398,7 +407,9 @@ export default createComponent({
       setScrollPercentage (axis, percentage, duration) {
         localSetScrollPosition(
           axis,
-          percentage * (scroll[ axis ].size.value - container[ axis ].value),
+          percentage
+            * (scroll[ axis ].size.value - container[ axis ].value)
+            * (axis === 'horizontal' && proxy.$q.lang.rtl === true ? -1 : 1),
           duration
         )
       }

package/src/components/scroll-area/QScrollArea.json

@@ -82,7 +82,6 @@
       "type": [ "Number", "String" ],
       "desc": "When content changes, the scrollbar appears; this delay defines the amount of time (in milliseconds) before scrollbars disappear again (if component is not hovered)",
       "default": 1000,
-      "examples": [ 500, ":delay=\"550\"" ],
       "category": "behavior"
     },
 
@@ -115,51 +114,43 @@
             "verticalPosition": {
               "type": "Number",
               "required": true,
-              "desc": "Vertical scroll position (in px)",
-              "__exemption": [ "examples" ]
+              "desc": "Vertical scroll position (in px)"
             },
             "verticalPercentage": {
               "type": "Number",
               "required": true,
-              "desc": "Vertical scroll percentage (0.0 <= x <= 1.0)",
-              "__exemption": [ "examples" ]
+              "desc": "Vertical scroll percentage (0.0 <= x <= 1.0)"
             },
             "verticalSize": {
               "type": "Number",
               "required": true,
-              "desc": "Vertical scroll size (in px)",
-              "__exemption": [ "examples" ]
+              "desc": "Vertical scroll size (in px)"
             },
             "verticalContainerSize": {
               "type": "Number",
               "required": true,
-              "desc": "Height of the container (in px)",
-              "__exemption": [ "examples" ]
+              "desc": "Height of the container (in px)"
             },
 
             "horizontalPosition": {
               "type": "Number",
               "required": true,
-              "desc": "Horizontal scroll position (in px)",
-              "__exemption": [ "examples" ]
+              "desc": "Horizontal scroll position (in px)"
             },
             "horizontalPercentage": {
               "type": "Number",
               "required": true,
-              "desc": "Horizontal scroll percentage (0.0 <= x <= 1.0)",
-              "__exemption": [ "examples" ]
+              "desc": "Horizontal scroll percentage (0.0 <= x <= 1.0)"
             },
             "horizontalSize": {
               "type": "Number",
               "required": true,
-              "desc": "Horizontal scroll size (in px)",
-              "__exemption": [ "examples" ]
+              "desc": "Horizontal scroll size (in px)"
             },
             "horizontalContainerSize": {
               "type": "Number",
               "required": true,
-              "desc": "Width of the container (in px)",
-              "__exemption": [ "examples" ]
+              "desc": "Width of the container (in px)"
             }
           }
         }
@@ -181,56 +172,47 @@
       "returns": {
         "type": "Object",
         "desc": "Scroll information",
-        "__exemption": [ "examples" ],
         "definition": {
           "verticalPosition": {
             "type": "Number",
             "required": true,
-            "desc": "Vertical scroll position (in px)",
-            "__exemption": [ "examples" ]
+            "desc": "Vertical scroll position (in px)"
           },
           "verticalPercentage": {
             "type": "Number",
             "required": true,
-            "desc": "Vertical scroll percentage (0.0 <= x <= 1.0)",
-            "__exemption": [ "examples" ]
+            "desc": "Vertical scroll percentage (0.0 <= x <= 1.0)"
           },
           "verticalSize": {
             "type": "Number",
             "required": true,
-            "desc": "Vertical scroll size (in px)",
-            "__exemption": [ "examples" ]
+            "desc": "Vertical scroll size (in px)"
           },
           "verticalContainerSize": {
             "type": "Number",
             "required": true,
-            "desc": "Height of the container (in px)",
-            "__exemption": [ "examples" ]
+            "desc": "Height of the container (in px)"
           },
 
           "horizontalPosition": {
             "type": "Number",
             "required": true,
-            "desc": "Horizontal scroll position (in px)",
-            "__exemption": [ "examples" ]
+            "desc": "Horizontal scroll position (in px)"
           },
           "horizontalPercentage": {
             "type": "Number",
             "required": true,
-            "desc": "Horizontal scroll percentage (0.0 <= x <= 1.0)",
-            "__exemption": [ "examples" ]
+            "desc": "Horizontal scroll percentage (0.0 <= x <= 1.0)"
           },
           "horizontalSize": {
             "type": "Number",
             "required": true,
-            "desc": "Horizontal scroll size (in px)",
-            "__exemption": [ "examples" ]
+            "desc": "Horizontal scroll size (in px)"
           },
           "horizontalContainerSize": {
             "type": "Number",
             "required": true,
-            "desc": "Width of the container (in px)",
-            "__exemption": [ "examples" ]
+            "desc": "Width of the container (in px)"
           }
         }
       }
@@ -245,14 +227,12 @@
           "top": {
             "type": "Number",
             "required": true,
-            "desc": "Scroll offset from top (vertical)",
-            "examples": [ 120 ]
+            "desc": "Scroll offset from top (vertical)"
           },
           "left": {
             "type": "Number",
             "required": true,
-            "desc": "Scroll offset from left (horizontal)",
-            "examples": [ 10 ]
+            "desc": "Scroll offset from left (horizontal)"
           }
         },
         "examples": [ "{ top: 10, left: 0 }" ]
@@ -268,14 +248,12 @@
           "top": {
             "type": "Number",
             "required": true,
-            "desc": "Scroll percentage (0.0 <= x <= 1.0) offset from top (vertical)",
-            "examples": [ 0.12 ]
+            "desc": "Scroll percentage (0.0 <= x <= 1.0) offset from top (vertical)"
           },
           "left": {
             "type": "Number",
             "required": true,
-            "desc": "Scroll percentage (0.0 <= x <= 1.0) offset from left (horizontal)",
-            "examples": [ 0.92 ]
+            "desc": "Scroll percentage (0.0 <= x <= 1.0) offset from left (horizontal)"
           }
         },
         "examples": [ "{ top: 0.212, left: 0 }" ]
@@ -294,13 +272,11 @@
         "offset": {
           "type": "Number",
           "required": true,
-          "desc": "Scroll position offset from top (in pixels)",
-          "examples": [ 220 ]
+          "desc": "Scroll position offset from top (in pixels)"
         },
         "duration": {
           "type": "Number",
-          "desc": "Duration (in milliseconds) enabling animated scroll",
-          "examples": [ 300 ]
+          "desc": "Duration (in milliseconds) enabling animated scroll"
         }
       }
     },
@@ -317,13 +293,11 @@
         "offset": {
           "type": "Number",
           "desc": "Scroll percentage (0.0 <= x <= 1.0) of the total scrolling size",
-          "required": true,
-          "examples": [ 220 ]
+          "required": true
         },
         "duration": {
           "type": "Number",
-          "desc": "Duration (in milliseconds) enabling animated scroll",
-          "examples": [ 300 ]
+          "desc": "Duration (in milliseconds) enabling animated scroll"
         }
       }
     }

package/src/components/scroll-observer/QScrollObserver.js

@@ -119,6 +119,8 @@ export default createComponent({
 
     const { proxy } = getCurrentInstance()
 
+    watch(() => proxy.$q.lang.rtl, emitEvent)
+
     onMounted(() => {
       parentEl = proxy.$el.parentNode
       configureScrollTarget()