quasar 2.3.3 → 2.4.2

package/dist/api/Dialog.json

@@ -375,7 +375,7 @@
               "required": false
             },
             "component": {
-              "type": "Any",
+              "type": "Component",
               "desc": "Use custom dialog component; use along with 'componentProps' prop where possible"
             },
             "componentProps": {

package/dist/api/Loading.json

@@ -23,10 +23,8 @@
       },
       "html": {
         "type": "Boolean",
-        "default": "false",
         "desc": "Force render the message as HTML; This can lead to XSS attacks so make sure that you sanitize the content",
-        "category": "behavior",
-        "required": false
+        "category": "behavior"
       },
       "boxClass": {
         "type": "String",
@@ -117,10 +115,8 @@
             },
             "html": {
               "type": "Boolean",
-              "default": "false",
               "desc": "Render the message as HTML; This can lead to XSS attacks so make sure that you sanitize the message first",
-              "category": "behavior",
-              "required": false
+              "category": "behavior"
             },
             "boxClass": {
               "type": "String",

package/dist/api/QBreadcrumbsEl.json

@@ -9,38 +9,59 @@
         "String",
         "Object"
       ],
-      "desc": "Equivalent to Vue Router <router-link> 'to' property",
+      "desc": "Equivalent to Vue Router <router-link> 'to' property; Superseeded by 'href' prop if used",
       "examples": [
         "/home/dashboard",
         ":to=\"{ name: 'my-route-name' }\""
       ],
