quasar 2.7.6 → 2.8.0

package/dist/api/Loading.json

@@ -21,6 +21,16 @@
           "Processing your request"
         ]
       },
+      "group": {
+        "type": "String",
+        "desc": "Default Loading group name",
+        "default": "__default_quasar_group__",
+        "examples": [
+          "default-group-name"
+        ],
+        "addedIn": "v2.8",
+        "required": false
+      },
       "html": {
         "type": "Boolean",
         "desc": "Force render the message as HTML; This can lead to XSS attacks so make sure that you sanitize the content",
@@ -93,10 +103,13 @@
   },
   "methods": {
     "show": {
+      "tsInjectionPoint": true,
       "desc": "Activate and show",
       "params": {
         "opts": {
           "type": "Object",
+          "tsType": "QLoadingShowOptions",
+          "autoDefineTsType": true,
           "desc": "All props are optional",
           "definition": {
             "delay": {
@@ -113,6 +126,14 @@
                 "Processing your request"
               ]
             },
+            "group": {
+              "type": "String",
+              "desc": "Loading group name",
+              "examples": [
+                "some-api-call"
+              ],
+              "addedIn": "v2.8"
+            },
             "html": {
               "type": "Boolean",
               "desc": "Render the message as HTML; This can lead to XSS attacks so make sure that you sanitize the message first",
@@ -177,10 +198,35 @@
             }
           }
         }
+      },
+      "returns": {
+        "type": "Function",
+        "desc": "Calling this function with no parameters hides the group; When called with one Object parameter then it updates the Loading group (specified properties are shallow merged with the group ones; note that group cannot be changed while updating and it is ignored)",
+        "params": {
+          "props": {
+            "type": "Object",
+            "tsType": "QLoadingUpdateOptions",
+            "required": false,
+            "desc": "Loading properties that will be shallow merged to the group ones; (See 'opts' param of 'show()' for object properties, except 'group')"
+          }
+        },
+        "returns": null,
+        "addedIn": "v2.8"
       }
     },
     "hide": {
-      "desc": "Hide it"
+      "desc": "Hide it",
+      "params": {
+        "group": {
+          "type": "String",
+          "desc": "Optional Loading group name to hide instead of hiding all groups",
+          "required": false,
+          "examples": [
+            "some-api-call"
+          ],
+          "addedIn": "v2.8"
+        }
+      }
     },
     "setDefaults": {
       "desc": "Merge options into the default ones",
@@ -204,6 +250,16 @@
                 "Processing your request"
               ]
             },
