quasar 2.9.2 → 2.10.1

package/src/components/pagination/QPagination.json

@@ -7,71 +7,28 @@
     "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",
+      "type": [ "Number", "String" ],
       "desc": "Minimum page (must be lower than 'max')",
       "default": 1,
-      "examples": [ 3 ],
       "category": "model"
     },
 
     "max": {
-      "type": "Number",
+      "type": [ "Number", "String" ],
       "desc": "Number of last page (must be higher than 'min')",
       "required": true,
-      "examples": [ 10 ],
       "category": "model"
     },
 
-    "color": {
-      "extends": "color",
-      "default": "primary"
-    },
-
-    "text-color": {
-      "extends": "text-color"
-    },
-
-    "active-color": {
-      "extends": "color",
-      "default": "primary"
-    },
-
-    "active-text-color": {
-      "extends": "text-color"
-    },
-
     "dark": {
       "extends": "dark",
       "desc": "Notify the component that the background is a dark color (useful when you are using it along with the 'input' prop)"
     },
 
-    "input-style": {
-      "type": [ "String", "Array", "Object" ],
-      "tsType": "VueStyleProp",
-      "desc": "Style definitions to be attributed to the input (if using one)",
-      "examples": [
-        "background-color: #ff0000",
-        ":input-style=\"{ backgroundColor: '#ff0000' }\""
-      ],
-      "category": "style"
-    },
-
-    "input-class": {
-      "type": [ "String", "Array", "Object" ],
-      "tsType": "VueClassProp",
-      "desc": "Class definitions to be attributed to the input (if using one)",
-      "examples": [
-        "my-special-class",
-        ":input-class=\"{ 'my-special-class': <condition> }\""
-      ],
-      "category": "style"
-    },
-
     "size": {
       "type": "String",
       "desc": "Button size in CSS units, including unit name",
@@ -111,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"
@@ -149,54 +104,75 @@
     },
 
     "max-pages": {
-      "type": "Number",
+      "type": [ "Number", "String" ],
       "default": 0,
       "desc": "Maximum number of page links to display at a time; 0 means Infinite",
-      "examples": [ 5 ],
-      "category": "model"
+      "category": "content"
     },
 