-      "category": "behavior"
+      "category": "navigation"
     },
     "exact": {
       "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'exact' property",
-      "category": "behavior"
+      "desc": "Equivalent to Vue Router <router-link> 'exact' property; Superseeded by 'href' prop if used",
+      "category": "navigation"
     },
     "replace": {
       "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'replace' property",
-      "category": "behavior"
+      "desc": "Equivalent to Vue Router <router-link> 'replace' property; Superseeded by 'href' prop if used",
+      "category": "navigation"
     },
     "active-class": {
       "type": "String",
-      "desc": "Equivalent to Vue Router <router-link> 'active-class' property",
+      "desc": "Equivalent to Vue Router <router-link> 'active-class' property; Superseeded by 'href' prop if used",
       "examples": [
         "my-active-class"
       ],
-      "category": "behavior"
+      "category": "navigation"
     },
     "exact-active-class": {
       "type": "String",
-      "desc": "Equivalent to Vue Router <router-link> 'active-class' property",
+      "desc": "Equivalent to Vue Router <router-link> 'active-class' property; Superseeded by 'href' prop if used",
       "examples": [
         "my-exact-active-class"
       ],
-      "category": "behavior"
+      "category": "navigation"
+    },
+    "href": {
+      "type": "String",
+      "desc": "Native <a> link href attribute; Has priority over the 'to'/'exact'/'replace'/'active-class'/'exact-active-class' props",
+      "examples": [
+        "http://quasar.dev"
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
+    },
+    "target": {
+      "type": "String",
+      "desc": "Native <a> link target attribute; Use it only along with 'href' prop; Has priority over the 'to'/'exact'/'replace'/'active-class'/'exact-active-class' props",
+      "examples": [
+        "_blank",
+        "_self",
+        "_parent",
+        "_top"
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
     },
     "disable": {
       "type": "Boolean",

package/dist/api/QBtn.json

@@ -17,16 +17,15 @@
     },
     "type": {
       "type": "String",
-      "desc": "Define the button HTML DOM type",
+      "desc": "1) Define the button native type attribute (submit, reset, button) or 2) render component with <a> tag so you can access events even if disable or 3) Use 'href' prop and specify 'type' as a media tag",
       "default": "button",
-      "values": [
+      "examples": [
         "a",
         "submit",
         "button",
-        "reset"
-      ],
-      "examples": [
-        "type=\"a\" href=\"http://some-site.net\" target=\"__blank\""
+        "reset",
+        "image/png",
+        "href=\"https://quasar.dev\" target=\"_blank\""
       ],
       "category": "general",
       "required": false
@@ -36,22 +35,39 @@
         "String",
         "Object"
       ],
-      "desc": "Equivalent to Vue Router <router-link> 'to' property",
+      "desc": "Equivalent to Vue Router <router-link> 'to' property; Superseeded by 'href' prop if used",
       "examples": [
         "/home/dashboard",
         ":to=\"{ name: 'my-route-name' }\""
       ],
-      "category": "router"
+      "category": "navigation"
     },
     "replace": {
       "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'replace' property",
-      "category": "router"
+      "desc": "Equivalent to Vue Router <router-link> 'replace' property; Superseeded by 'href' prop if used",
+      "category": "navigation"
     },
-    "append": {
-      "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'append' property",
-      "category": "router"
+    "href": {
+      "type": "String",
+      "desc": "Native <a> link href attribute; Has priority over the 'to' and 'replace' props",
+      "examples": [
+        "http://quasar.dev",
+        "href=\"https://quasar.dev\" target=\"_blank\""
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
+    },
+    "target": {
+      "type": "String",
+      "desc": "Native <a> link target attribute; Use it only with 'to' or 'href' props",
+      "examples": [
+        "_blank",
+        "_self",
+        "_parent",
+        "_top"
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
     },
     "label": {
       "type": [

package/dist/api/QBtnDropdown.json

@@ -6,7 +6,7 @@
   "props": {
     "model-value": {
       "desc": "Controls Menu show/hidden state; Either use this property (along with a listener for 'update:modelValue' event) OR use v-model directive",
-      "required": true,
+      "required": false,
       "category": "model",
       "type": "Boolean",
       "examples": [
@@ -26,16 +26,15 @@
     },
     "type": {
       "type": "String",
-      "desc": "Define the button HTML DOM type",
+      "desc": "1) Define the button native type attribute (submit, reset, button) or 2) render component with <a> tag so you can access events even if disable or 3) Use 'href' prop and specify 'type' as a media tag",
       "default": "button",
-      "values": [
+      "examples": [
         "a",
         "submit",
         "button",
-        "reset"
-      ],
-      "examples": [
-        "type=\"a\" href=\"http://some-site.net\" target=\"__blank\""
+        "reset",
+        "image/png",
+        "href=\"https://quasar.dev\" target=\"_blank\""
       ],
       "category": "general",
       "required": false
@@ -45,22 +44,39 @@
         "String",
         "Object"
       ],
-      "desc": "Equivalent to Vue Router <router-link> 'to' property",
+      "desc": "Equivalent to Vue Router <router-link> 'to' property; Superseeded by 'href' prop if used",
       "examples": [
         "/home/dashboard",
         ":to=\"{ name: 'my-route-name' }\""
       ],
-      "category": "router"
+      "category": "navigation"
     },
     "replace": {
       "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'replace' property",
-      "category": "router"
+      "desc": "Equivalent to Vue Router <router-link> 'replace' property; Superseeded by 'href' prop if used",
+      "category": "navigation"
     },
-    "append": {
-      "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'append' property",
-      "category": "router"
+    "href": {
+      "type": "String",
+      "desc": "Native <a> link href attribute; Has priority over the 'to' and 'replace' props",
+      "examples": [
+        "http://quasar.dev",
+        "href=\"https://quasar.dev\" target=\"_blank\""
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
+    },
+    "target": {
+      "type": "String",
+      "desc": "Native <a> link target attribute; Use it only with 'to' or 'href' props",
+      "examples": [
+        "_blank",
+        "_self",
+        "_parent",
+        "_top"
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
     },
     "label": {
       "type": [

package/dist/api/QBtnToggle.json

@@ -231,6 +231,9 @@
   "slots": {
     "default": {
       "desc": "Suggestions: QTooltip, QBadge"
+    },
+    "...": {
+      "desc": "Any other dynamic slots to be used with 'slot' property of the 'options' prop"
     }
   },
   "events": {

package/dist/api/QChatMessage.json

@@ -85,31 +85,23 @@
     },
     "label-html": {
       "type": "Boolean",
-      "default": "false",
       "desc": "Render the label as HTML; This can lead to XSS attacks so make sure that you sanitize the message first",
-      "category": "behavior",
-      "required": false
+      "category": "behavior"
     },
     "name-html": {
       "type": "Boolean",
-      "default": "false",
       "desc": "Render the name as HTML; This can lead to XSS attacks so make sure that you sanitize the message first",
-      "category": "behavior",
-      "required": false
+      "category": "behavior"
     },
     "text-html": {
       "type": "Boolean",
-      "default": "false",
       "desc": "Render the text as HTML; This can lead to XSS attacks so make sure that you sanitize the message first",
-      "category": "behavior",
-      "required": false
+      "category": "behavior"
     },
     "stamp-html": {
       "type": "Boolean",
-      "default": "false",
       "desc": "Render the stamp as HTML; This can lead to XSS attacks so make sure that you sanitize the message first",
-      "category": "behavior",
-      "required": false
+      "category": "behavior"
     }
   },
   "slots": {

package/dist/api/QExpansionItem.json

@@ -9,38 +9,59 @@
         "String",
         "Object"
       ],
-      "desc": "Equivalent to Vue Router <router-link> 'to' property",
+      "desc": "Equivalent to Vue Router <router-link> 'to' property; Superseeded by 'href' prop if used",
       "examples": [
         "/home/dashboard",
         ":to=\"{ name: 'my-route-name' }\""
       ],
-      "category": "behavior"
+      "category": "navigation"
     },
     "exact": {
       "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'exact' property",
-      "category": "behavior"
+      "desc": "Equivalent to Vue Router <router-link> 'exact' property; Superseeded by 'href' prop if used",
+      "category": "navigation"
     },
     "replace": {
       "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'replace' property",
-      "category": "behavior"
+      "desc": "Equivalent to Vue Router <router-link> 'replace' property; Superseeded by 'href' prop if used",
+      "category": "navigation"
     },
     "active-class": {
       "type": "String",
-      "desc": "Equivalent to Vue Router <router-link> 'active-class' property",
+      "desc": "Equivalent to Vue Router <router-link> 'active-class' property; Superseeded by 'href' prop if used",
       "examples": [
         "my-active-class"
       ],
-      "category": "behavior"
+      "category": "navigation"
     },
     "exact-active-class": {
       "type": "String",
-      "desc": "Equivalent to Vue Router <router-link> 'active-class' property",
+      "desc": "Equivalent to Vue Router <router-link> 'active-class' property; Superseeded by 'href' prop if used",
       "examples": [
         "my-exact-active-class"
       ],
-      "category": "behavior"
+      "category": "navigation"
+    },
+    "href": {
+      "type": "String",
+      "desc": "Native <a> link href attribute; Has priority over the 'to'/'exact'/'replace'/'active-class'/'exact-active-class' props",
+      "examples": [
+        "http://quasar.dev"
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
+    },
+    "target": {
+      "type": "String",
+      "desc": "Native <a> link target attribute; Use it only along with 'href' prop; Has priority over the 'to'/'exact'/'replace'/'active-class'/'exact-active-class' props",
+      "examples": [
+        "_blank",
+        "_self",
+        "_parent",
+        "_top"
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
     },
     "disable": {
       "type": "Boolean",
@@ -48,9 +69,10 @@
       "category": "state"
     },
     "model-value": {
-      "type": "Boolean",
       "desc": "Model of the component defining 'open' state; Either use this property (along with a listener for 'update:modelValue' event) OR use v-model directive",
-      "category": "model"
+      "required": false,
+      "category": "model",
+      "type": "Boolean"
     },
     "icon": {
       "type": "String",

package/dist/api/QFab.json

@@ -155,9 +155,10 @@
       "category": "general"
     },
     "model-value": {
-      "type": "Boolean",
       "desc": "Controls state of fab actions (showing/hidden); Works best with v-model directive, otherwise use along listening to 'update:modelValue' event",
-      "category": "model"
+      "required": false,
+      "category": "model",
+      "type": "Boolean"
     },
     "icon": {
       "type": "String",
@@ -226,6 +227,36 @@
     },
     "tooltip": {
       "desc": "Slot specifically designed for a QTooltip"
+    },
+    "icon": {
+      "desc": "Slot for icon shown when FAB is closed; Suggestion: QIcon",
+      "scope": {
+        "opened": {
+          "type": "Boolean",
+          "desc": "FAB is opened"
+        }
+      },
+      "addedIn": "v2.4"
+    },
+    "active-icon": {
+      "desc": "Slot for icon shown when FAB is opened; Suggestion: QIcon",
+      "scope": {
+        "opened": {
+          "type": "Boolean",
+          "desc": "FAB is opened"
+        }
+      },
+      "addedIn": "v2.4"
+    },
+    "label": {
+      "desc": "Slot for label",
+      "scope": {
+        "opened": {
+          "type": "Boolean",
+          "desc": "FAB is opened"
+        }
+      },
+      "addedIn": "v2.4"
     }
   },
   "events": {

package/dist/api/QFabAction.json

@@ -196,6 +196,14 @@
   "slots": {
     "default": {
       "desc": "Suggestion for this slot: QTooltip"
+    },
+    "icon": {
+      "desc": "Slot for icon; Suggestion: QIcon",
+      "addedIn": "v2.4"
+    },
+    "label": {
+      "desc": "Slot for label",
+      "addedIn": "v2.4"
     }
   },
   "events": {

package/dist/api/QField.json

@@ -29,6 +29,7 @@
     },
     "rules": {
       "type": "Array",
+      "tsType": "ValidationRule",
       "desc": "Array of Functions/Strings; If String, then it must be a name of one of the embedded validation rules",
       "examples": [
         ":rules=\"[ val => val.length <= 3 || 'Please use maximum 3 characters' ]\"",

package/dist/api/QFile.json

@@ -128,6 +128,7 @@
     },
     "rules": {
       "type": "Array",
+      "tsType": "ValidationRule",
       "desc": "Array of Functions/Strings; If String, then it must be a name of one of the embedded validation rules",
       "examples": [
         ":rules=\"[ val => val.length <= 3 || 'Please use maximum 3 characters' ]\"",
@@ -488,7 +489,8 @@
           "desc": "File object"
         },
         "ref": {
-          "type": "Object",
+          "type": "Component",
+          "tsType": "QFile",
           "desc": "Reference to the QFile component"
         }
       }
@@ -504,7 +506,8 @@
           "desc": "Array of File objects"
         },
         "ref": {
-          "type": "Object",
+          "type": "Component",
+          "tsType": "QFile",
           "desc": "Reference to the QFile component"
         }
       }

package/dist/api/QForm.json

@@ -44,7 +44,7 @@
       "desc": "Emitted after a validation was triggered and at least one of the inner Quasar components models are NOT valid",
       "params": {
         "ref": {
-          "type": "Object",
+          "type": "Component",
           "desc": "Vue reference to the first component that triggered the validation error"
         }
       }

package/dist/api/QInput.json

@@ -84,6 +84,7 @@
     },
     "rules": {
       "type": "Array",
+      "tsType": "ValidationRule",
       "desc": "Array of Functions/Strings; If String, then it must be a name of one of the embedded validation rules",
       "examples": [
         ":rules=\"[ val => val.length <= 3 || 'Please use maximum 3 characters' ]\"",

package/dist/api/QItem.json

@@ -9,38 +9,59 @@
         "String",
         "Object"
       ],
-      "desc": "Equivalent to Vue Router <router-link> 'to' property",
+      "desc": "Equivalent to Vue Router <router-link> 'to' property; Superseeded by 'href' prop if used",
       "examples": [
         "/home/dashboard",
         ":to=\"{ name: 'my-route-name' }\""
       ],
-      "category": "behavior"
+      "category": "navigation"
     },
     "exact": {
       "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'exact' property",
-      "category": "behavior"
+      "desc": "Equivalent to Vue Router <router-link> 'exact' property; Superseeded by 'href' prop if used",
+      "category": "navigation"
     },
     "replace": {
       "type": "Boolean",
-      "desc": "Equivalent to Vue Router <router-link> 'replace' property",
-      "category": "behavior"
+      "desc": "Equivalent to Vue Router <router-link> 'replace' property; Superseeded by 'href' prop if used",
+      "category": "navigation"
     },
     "active-class": {
       "type": "String",
-      "desc": "Equivalent to Vue Router <router-link> 'active-class' property",
+      "desc": "Equivalent to Vue Router <router-link> 'active-class' property; Superseeded by 'href' prop if used",
       "examples": [
         "my-active-class"
       ],
-      "category": "behavior"
+      "category": "navigation"
     },
     "exact-active-class": {
       "type": "String",
-      "desc": "Equivalent to Vue Router <router-link> 'active-class' property",
+      "desc": "Equivalent to Vue Router <router-link> 'active-class' property; Superseeded by 'href' prop if used",
       "examples": [
         "my-exact-active-class"
       ],
-      "category": "behavior"
+      "category": "navigation"
+    },
+    "href": {
+      "type": "String",
+      "desc": "Native <a> link href attribute; Has priority over the 'to'/'exact'/'replace'/'active-class'/'exact-active-class' props",
+      "examples": [
+        "http://quasar.dev"
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
+    },
+    "target": {
+      "type": "String",
+      "desc": "Native <a> link target attribute; Use it only along with 'href' prop; Has priority over the 'to'/'exact'/'replace'/'active-class'/'exact-active-class' props",
+      "examples": [
+        "_blank",
+        "_self",
+        "_parent",
+        "_top"
+      ],
+      "category": "navigation",
+      "addedIn": "v2.4"
     },
     "disable": {
       "type": "Boolean",