+            "group": {
+              "type": "String",
+              "desc": "Default Loading group name",
+              "default": "__default_quasar_group__",
+              "examples": [
+                "default-group-name"
+              ],
+              "addedIn": "v2.8",
+              "required": false
+            },
             "spinnerSize": {
               "type": "Number",
               "desc": "Spinner size (in pixels)",

package/dist/api/QBtnDropdown.json

@@ -416,6 +416,10 @@
     },
     "label": {
       "desc": "Customize main button's content through this slot, unless you're using the 'icon' and 'label' props"
+    },
+    "loading": {
+      "desc": "Override the default QSpinner when in 'loading' state",
+      "addedIn": "v2.8"
     }
   },
   "events": {

package/dist/api/QEditor.json

@@ -95,103 +95,111 @@
         ":definitions=\"{ save: { tip: 'Save your work', icon: 'save', label: 'Save', handler: saveWork }, upload: { tip: 'Upload to cloud', icon: 'cloud_upload', label: 'Upload', handler: uploadIt } }\""
       ],
       "definition": {
-        "label": {
-          "type": "String",
-          "desc": "Label of the button",
-          "examples": [
-            "Addresses"
-          ]
-        },
-        "tip": {
-          "type": "String",
-          "desc": "Text to be displayed as a tooltip on hover",
-          "examples": [
-            "Add a contact from the Address Book"
-          ]
-        },
-        "htmlTip": {
-          "type": "String",
-          "desc": "HTML formatted text to be displayed within a tooltip on hover",
-          "examples": [
-            "Add a <span class=\"red\">user</span> from the address book"
-          ]
-        },
-        "icon": {
-          "type": "String",
-          "desc": "Icon of the button",
-          "examples": [
-            "fas fa-address-book"
-          ]
-        },
-        "key": {
-          "type": "Number",
-          "desc": "Keycode of a key to be used together with the <ctrl> key for use as a shortcut to trigger this element",
-          "examples": [
-            "12",
-            "36"
-          ]
-        },
-        "handler": {
-          "type": "Function",
-          "desc": "Either this or \"cmd\" is required. Function for when button gets clicked/tapped.",
-          "params": null,
-          "returns": null,
-          "examples": [
-            "() => this.uploadFile()"
-          ]
-        },
-        "cmd": {
-          "type": "String",
-          "desc": "Either this or \"handler\" is required. This must be a valid execCommand method according to the designMode API.",
-          "examples": [
-            "insertHTML",
-            "justifyFull"
-          ]
-        },
-        "param": {
-          "type": "String",
-          "desc": "Only set a param if using a \"cmd\". This is commonly text or HTML to inject, but is highly dependent upon the specific cmd being called.",
-          "examples": [
-            "<img src=\"://uploads/001.jpg\" alt=\"nice pic\" />"
-          ]
-        },
-        "disable": {
-          "type": [
-            "Boolean",
-            "Function"
-          ],
-          "desc": "Is button disabled?",
-          "returns": {
-            "type": "Boolean",
-            "desc": "If true, the button will be disabled"
-          },
-          "examples": [
-            "!user.active",
-            "() => !checkIfUserIsActive()"
-          ]
-        },
-        "type": {
-          "type": "String",
-          "desc": "Pass the value \"no-state\" if the button should not have an \"active\" state",
-          "values": [
-            null,
-            "no-state"
-          ],
-          "examples": [
-            "no-state"
-          ]
-        },
-        "fixedLabel": {
-          "type": "Boolean",
-          "desc": "Lock the button label, so it doesn't change based on the child option selected."
-        },
-        "fixedIcon": {
-          "type": "Boolean",
-          "desc": "Lock the button icon, so it doesn't change based on the child option selected."
-        },
-        "highlight": {
-          "type": "Boolean",
-          "desc": "Highlight the toolbar button, when a child option has been selected."
+        "...commandName": {
+          "type": "Object",
+          "tsType": "QEditorCommand",
+          "autoDefineTsType": true,
+          "desc": "Command definition",
+          "definition": {
+            "label": {
+              "type": "String",
+              "desc": "Label of the button",
+              "examples": [
+                "Addresses"
+              ]
+            },
+            "tip": {
+              "type": "String",
+              "desc": "Text to be displayed as a tooltip on hover",
+              "examples": [
+                "Add a contact from the Address Book"
+              ]
+            },
+            "htmlTip": {
+              "type": "String",
+              "desc": "HTML formatted text to be displayed within a tooltip on hover",
+              "examples": [
+                "Add a <span class=\"red\">user</span> from the address book"
+              ]
+            },
+            "icon": {
+              "type": "String",
+              "desc": "Icon of the button",
+              "examples": [
+                "fas fa-address-book"
+              ]
+            },
+            "key": {
+              "type": "Number",
+              "desc": "Keycode of a key to be used together with the <ctrl> key for use as a shortcut to trigger this element",
+              "examples": [
+                "12",
+                "36"
+              ]
+            },
+            "handler": {
+              "type": "Function",
+              "desc": "Either this or \"cmd\" is required. Function for when button gets clicked/tapped.",
+              "params": null,
+              "returns": null,
+              "examples": [
+                "() => this.uploadFile()"
+              ]
+            },
+            "cmd": {
+              "type": "String",
+              "desc": "Either this or \"handler\" is required. This must be a valid execCommand method according to the designMode API.",
+              "examples": [
+                "insertHTML",
+                "justifyFull"
+              ]
+            },
+            "param": {
+              "type": "String",
+              "desc": "Only set a param if using a \"cmd\". This is commonly text or HTML to inject, but is highly dependent upon the specific cmd being called.",
+              "examples": [
+                "<img src=\"://uploads/001.jpg\" alt=\"nice pic\" />"
+              ]
+            },
+            "disable": {
+              "type": [
+                "Boolean",
+                "Function"
+              ],
+              "desc": "Is button disabled?",
+              "returns": {
+                "type": "Boolean",
+                "desc": "If true, the button will be disabled"
+              },
+              "examples": [
+                "!user.active",
+                "() => !checkIfUserIsActive()"
+              ]
+            },
+            "type": {
+              "type": "String",
+              "desc": "Pass the value \"no-state\" if the button should not have an \"active\" state",
+              "values": [
+                null,
+                "no-state"
+              ],
+              "examples": [
+                "no-state"
+              ]
+            },
+            "fixedLabel": {
+              "type": "Boolean",
+              "desc": "Lock the button label, so it doesn't change based on the child option selected."
+            },
+            "fixedIcon": {
+              "type": "Boolean",
+              "desc": "Lock the button icon, so it doesn't change based on the child option selected."
+            },
+            "highlight": {
+              "type": "Boolean",
+              "desc": "Highlight the toolbar button, when a child option has been selected."
+            }
+          }
         }
       },
       "category": "toolbar"

package/dist/api/QField.json

@@ -415,5 +415,11 @@
     "blur": {
       "desc": "Blur field (lose focus)"
     }
+  },
+  "computedProps": {
+    "hasError": {
+      "type": "Boolean",
+      "desc": "Whether the component is in error state"
+    }
   }
 }