-    "ripple": {
-      "type": [ "Boolean", "Object" ],
-      "desc": "Configure buttons material ripple (disable it by setting it to 'false' or supply a config object); Does not applies to boundary and ellipsis buttons",
-      "default": true,
-      "examples": [ false, "{ early: true, center: true, color: 'teal', keyCodes: [] }" ],
+    "flat": {
+      "type": "Boolean",
+      "desc": "Use 'flat' design for non-active buttons (it's the default option)",
       "category": "style"
     },
 
-    "round": {
+    "outline": {
       "type": "Boolean",
-      "desc": "Makes a circle shaped button for all buttons",
+      "desc": "Use 'outline' design for non-active buttons",
       "category": "style"
     },
 
-    "rounded": {
+    "unelevated": {
       "type": "Boolean",
-      "desc": "Applies a more prominent border-radius for a squared shape button for all buttons",
+      "desc": "Remove shadow for non-active buttons",
       "category": "style"
     },
 
-    "flat": {
+    "push": {
       "type": "Boolean",
-      "desc": "Use 'flat' design for current page button",
+      "desc": "Use 'push' design for non-active buttons",
       "category": "style"
     },
 
-    "outline": {
-      "type": "Boolean",
-      "desc": "Use 'outline' design for current page button",
-      "category": "style"
+    "color": {
+      "extends": "color",
+      "desc": "Color name from the Quasar Color Palette for the non-active buttons",
+      "default": "primary"
     },
 
-    "unelevated": {
+    "text-color": {
+      "extends": "text-color",
+      "desc": "Text color name from the Quasar Color Palette for the ACTIVE buttons"
+    },
+
+    "active-design": {
+      "type": "String",
+      "desc": "The design of the ACTIVE button, similar to the flat/outline/push/unelevated props (but those are used for non-active buttons)",
+      "values": [ "flat", "outline", "push", "unelevated" ],
+      "category": "style",
+      "addedIn": "v2.10"
+    },
+
+    "active-color": {
+      "extends": "color",
+      "desc": "Color name from the Quasar Color Palette for the ACTIVE button",
+      "default": "primary"
+    },
+
+    "active-text-color": {
+      "extends": "text-color",
+      "desc": "Text color name from the Quasar Color Palette for the ACTIVE button"
+    },
+
+    "round": {
       "type": "Boolean",
-      "desc": "Remove shadow for current page button",
+      "desc": "Makes a circle shaped button for all buttons",
       "category": "style"
     },
 
-    "push": {
+    "rounded": {
       "type": "Boolean",
-      "desc": "Use 'push' design for current page button",
+      "desc": "Applies a more prominent border-radius for a squared shape button for all buttons",
       "category": "style"
     },
 
@@ -206,8 +182,13 @@
       "category": "style"
     },
 
-    "dense": {
-      "extends": "dense"
+    "gutter": {
+      "type": "String",
+      "desc": "Apply custom gutter; Size in CSS units, including unit name or standard size name (none|xs|sm|md|lg|xl)",
+      "default": "2px",
+      "examples": [ "16px", "10px 5px", "2rem", "xs", "md lg", "2px 2px 5px 7px" ],
+      "category": "style",
+      "addedIn": "v2.10"
     },
 
     "padding": {
@@ -215,6 +196,36 @@
       "desc": "Apply custom padding (vertical [horizontal]); Size in CSS units, including unit name or standard size name (none|xs|sm|md|lg|xl); Also removes the min width and height when set",
       "examples": [ "16px", "10px 5px", "2rem", "xs", "md lg", "2px 2px 5px 7px" ],
       "category": "style"
+    },
+
+    "input-style": {
+      "type": [ "String", "Array", "Object" ],
+      "tsType": "VueStyleProp",
+      "desc": "Style definitions to be attributed to the input (if using one)",
+      "examples": [
+        "background-color: #ff0000",
+        ":input-style=\"{ backgroundColor: '#ff0000' }\""
+      ],
+      "category": "style"
+    },
+
+    "input-class": {
+      "type": [ "String", "Array", "Object" ],
+      "tsType": "VueClassProp",
+      "desc": "Class definitions to be attributed to the input (if using one)",
+      "examples": [
+        "my-special-class",
+        ":input-class=\"{ 'my-special-class': <condition> }\""
+      ],
+      "category": "style"
+    },
+
+    "ripple": {
+      "type": [ "Boolean", "Object" ],
+      "desc": "Configure buttons material ripple (disable it by setting it to 'false' or supply a config object); Does not applies to boundary and ellipsis buttons",
+      "default": true,
+      "examples": [ false, "{ early: true, center: true, color: 'teal', keyCodes: [] }" ],
+      "category": "style"
     }
   },
 
@@ -235,8 +246,7 @@
       "params": {
         "pageNumber": {
           "type": "Number",
-          "desc": "Page number to go to",
-          "examples": [ 3 ]
+          "desc": "Page number to go to"
         }
       }
     },
@@ -246,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/pagination/QPagination.sass

@@ -1,3 +1,4 @@
+
 .q-pagination
   input
     text-align: center
@@ -7,3 +8,16 @@
   input::-webkit-inner-spin-button
     -webkit-appearance: none
     margin: 0
+
+  &__content
+    --q-pagination-gutter-parent: -2px
+    --q-pagination-gutter-child: 2px
+
+    margin-top: var(--q-pagination-gutter-parent)
+    margin-left: var(--q-pagination-gutter-parent)
+
+  &__content > .q-btn,
+  &__content > .q-input,
+  &__middle > .q-btn
+    margin-top: var(--q-pagination-gutter-child)
+    margin-left: var(--q-pagination-gutter-child)

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.js

@@ -58,17 +58,21 @@ export default createComponent({
     if (hasObserver === true) {
       let observer
 
-      onMounted(() => {
-        nextTick(() => {
-          targetEl = proxy.$el.parentNode
+      // initialize as soon as possible
+      const init = stop => {
+        targetEl = proxy.$el.parentNode
 
-          if (targetEl) {
-            observer = new ResizeObserver(trigger)
-            observer.observe(targetEl)
-            emitEvent()
-          }
-        })
-      })
+        if (targetEl) {
+          observer = new ResizeObserver(trigger)
+          observer.observe(targetEl)
+          emitEvent()
+        }
+        else if (stop !== true) {
+          nextTick(() => { init(true) })
+        }
+      }
+
+      onMounted(() => { init() })
 
       onBeforeUnmount(() => {
         clearTimeout(timer)

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
         )
       }