quasar 2.3.4 → 2.4.0

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

@@ -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",

package/dist/api/QFab.json

@@ -227,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' ]\"",

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",

package/dist/api/QOptionGroup.json

@@ -134,9 +134,44 @@
     "label": {
       "desc": "Generic slot for all labels",
       "scope": {
-        "opt": {
+        "...self": {
           "type": "Object",
-          "desc": "The corresponding option entry from the 'options' prop"
+          "desc": "The corresponding option entry from the 'options' prop",
+          "definition": {
+            "label": {
+              "type": "String",
+              "desc": "Label to display along the component",
+              "required": true,
+              "examples": [
+                "Option 1",
+                "Option 2",
+                "Option 3"
+              ]
+            },
+            "value": {
+              "type": "Any",
+              "desc": "Value of the option that will be used by the component model",
+              "required": true,
+              "examples": [
+                "op1",
+                "op2",
+                "op3"
+              ]
+            },
+            "disable": {
+              "type": "Boolean",
+              "desc": "If true, the option will be disabled"
+            },
+            "...props": {
+              "type": "Any",
+              "desc": "Any other props from QToggle, QCheckbox, or QRadio",
+              "examples": [
+                "val=\"car\"",
+                ":true-value=\"trueValue\"",
+                "checked-icon=\"visibility\""
+              ]
+            }
+          }
         }
       },
       "addedIn": "v2.2"
@@ -144,9 +179,44 @@
     "label-[name]": {
       "desc": "Slot to define the specific label for the option at '[name]' where name is a 0-based index; Overrides the generic 'label' slot if used",
       "scope": {
-        "...opt": {
+        "...self": {
           "type": "Object",
-          "desc": "The corresponding option entry from the 'options' prop"
+          "desc": "The corresponding option entry from the 'options' prop",
+          "definition": {
+            "label": {
+              "type": "String",
+              "desc": "Label to display along the component",
+              "required": true,
+              "examples": [
+                "Option 1",
+                "Option 2",
+                "Option 3"
+              ]
+            },
+            "value": {
+              "type": "Any",
+              "desc": "Value of the option that will be used by the component model",
+              "required": true,
+              "examples": [
+                "op1",
+                "op2",
+                "op3"
+              ]
+            },
+            "disable": {
+              "type": "Boolean",
+              "desc": "If true, the option will be disabled"
+            },
+            "...props": {
+              "type": "Any",
+              "desc": "Any other props from QToggle, QCheckbox, or QRadio",
+              "examples": [
+                "val=\"car\"",
+                ":true-value=\"trueValue\"",
+                "checked-icon=\"visibility\""
+              ]
+            }
+          }
         }
       },
       "addedIn": "v2.2"