package/dist/api/QFile.json

@@ -631,5 +631,11 @@
         "desc": "The underlying native input DOM Element"
       }
     }
+  },
+  "computedProps": {
+    "hasError": {
+      "type": "Boolean",
+      "desc": "Whether the component is in error state"
+    }
   }
 }

package/dist/api/QInput.json

@@ -498,5 +498,11 @@
         "desc": "The underlying native input/textarea DOM Element"
       }
     }
+  },
+  "computedProps": {
+    "hasError": {
+      "type": "Boolean",
+      "desc": "Whether the component is in error state"
+    }
   }
 }

package/dist/api/QSelect.json

@@ -1444,5 +1444,11 @@
         "desc": "Option is disabled or not"
       }
     }
+  },
+  "computedProps": {
+    "hasError": {
+      "type": "Boolean",
+      "desc": "Whether the component is in error state"
+    }
   }
 }

package/dist/api/QTable.json

@@ -2310,55 +2310,11 @@
               }
             },
             "filter": {
-              "type": "Function",
-              "required": true,
-              "desc": "Filter method (the 'filter-method' prop)",
-              "params": {
-                "rows": {
-                  "type": "Array",
-                  "required": true,
-                  "desc": "Array of rows"
-                },
-                "terms": {
-                  "type": [
-                    "String",
-                    "Object"
-                  ],
-                  "required": true,
-                  "desc": "Terms to filter with (is essentially the 'filter' prop value)"
-                },
-                "cols": {
-                  "type": "Array",
-                  "desc": "Optional column definitions"
-                },
-                "getCellValue": {
-                  "type": "Function",
-                  "desc": "Optional function to get a cell value",
-                  "params": {
-                    "col": {
-                      "type": "Object",
-                      "required": true,
-                      "desc": "Column name from column definitions"
-                    },
-                    "row": {
-                      "type": "Object",
-                      "required": true,
-                      "desc": "The row object"
-                    }
-                  },
-                  "returns": {
-                    "type": "Any",
-                    "desc": "Parsed/Processed cell value",
-                    "examples": [
-                      "Ice Cream Sandwich"
-                    ]
-                  }
-                }
-              },
-              "returns": {
-                "type": "Array",
-                "desc": "Filtered rows"
-              }
+              "type": [
+                "String",
+                "Object"
+              ],
+              "desc": "String/Object to filter table with (the 'filter' prop)"
             },
             "getCellValue": {
               "type": "Function",
@@ -2584,6 +2540,14 @@
                   "examples": [
                     10
                   ]
+                },
+                "rowsNumber": {
+                  "type": "Number",
+                  "desc": "For server-side fetching only. How many total database rows are there to be added to the table.",
+                  "examples": [
+                    100,
+                    200
+                  ]
                 }
               }
             },
@@ -2792,5 +2756,28 @@
         }
       }
     }
+  },
+  "computedProps": {
+    "filteredSortedRows": {
+      "desc": "The filtered and sorted rows (same as the rows prop if using server-side fetching)",
+      "type": "Array",
+      "examples": [
+        "[ { name: 'Ice Cream Sandwich', calories: 237, fat: 9.0, carbs: 37, protein: 4.3, sodium: 129, calcium: 8, iron: 1 }, ... ]"
+      ]
+    },
+    "computedRows": {
+      "desc": "Paginated, filtered, and sorted rows (same as the rows prop if using server-side fetching)",
+      "type": "Array",
+      "examples": [
+        "[ { name: 'Ice Cream Sandwich', calories: 237, fat: 9.0, carbs: 37, protein: 4.3, sodium: 129, calcium: 8, iron: 1 }, ... ]"
+      ]
+    },
+    "computedRowsNumber": {
+      "desc": "The number of computed rows",
+      "type": "Number",
+      "examples": [
+        10
+      ]
+    }
   }
 }

package/dist/api/QUploader.json

@@ -535,23 +535,21 @@
   },
   "methods": {
     "pickFiles": {
-      "desc": "Trigger file pick; Must be called as a direct consequence of user interaction (eg. in a click handler), due to browsers security policy",
+      "desc": "Trigger the file picker dialog; The event must come from a user interaction event handler",
       "params": {
         "evt": {
           "type": "Event",
-          "desc": "JS event object"
+          "desc": "JS event object of the original user interaction handler",
+          "required": true
         }
       }
     },
     "addFiles": {
-      "desc": "Add files programmatically",
+      "desc": "Manually add files to the queue",
       "params": {
         "files": {
-          "type": [
-            "FileList",
-            "Array"
-          ],
-          "desc": "Array of files (instances of File)",
+          "type": "Array",
+          "desc": "Must be an array of instances of JS File type",
           "required": true
         }
       }
@@ -580,6 +578,86 @@
           "required": true
         }
       }
