quasar 2.3.0 → 2.3.4

package/dist/api/QTable.json

@@ -33,11 +33,29 @@
       ],
       "desc": "Property of each row that defines the unique key of each row (the result must be a primitive, not Object, Array, etc); The value of property must be string or a function taking a row and returning the desired (nested) key in the row; If supplying a function then for best performance, reference it from your scope and do not define it inline",
       "default": "id",
+      "params": {
+        "row": {
+          "type": "Object",
+          "desc": "The current row being processed",
+          "examples": [
+            "{ name: 'Lorem Ipsum', price: 19 }"
+          ]
+        }
+      },
+      "returns": {
+        "type": "Any",
+        "desc": "Current row's key",
+        "examples": [
+          "'34f39dda-6206-4071-a9df-4393aabe49ac'",
+          "34"
+        ]
+      },
       "examples": [
         "row-key=\"name\"",
         ":row-key=\"row => row.name\""
       ],
-      "category": "general"
+      "category": "general",
+      "required": false
     },
     "virtual-scroll": {
       "type": "Boolean",
@@ -54,7 +72,8 @@
       "examples": [
         "virtual-scroll-slice-size=\"60\""
       ],
-      "category": "virtual-scroll"
+      "category": "virtual-scroll",
+      "required": false
     },
     "virtual-scroll-slice-ratio-before": {
       "type": [
@@ -66,7 +85,8 @@
       "examples": [
         "virtual-scroll-slice-ratio-before=\"0.3\""
       ],
-      "category": "virtual-scroll"
+      "category": "virtual-scroll",
+      "required": false
     },
     "virtual-scroll-slice-ratio-after": {
       "type": [
@@ -78,7 +98,8 @@
       "examples": [
         "virtual-scroll-slice-ratio-after=\"2\""
       ],
-      "category": "virtual-scroll"
+      "category": "virtual-scroll",
+      "required": false
     },
     "virtual-scroll-item-size": {
       "type": [
@@ -90,7 +111,8 @@
       "examples": [
         "virtual-scroll-item-size=\"48\""
       ],
-      "category": "virtual-scroll"
+      "category": "virtual-scroll",
+      "required": false
     },
     "virtual-scroll-sticky-size-start": {
       "type": [
@@ -102,7 +124,8 @@
       "examples": [
         "virtual-scroll-sticky-size-start=\"48\""
       ],
-      "category": "virtual-scroll"
+      "category": "virtual-scroll",
+      "required": false
     },
     "virtual-scroll-sticky-size-end": {
       "type": [
@@ -114,7 +137,8 @@
       "examples": [
         "virtual-scroll-sticky-size-end=\"48\""
       ],
-      "category": "virtual-scroll"
+      "category": "virtual-scroll",
+      "required": false
     },
     "table-colspan": {
       "type": [
@@ -135,7 +159,8 @@
         "teal-10"
       ],
       "category": "style",
-      "default": "grey-8"
+      "default": "grey-8",
+      "required": false
     },
     "icon-first-page": {
       "type": "String",
@@ -206,16 +231,16 @@
       "definition": {
         "name": {
           "type": "String",
-          "desc": "Unique id, identifies column, (used by pagination.sortBy, 'body-cell-[name]' slot, ...)",
           "required": true,
+          "desc": "Unique id, identifies column, (used by pagination.sortBy, 'body-cell-[name]' slot, ...)",
           "examples": [
             "desc"
           ]
         },
         "label": {
           "type": "String",
-          "desc": "Label for header",
           "required": true,
+          "desc": "Label for header",
           "examples": [
             "Dessert (100g serving)"
           ]
@@ -225,17 +250,33 @@
             "String",
             "Function"
           ],
-          "desc": "Row Object property to determine value for this column or function which maps to the required property",
           "required": true,
+          "desc": "Row Object property to determine value for this column or function which maps to the required property",
+          "params": {
+            "row": {
+              "type": "Object",
+              "required": true,
+              "desc": "The current row being processed",
+              "examples": [
+                "{ name: 'Lorem Ipsum', prices: { active: 19, old: 25, list: 29 } }"
+              ]
+            }
+          },
+          "returns": {
+            "type": "Any",
+            "desc": "Value for this column",
+            "examples": [
+              "19"
+            ]
+          },
           "examples": [
             "name",
-            "row => row.some.nested.prop"
+            "row => row.prices.active"
           ]
         },
         "required": {
           "type": "Boolean",
-          "desc": "If we use visible-columns, this col will always be visible",
-          "default": false
+          "desc": "If we use visible-columns, this col will always be visible"
         },
         "align": {
           "type": "String",
@@ -246,16 +287,13 @@
             "center"
           ],
           "default": "right",
-          "examples": [
-            "left",
-            "right",
-            "center"
-          ]
+          "required": false
         },
         "sortable": {
           "type": "Boolean",
           "desc": "Tell QTable you want this column sortable",
-          "default": false
+          "default": false,
+          "required": false
         },
         "sort": {
           "type": "Function",
@@ -266,6 +304,7 @@
           "params": {
             "a": {
               "type": "Any",
+              "required": true,
               "desc": "Value of the first comparison term",
               "examples": [
                 123,
@@ -274,6 +313,7 @@
             },
             "b": {
               "type": "Any",
+              "required": true,
               "desc": "Value of the second comparison term",
               "examples": [
                 123,
@@ -282,6 +322,7 @@
             },
             "rowA": {
               "type": "Object",
+              "required": true,
               "desc": "Full Row object in which is contained the first term",
               "examples": [
                 "{ name: 'Potassium', value: 'K' }"
@@ -289,6 +330,7 @@
             },
             "rowB": {
               "type": "Object",
+              "required": true,
               "desc": "Full Row object in which is contained the second term",
               "examples": [
                 "{ name: 'Fluorine', value: 'F' }"
@@ -312,7 +354,8 @@
             "ad",
             "da"
           ],
-          "default": "ad"
+          "default": "ad",
+          "required": false
         },
         "format": {
           "type": "Function",
@@ -324,6 +367,7 @@
           "params": {
             "val": {
               "type": "Any",
+              "required": true,
               "desc": "Value of the cell",
               "examples": [
                 123,
@@ -332,6 +376,7 @@
             },
             "row": {
               "type": "Object",
+              "required": true,
               "desc": "Full Row object in which the cell is contained",
               "examples": [
                 "{ name: 'Potassium', value: 'K' }"
@@ -352,9 +397,22 @@
             "Function"
           ],
           "desc": "Style to apply on normal cells of the column",
+          "params": {
+            "row": {
+              "type": "Object",
+              "required": true,
+              "desc": "The current row being processed",
+              "examples": [
+                "{ name: 'Frozen Yogurt', calories: 159 }"
+              ]
+            }
+          },
+          "returns": {
+            "type": "String"
+          },
           "examples": [
-            "width: 500px",
-            "row => (row.calories % 2 === 0 ? 'width:10px' : 'font-size:2em')"
+            "'width: 500px'",
+            "row => (row.calories % 2 === 0 ? 'width: 10px' : 'font-size: 2em; font-weight: bold')"
           ]
         },
         "classes": {
@@ -363,9 +421,22 @@
             "Function"
           ],
           "desc": "Classes to add on normal cells of the column",
+          "params": {
+            "row": {
+              "type": "Object",
+              "required": true,
+              "desc": "The current row being processed",
+              "examples": [
+                "{ name: 'Frozen Yogurt', calories: 159 }"
+              ]
+            }
+          },
+          "returns": {
+            "type": "String"
+          },
           "examples": [
-            "my-special-class",
-            "row => (row.calories % 2 === 0 ? 'bg-green' : 'bg-yellow')"
+            "'my-special-class bg-primary'",
+            "row => (row.calories % 2 === 0 ? 'bg-green text-white' : 'bg-yellow')"
           ]
         },
         "headerStyle": {
@@ -461,10 +532,8 @@
         "cell",
         "none"
       ],
-      "examples": [
-        "cell"
-      ],
-      "category": "content"
+      "category": "content",
+      "required": false
     },
     "wrap-cells": {
       "type": "Boolean",
@@ -484,7 +553,8 @@
         "da"
       ],
       "default": "ad",
-      "category": "sorting"
+      "category": "sorting",
+      "required": false
     },
     "no-data-label": {
       "type": "String",
@@ -716,20 +786,18 @@
       "params": {
         "rows": {
           "type": "Array",
-          "desc": "Array of rows",
-          "required": true
+          "desc": "Array of rows"
         },
         "terms": {
           "type": [
             "String",
             "Object"
           ],
-          "desc": "Terms to filter with (is essentially the 'filter' prop value)",
-          "required": true
+          "desc": "Terms to filter with (is essentially the 'filter' prop value)"
         },
         "cols": {
           "type": "Array",
-          "desc": "Optional column definitions"
+          "desc": "Column definitions"
         },
         "getCellValue": {
           "type": "Function",
@@ -737,10 +805,12 @@
           "params": {
             "col": {
               "type": "Object",
+              "required": true,
               "desc": "Column name from column definitions"
             },
             "row": {
               "type": "Object",
+              "required": true,
               "desc": "The row object"
             }
           },
@@ -761,7 +831,8 @@
       "examples": [
         "(see source code)"
       ],
-      "category": "filter"
+      "category": "filter",
+      "required": false
     },
     "pagination": {
       "type": "Object",
@@ -814,7 +885,8 @@
       "examples": [
         ":rows-per-page-options=\"[10, 20]\""
       ],
-      "category": "pagination"
+      "category": "pagination",
+      "required": false
     },
     "selection": {
       "type": "String",
@@ -828,7 +900,8 @@
       "examples": [
         "multiple"
       ],
-      "category": "selection"
+      "category": "selection",
+      "required": false
     },
     "selected": {
       "type": "Array",
@@ -837,7 +910,8 @@
       "examples": [
         "v-model:selected=\"selection\""
       ],
-      "category": "selection"
+      "category": "selection",
+      "required": false
     },
     "expanded": {
       "type": "Array",
@@ -846,7 +920,8 @@
       "examples": [
         "v-model:expanded=\"expanded\""
       ],
-      "category": "expansion"
+      "category": "expansion",
+      "required": false
     },
     "sort-method": {
       "type": "Function",
@@ -876,7 +951,8 @@
       "examples": [
         "(see source code)"
       ],
-      "category": "sorting"
+      "category": "sorting",
+      "required": false
     }
   },
   "slots": {
@@ -919,8 +995,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -945,8 +1021,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -996,8 +1071,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -1022,8 +1097,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -1085,8 +1159,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -1111,8 +1185,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -1170,8 +1243,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -1196,8 +1269,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -1231,8 +1303,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -1257,8 +1329,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -1304,8 +1375,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -1330,8 +1401,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -1369,8 +1439,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -1395,8 +1465,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -1446,8 +1515,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -1472,8 +1541,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -1507,8 +1575,8 @@
                 "String",
                 "Object"
               ],
-              "desc": "Column name or column definition object",
               "required": true,
+              "desc": "Column name or column definition object",
               "examples": [
                 "calories"
               ]
@@ -1533,8 +1601,7 @@
             "primary",
             "teal-10"
           ],
-          "category": "style",
-          "default": "grey-8"
+          "category": "style"
         },
         "dark": {
           "type": "Boolean",
@@ -1575,6 +1642,7 @@
           "definition": {
             "sortBy": {
               "type": "String",
+              "required": true,
               "desc": "Column name (from column definition)",
               "examples": [
                 "calories"
@@ -1582,10 +1650,12 @@
             },
             "descending": {
               "type": "Boolean",
+              "required": true,
               "desc": "Is sorting in descending order?"
             },
             "page": {
               "type": "Number",
+              "required": true,
               "desc": "Page number (1-based)",
               "examples": [
                 3
@@ -1593,6 +1663,7 @@
             },
             "rowsPerPage": {
               "type": "Number",
+              "required": true,
               "desc": "How many rows per page? 0 means Infinite",
               "examples": [
                 10
@@ -1660,6 +1731,7 @@
           "definition": {
             "sortBy": {
               "type": "String",
+              "required": true,
               "desc": "Column name (from column definition)",
               "examples": [
                 "calories"
@@ -1667,10 +1739,12 @@
             },
             "descending": {
               "type": "Boolean",
+              "required": true,
               "desc": "Is sorting in descending order?"
             },
             "page": {
               "type": "Number",
+              "required": true,
               "desc": "Page number (1-based)",
               "examples": [
                 3
@@ -1678,6 +1752,7 @@
             },
             "rowsPerPage": {
               "type": "Number",
+              "required": true,
               "desc": "How many rows per page? 0 means Infinite",
               "examples": [
                 10
@@ -1745,6 +1820,7 @@
           "definition": {
             "sortBy": {
               "type": "String",
+              "required": true,
               "desc": "Column name (from column definition)",
               "examples": [
                 "calories"
@@ -1752,10 +1828,12 @@
             },
             "descending": {
               "type": "Boolean",
+              "required": true,
               "desc": "Is sorting in descending order?"
             },
             "page": {
               "type": "Number",
+              "required": true,
               "desc": "Page number (1-based)",
               "examples": [
                 3
@@ -1763,6 +1841,7 @@
             },
             "rowsPerPage": {
               "type": "Number",
+              "required": true,
               "desc": "How many rows per page? 0 means Infinite",
               "examples": [
                 10
@@ -1830,6 +1909,7 @@
           "definition": {
             "sortBy": {
               "type": "String",
+              "required": true,
               "desc": "Column name (from column definition)",
               "examples": [
                 "calories"
@@ -1837,10 +1917,12 @@
             },
             "descending": {
               "type": "Boolean",
+              "required": true,
               "desc": "Is sorting in descending order?"
             },
             "page": {
               "type": "Number",
+              "required": true,
               "desc": "Page number (1-based)",
               "examples": [
                 3
@@ -1848,6 +1930,7 @@
             },
             "rowsPerPage": {
               "type": "Number",
+              "required": true,
               "desc": "How many rows per page? 0 means Infinite",
               "examples": [
                 10
@@ -1915,6 +1998,7 @@
           "definition": {
             "sortBy": {
               "type": "String",
+              "required": true,
               "desc": "Column name (from column definition)",
               "examples": [
                 "calories"
@@ -1922,10 +2006,12 @@
             },
             "descending": {
               "type": "Boolean",
+              "required": true,
               "desc": "Is sorting in descending order?"
             },
             "page": {
               "type": "Number",
+              "required": true,
               "desc": "Page number (1-based)",
               "examples": [
                 3
@@ -1933,6 +2019,7 @@
             },
             "rowsPerPage": {
               "type": "Number",
+              "required": true,
               "desc": "How many rows per page? 0 means Infinite",
               "examples": [
                 10
@@ -2000,6 +2087,7 @@
           "definition": {
             "sortBy": {
               "type": "String",
+              "required": true,
               "desc": "Column name (from column definition)",
               "examples": [
                 "calories"
@@ -2007,10 +2095,12 @@
             },
             "descending": {
               "type": "Boolean",
+              "required": true,
               "desc": "Is sorting in descending order?"
             },
             "page": {
               "type": "Number",
+              "required": true,
               "desc": "Page number (1-based)",
               "examples": [
                 3
@@ -2018,6 +2108,7 @@
             },
             "rowsPerPage": {
               "type": "Number",
+              "required": true,
               "desc": "How many rows per page? 0 means Infinite",
               "examples": [
                 10
@@ -2102,8 +2193,7 @@
       "params": {
         "evt": {
           "type": "Object",
-          "desc": "JS event object",
-          "required": true
+          "desc": "JS event object"
         },
         "row": {
           "type": "Object",
@@ -2120,8 +2210,7 @@
       "params": {
         "evt": {
           "type": "Object",
-          "desc": "JS event object",
-          "required": true
+          "desc": "JS event object"
         },
         "row": {
           "type": "Object",
@@ -2138,8 +2227,7 @@
       "params": {
         "evt": {
           "type": "Object",
-          "desc": "JS event object",
-          "required": true
+          "desc": "JS event object"
         },
         "row": {
           "type": "Object",
@@ -2160,10 +2248,12 @@
           "definition": {
             "pagination": {
               "type": "Object",
+              "required": true,
               "desc": "Pagination object",
               "definition": {
                 "sortBy": {
                   "type": "String",
+                  "required": true,
                   "desc": "Column name (from column definition)",
                   "examples": [
                     "calories"
@@ -2171,10 +2261,12 @@
                 },
                 "descending": {
                   "type": "Boolean",
+                  "required": true,
                   "desc": "Is sorting in descending order?"
                 },
                 "page": {
                   "type": "Number",
+                  "required": true,
                   "desc": "Page number (1-based)",
                   "examples": [
                     3
@@ -2182,6 +2274,7 @@
                 },
                 "rowsPerPage": {
                   "type": "Number",
+                  "required": true,
                   "desc": "How many rows per page? 0 means Infinite",
                   "examples": [
                     10
@@ -2191,20 +2284,21 @@
             },
             "filter": {
               "type": "Function",
+              "required": true,
               "desc": "Filter method (the 'filter-method' prop)",
               "params": {
                 "rows": {
                   "type": "Array",
-                  "desc": "Array of rows",
-                  "required": true
+                  "required": true,
+                  "desc": "Array of rows"
                 },
                 "terms": {
                   "type": [
                     "String",
                     "Object"
                   ],
-                  "desc": "Terms to filter with (is essentially the 'filter' prop value)",
-                  "required": true
+                  "required": true,
+                  "desc": "Terms to filter with (is essentially the 'filter' prop value)"
                 },
                 "cols": {
                   "type": "Array",
@@ -2216,10 +2310,12 @@
                   "params": {
                     "col": {
                       "type": "Object",
+                      "required": true,
                       "desc": "Column name from column definitions"
                     },
                     "row": {
                       "type": "Object",
+                      "required": true,
                       "desc": "The row object"
                     }
                   },
@@ -2239,14 +2335,17 @@
             },
             "getCellValue": {
               "type": "Function",
-              "desc": "Optional function to get a cell value",
+              "required": true,
+              "desc": "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"
                 }
               },
@@ -2271,20 +2370,23 @@
           "definition": {
             "rows": {
               "type": "Array",
+              "required": true,
               "desc": "Array of row objects that were selected/unselected"
             },
             "keys": {
               "type": "Array",
+              "required": true,
               "desc": "Array of the keys of rows that were selected/unselected"
             },
             "added": {
               "type": "Boolean",
+              "required": true,
               "desc": "Were the rows added to selection (true) or removed from selection (false)"
             },
             "evt": {
               "type": "Object",
-              "desc": "JS event object",
-              "required": true
+              "required": true,
+              "desc": "JS event object"
             }
           }
         }
@@ -2299,6 +2401,7 @@
           "definition": {
             "sortBy": {
               "type": "String",
+              "required": true,
               "desc": "Column name (from column definition)",
               "examples": [
                 "calories"
@@ -2306,10 +2409,12 @@
             },
             "descending": {
               "type": "Boolean",
+              "required": true,
               "desc": "Is sorting in descending order?"
             },
             "page": {
               "type": "Number",
+              "required": true,
               "desc": "Page number (1-based)",
               "examples": [
                 3
@@ -2317,10 +2422,20 @@
             },
             "rowsPerPage": {
               "type": "Number",
+              "required": true,
               "desc": "How many rows per page? 0 means Infinite",
               "examples": [
                 10
               ]
+            },
+            "rowsNumber": {
+              "type": "Number",
+              "required": false,
+              "desc": "For server-side fetching only. How many total database rows are there to be added to the table.",
+              "examples": [
+                100,
+                200
+              ]
             }
           }
         }
@@ -2359,6 +2474,7 @@
           "definition": {
             "index": {
               "type": "Number",
+              "required": true,
               "desc": "Index of the list item that was scrolled into view (0 based)",
               "examples": [
                 30
@@ -2366,6 +2482,7 @@
             },
             "from": {
               "type": "Number",
+              "required": true,
               "desc": "The index of the first list item that is rendered (0 based)",
               "examples": [
                 10
@@ -2373,6 +2490,7 @@
             },
             "to": {
               "type": "Number",
+              "required": true,
               "desc": "The index of the last list item that is rendered (0 based)",
               "examples": [
                 50
@@ -2380,6 +2498,7 @@
             },
             "direction": {
               "type": "String",
+              "required": true,
               "desc": "Direction of change",
               "values": [
                 "increase",
@@ -2406,10 +2525,12 @@
       "params": {
         "props": {
           "type": "Object",
+          "required": false,
           "desc": "Request details",
           "definition": {
             "pagination": {
               "type": "Object",
+              "required": false,
               "desc": "Optional pagination object",
               "definition": {
                 "sortBy": {
@@ -2445,16 +2566,16 @@
               "params": {
                 "rows": {
                   "type": "Array",
-                  "desc": "Array of rows",
-                  "required": true
+                  "required": true,
+                  "desc": "Array of rows"
                 },
                 "terms": {
                   "type": [
                     "String",
                     "Object"
                   ],
-                  "desc": "Terms to filter with (is essentially the 'filter' prop value)",
-                  "required": true
+                  "required": true,
+                  "desc": "Terms to filter with (is essentially the 'filter' prop value)"
                 },
                 "cols": {
                   "type": "Array",
@@ -2496,8 +2617,8 @@
       "params": {
         "pagination": {
           "type": "Object",
-          "desc": "Pagination object",
           "required": true,
+          "desc": "Pagination object",
           "definition": {
             "sortBy": {
               "type": "String",
@@ -2549,8 +2670,8 @@
       "params": {
         "key": {
           "type": "Any",
-          "desc": "Row key value",
           "required": true,
+          "desc": "Row key value",
           "examples": [
             "calories"
           ]
@@ -2569,8 +2690,8 @@
       "params": {
         "key": {
           "type": "Any",
-          "desc": "Row key value",
           "required": true,
+          "desc": "Row key value",
           "examples": [
             "calories"
           ]
@@ -2586,8 +2707,8 @@
       "params": {
         "expanded": {
           "type": "Array",
-          "desc": "Array containing keys of the expanded rows",
           "required": true,
+          "desc": "Array containing keys of the expanded rows",
           "examples": [
             "[ 'row-a', 'row-b' ]"
           ]
@@ -2602,8 +2723,8 @@
             "String",
             "Object"
           ],
-          "desc": "Column name or column definition object",
           "required": true,
+          "desc": "Column name or column definition object",
           "examples": [
             "calories"
           ]
@@ -2621,8 +2742,8 @@
             "String",
             "Number"
           ],
-          "desc": "The index of the row in page (0 based)",
           "required": true,
+          "desc": "The index of the row in page (0 based)",
           "examples": [
             "1",
             23
@@ -2630,7 +2751,7 @@
         },
         "edge": {
           "type": "String",
-          "desc": "Only for virtual scroll - the edge to align to if the row is not visible already (by default it aligns to end if scrolling towards the end and to start otherwise); If the '-force' version is used then it always aligns",
+          "desc": "Only for virtual scroll - the edge to align to if the row is not visible already; If the '-force' version is used then it always aligns",
           "values": [
             "start",
             "center",
@@ -2638,7 +2759,9 @@
             "start-force",
             "center-force",
             "end-force"
-          ]
+          ],
+          "default": "end (if scrolling towards the end) / start (if scrolling towards the start)",
+          "required": false
         }
       }
     }