+    },
+    "updateFileStatus": {
+      "desc": "Update the status of a file",
+      "params": {
+        "file": {
+          "type": "Object",
+          "desc": "File to update (instance of File)",
+          "required": true
+        },
+        "status": {
+          "type": "String",
+          "desc": "Status of file",
+          "values": [
+            "idle",
+            "failed",
+            "uploading",
+            "uploaded"
+          ],
+          "required": true
+        },
+        "uploadedSize": {
+          "type": "Number",
+          "desc": "The number of uploaded bytes of the file; Is required explicitly only when status is NOT 'uploaded'",
+          "required": true
+        }
+      }
+    },
+    "isAlive": {
+      "desc": "Is the component alive (activated but not unmounted); Useful to determine if you still need to compute anything going further",
+      "returns": {
+        "type": "Boolean",
+        "desc": "If true, the current component is still activated and mounted"
+      }
+    }
+  },
+  "computedProps": {
+    "files": {
+      "type": "Array",
+      "desc": "List of all files"
+    },
+    "queuedFiles": {
+      "type": "Array",
+      "desc": "List of files that are waiting to be uploaded"
+    },
+    "uploadedFiles": {
+      "type": "Array",
+      "desc": "List of files that have been uploaded"
+    },
+    "uploadedSize": {
+      "type": "Number",
+      "desc": "Size of all uploaded files in bytes",
+      "examples": [
+        1024
+      ]
+    },
+    "uploadSizeLabel": {
+      "type": "String",
+      "desc": "Label for the size total of all files",
+      "examples": [
+        "1.0MB"
+      ]
+    },
+    "uploadProgressLabel": {
+      "type": "String",
+      "desc": "Label for the upload progress (in %)",
+      "examples": [
+        "52.76%"
+      ]
+    },
+    "canAddFiles": {
+      "type": "Boolean",
+      "desc": "Whether new files can be added to the list"
+    },
+    "canUpload": {
+      "type": "Boolean",
+      "desc": "Whether the files can be uploaded"
+    },
+    "isBusy": {
+      "type": "Boolean",
+      "desc": "The component state is set as busy; User should not be able to interact with the component"
     }
   }
 }

package/dist/icon-set/bootstrap-icons.umd.prod.js

@@ -1,5 +1,5 @@
 /*!
- * Quasar Framework v2.7.6
+ * Quasar Framework v2.8.0
  * (c) 2015-present Razvan Stoenescu
  * Released under the MIT License.
  */

package/dist/icon-set/eva-icons.umd.prod.js

@@ -1,5 +1,5 @@
 /*!
- * Quasar Framework v2.7.6
+ * Quasar Framework v2.8.0
  * (c) 2015-present Razvan Stoenescu
  * Released under the MIT License.
  */

package/dist/icon-set/fontawesome-v5-pro.umd.prod.js

@@ -1,5 +1,5 @@
 /*!
- * Quasar Framework v2.7.6
+ * Quasar Framework v2.8.0
  * (c) 2015-present Razvan Stoenescu
  * Released under the MIT License.
  */

package/dist/icon-set/fontawesome-v5.umd.prod.js

@@ -1,5 +1,5 @@
 /*!
- * Quasar Framework v2.7.6
+ * Quasar Framework v2.8.0
  * (c) 2015-present Razvan Stoenescu
  * Released under the MIT License.
  */

package/dist/icon-set/fontawesome-v6-pro.umd.prod.js

@@ -1,5 +1,5 @@
 /*!
- * Quasar Framework v2.7.6
+ * Quasar Framework v2.8.0
  * (c) 2015-present Razvan Stoenescu
  * Released under the MIT License.
  */

package/dist/icon-set/fontawesome-v6.umd.prod.js

@@ -1,5 +1,5 @@
 /*!
- * Quasar Framework v2.7.6
+ * Quasar Framework v2.8.0
  * (c) 2015-present Razvan Stoenescu
  * Released under the MIT License.
  */

package/dist/icon-set/ionicons-v4.umd.prod.js

@@ -1,5 +1,5 @@
 /*!
- * Quasar Framework v2.7.6
+ * Quasar Framework v2.8.0
  * (c) 2015-present Razvan Stoenescu
  * Released under the MIT License.
  */

package/dist/icon-set/line-awesome.umd.prod.js

@@ -1,5 +1,5 @@
 /*!
- * Quasar Framework v2.7.6
+ * Quasar Framework v2.8.0
  * (c) 2015-present Razvan Stoenescu
  * Released under the MIT License.
  */