@progress/kendo-themes-html 14.7.1-dev.3 → 14.7.1-dev.4

package/dist/meta/tooltip.json

@@ -0,0 +1,82 @@
+{
+  "component": "tooltip",
+  "name": "Tooltip",
+  "components": [
+    {
+      "name": "Tooltip",
+      "isPrimary": true,
+      "rootClass": "k-tooltip",
+      "options": [
+        {
+          "name": "themeColor",
+          "values": [
+            "base",
+            "inverse",
+            "info",
+            "success",
+            "warning",
+            "error"
+          ],
+          "default": null
+        }
+      ],
+      "states": [],
+      "aria": [
+        {
+          "prop": null,
+          "attribute": "role=\"tooltip\"",
+          "description": "Specifies the tooltip role of the tooltip container."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"button\"",
+          "description": "The close button needs an explicit button role."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-label",
+          "description": "The close button needs an accessible name."
+        },
+        {
+          "prop": null,
+          "attribute": "id",
+          "description": "required so the trigger element can reference it via aria-describedby"
+        }
+      ],
+      "keyboard": [
+        {
+          "trigger": "Escape",
+          "behavior": "Dismisses the Tooltip."
+        }
+      ],
+      "ux": [
+        {
+          "trigger": "Hover trigger",
+          "behavior": "Appears when the cursor hovers over the target element."
+        },
+        {
+          "trigger": "Focus trigger",
+          "behavior": "Also appears when the target receives keyboard focus."
+        },
+        {
+          "trigger": "Auto-positioning",
+          "behavior": "Automatically repositions to remain within the viewport."
+        },
+        {
+          "trigger": "Delay",
+          "behavior": "Configurable show and hide delays prevent flickering."
+        }
+      ]
+    }
+  ],
+  "resources": [
+    {
+      "url": "https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/",
+      "text": "WAI-ARIA specification for tooltip"
+    },
+    {
+      "url": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/tooltip_role",
+      "text": "MDN description for tooltip role"
+    }
+  ]
+}

package/dist/meta/treelist.json

@@ -0,0 +1,250 @@
+{
+  "component": "treelist",
+  "name": "Treelist",
+  "components": [
+    {
+      "name": "TreeList",
+      "isPrimary": true,
+      "rootClass": "k-treelist",
+      "options": [],
+      "states": [],
+      "aria": [
+        {
+          "prop": null,
+          "attribute": "role=\"toolbar\"",
+          "description": "The toolbar is a collection of command buttons and inputs."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-label",
+          "description": "Clarifies the purpose of the toolbar."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-controls=\".k-grid-aria-root id\"",
+          "description": "Pointing to the id of the element with role=treegrid."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"treegrid\"",
+          "description": "The role specifies the element is a TreeGrid."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-colcount",
+          "description": "The total number of columns."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-rowcount",
+          "description": "The total number of rows in the table."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"none\"",
+          "description": "Negates the default semantic role of the <table> element."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"rowgroup\"",
+          "description": "Required as the owner <table> element has its semantic role removed."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"row\"",
+          "description": "Required as the owner <table> element has its semantic role removed."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-rowindex",
+          "description": "Row number."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"columnheader\"",
+          "description": "Required as the owner <table> element has its semantic role removed."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-sort",
+          "description": "Present if sorting is enabled for that column."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-colindex",
+          "description": "Col number."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-haspopup=\"dialog\"",
+          "description": "Present if the column has a ColumnMenu or FilterMenu."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"gridcell\"",
+          "description": "Required as the owner <table> element has its semantic role removed."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-selected=\"true\"",
+          "description": "Set on the currently selected row(s) in row selection mode. All cells within the selected row also carry aria-selected=true (without k-selected class)."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-selected=\"true\"",
+          "description": "Set on the currently selected cell(s) in cell selection mode. The k-selected class on cells is only applied in cell selection mode, but aria-selected=true is present on cells regardless of selection mode."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-expanded",
+          "description": "Set on the currently expanded row(s)."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-expanded",
+          "description": "The cell containing the expand/collapse toggle also carries aria-expanded matching the row value, as it is the navigable focusable element."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-hidden=\"true\"",
+          "description": "Removes the expand/collapse icon from the accessibility tree."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"dialog\"",
+          "description": "The filter menu popup has dialog role."
+        },
+        {
+          "prop": null,
+          "attribute": "id",
+          "description": "Unique id linked to the header cell aria-controls attribute."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-label",
+          "description": "Descriptive label for the filter menu."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"dialog\"",
+          "description": "The column menu popup has dialog role."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-label",
+          "description": "Descriptive label for the column menu."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"button\"",
+          "description": "Column menu items have button role."
+        },
+        {
+          "prop": null,
+          "attribute": "tabindex=\"0\"",
+          "description": "Column menu items are focusable."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-expanded",
+          "description": "Expandable column menu items announce their expanded state."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-controls",
+          "description": "Expandable items point to the id of the content they control."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"listbox\"",
+          "description": "The column list is a listbox."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-multiselectable=\"true\"",
+          "description": "The column list supports multiple selections."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-label",
+          "description": "Accessible name for the column list."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"option\"",
+          "description": "Column list items are options."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-checked",
+          "description": "Column list items announce their checked state."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-owns",
+          "description": "Locked header rows own cells from the corresponding non-locked header table rows."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-owns",
+          "description": "Locked content rows own cells from the corresponding non-locked content table rows."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"none\"",
+          "description": "Non-locked header rows have their semantic role removed when locked columns exist."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"none\"",
+          "description": "Non-locked content rows have their semantic role removed when locked columns exist."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"columnheader\"",
+          "description": "Non-locked header cells retain columnheader role so they are announced correctly when owned via aria-owns."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"gridcell\"",
+          "description": "Non-locked data cells retain gridcell role so they are announced correctly when owned via aria-owns."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-label",
+          "description": "Must be present in a Drag Row scenario on the cell containing the drag handle."
+        }
+      ],
+      "keyboard": [
+        {
+          "trigger": "Enter",
+          "behavior": "In expandable and non-editable cell - expands or collapses the item."
+        }
+      ],
+      "ux": [
+        {
+          "trigger": "Expandable rows",
+          "behavior": "Rows can have child rows revealed by expanding the parent."
+        },
+        {
+          "trigger": "Sorting",
+          "behavior": "Column headers are clicked to sort data ascending or descending."
+        },
+        {
+          "trigger": "Filtering",
+          "behavior": "Column filter inputs narrow the displayed rows."
+        },
+        {
+          "trigger": "Row selection",
+          "behavior": "Rows are selected by clicking."
+        }
+      ]
+    }
+  ],
+  "resources": [
+    {
+      "url": "https://www.w3.org/TR/wai-aria-1.2/#treegrid",
+      "text": "WAI-ARIA specification for tree grid"
+    }
+  ]
+}

package/dist/meta/treeview.json

@@ -0,0 +1,168 @@
+{
+  "component": "treeview",
+  "name": "Treeview",
+  "components": [
+    {
+      "name": "Treeview",
+      "isPrimary": true,
+      "rootClass": "k-treeview",
+      "options": [
+        {
+          "name": "size",
+          "values": [
+            "small",
+            "medium",
+            "large"
+          ],
+          "default": null
+        }
+      ],
+      "states": [],
+      "aria": [
+        {
+          "prop": null,
+          "attribute": "role=\"tree\"",
+          "description": "The root list element of the treeview."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"group\"",
+          "description": "The ul element that wraps child nodes."
+        }
+      ],
+      "keyboard": [
+        {
+          "trigger": "Enter",
+          "behavior": "Selects the focused tree view item when the selection mode is single or multiple. When the selection mode is multiple and there are other selected items, they get deselected."
+        },
+        {
+          "trigger": "Space",
+          "behavior": "Checks the checkbox of the TreeView node."
+        },
+        {
+          "trigger": "ArrowUp",
+          "behavior": "Goes to the previous tree node. The focus is moved to the previous node and its tabindex is set to `0`."
+        },
+        {
+          "trigger": "ArrowDown",
+          "behavior": "Goes to the next tree node. The focus is moved to the next node and its tabindex is set to `0`."
+        },
+        {
+          "trigger": "ArrowLeft",
+          "behavior": "If the node is expanded, collapses it and the focus remains on the item. If the node is collapsed, the focus is moved to its parent."
+        },
+        {
+          "trigger": "ArrowRight",
+          "behavior": "If the node is collapsed, expands it and the focus remains on the item. If the node is expanded, the focus is moved to the first child node."
+        },
+        {
+          "trigger": "Home",
+          "behavior": "Moves the focus to the first node in the tree without opening or closing a node."
+        },
+        {
+          "trigger": "End",
+          "behavior": "Moves the focus to the last node in the tree that is focusable without opening a node."
+        },
+        {
+          "trigger": "Control/Cmd(Mac) + Enter",
+          "behavior": "Selects the focused item. When the item is already selected, it gets deselected."
+        },
+        {
+          "trigger": "Printable Characters",
+          "behavior": "Typing `M` or any other printable character focuses the next or the first item in the list."
+        }
+      ],
+      "ux": [
+        {
+          "trigger": "Expand / Collapse",
+          "behavior": "Nodes with children can be expanded to reveal them."
+        },
+        {
+          "trigger": "Selection",
+          "behavior": "A node is selected by clicking its label."
+        },
+        {
+          "trigger": "Multi-select",
+          "behavior": "Multiple nodes can be selected with Ctrl/Shift click."
+        },
+        {
+          "trigger": "Checkboxes",
+          "behavior": "Optional checkboxes provide hierarchical multi-selection with parent/child propagation."
+        },
+        {
+          "trigger": "Drag and drop",
+          "behavior": "Nodes can be dragged to a new position within the tree."
+        }
+      ]
+    },
+    {
+      "name": "TreeviewItem",
+      "isPrimary": true,
+      "rootClass": "k-treeview-item",
+      "options": [],
+      "states": [
+        "hover",
+        "focus",
+        "selected",
+        "disabled"
+      ],
+      "aria": [
+        {
+          "prop": null,
+          "attribute": "role=\"treeitem\"",
+          "description": "The li element rendered for a tree node."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-expanded=\"true\"|\\\"false\"",
+          "description": "Announces the expanded state of the node."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-checked=\"true\"|\\\"false\"",
+          "description": "Announces the checked state of the node when checkboxes are enabled."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-label",
+          "description": "The checkbox input must have an accessible name matching the treeview item text."
+        },
+        {
+          "prop": null,
+          "attribute": "tabindex=\"-1\"",
+          "description": "The checkbox input must not be in the tab order. Keyboard interaction is handled by the treeitem."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-selected=\"true\"",
+          "description": "when node is selected"
+        }
+      ],
+      "keyboard": [],
+      "ux": [
+        {
+          "trigger": "Expand / Collapse",
+          "behavior": "A toggle arrow reveals or hides the node's children."
+        },
+        {
+          "trigger": "Selection",
+          "behavior": "Clicking the label selects the node."
+        },
+        {
+          "trigger": "Checkbox",
+          "behavior": "An optional checkbox enables hierarchical multi-selection."
+        },
+        {
+          "trigger": "Drag handle",
+          "behavior": "Allows the node to be dragged to a new position within the tree."
+        }
+      ]
+    }
+  ],
+  "resources": [
+    {
+      "url": "https://www.w3.org/WAI/ARIA/apg/example-index/treeview/treeview-1/treeview-1a.html",
+      "text": "WAI-ARIA Authoring Practices: File Directory Treeview Example"
+    }
+  ]
+}

package/dist/meta/upload.json

@@ -0,0 +1,130 @@
+{
+  "component": "upload",
+  "name": "Upload",
+  "components": [
+    {
+      "name": "Upload",
+      "isPrimary": true,
+      "rootClass": "k-upload",
+      "options": [],
+      "states": [
+        "hover",
+        "disabled"
+      ],
+      "aria": [
+        {
+          "prop": null,
+          "attribute": "aria-disabled",
+          "description": "Announces the disabled state of the upload button."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-controls",
+          "description": "Creates the relationship between the button and the list of selected files when the list is present."
+        },
+        {
+          "prop": null,
+          "attribute": "tabindex=\"-1\"",
+          "description": "Assures that the input element inside the upload is not focusable."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-hidden=\"true\"",
+          "description": "The input needs to be hidden from screen readers."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"list\"",
+          "description": "Explicitly sets the UL role to list."
+        },
+        {
+          "prop": null,
+          "attribute": "id",
+          "description": "Unique and deterministic id linked to the button aria-controls attribute."
+        },
+        {
+          "prop": null,
+          "attribute": "role=\"listitem\"",
+          "description": "Explicitly sets the LI role to listitem."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-live=\"polite\"",
+          "description": "Announces the change in the upload status of the file."
+        },
+        {
+          "prop": null,
+          "attribute": "aria-label",
+          "description": "Provides accessible names for the file action buttons."
+        },
+        {
+          "prop": null,
+          "attribute": "tabindex=\"-1\"",
+          "description": "The list file action buttons are not focusable elements."
+        }
+      ],
+      "keyboard": [
+        {
+          "trigger": "Tab",
+          "behavior": "Switches focus between the Select File Button, the list of selected files, and the action buttons (Cancel, Upload) after the file list."
+        },
+        {
+          "trigger": "Space or Enter",
+          "behavior": "Opens the Select file dialog if the Select files button is focused."
+        },
+        {
+          "trigger": "ArrowDown",
+          "behavior": "Highlights the next file in the file list (if such exists) when a file list item is focused."
+        },
+        {
+          "trigger": "ArrowUp",
+          "behavior": "Highlights the previous file in the file list (if such exists) when a file list item is focused."
+        },
+        {
+          "trigger": "Enter",
+          "behavior": "Retries the upload of the failed file when the focus is on a file list item or starts the file upload for a valid file."
+        },
+        {
+          "trigger": "Escape",
+          "behavior": "Cancels the upload of the highlighted file when the focus is on a file list item"
+        },
+        {
+          "trigger": "Space",
+          "behavior": "When Chunk upload is enabled Start or Pause the highlighted file upload"
+        },
+        {
+          "trigger": "Delete",
+          "behavior": "Removes the highlighted file when the focus is on a file list item. Focus is moved to the next file (if present), previous file (if there is no next and there is previous), or is returned to the Select Files button if the last file from the list is deleted."
+        }
+      ],
+      "ux": [
+        {
+          "trigger": "Drop zone",
+          "behavior": "Files can be dragged and dropped onto the component to start the upload."
+        },
+        {
+          "trigger": "Browse",
+          "behavior": "A button opens the system file dialog to select files."
+        },
+        {
+          "trigger": "Progress",
+          "behavior": "Per-file progress bars show upload completion."
+        },
+        {
+          "trigger": "Cancel",
+          "behavior": "Individual file uploads can be cancelled while in progress."
+        },
+        {
+          "trigger": "Validation",
+          "behavior": "File type and size restrictions are enforced and violation messages are shown."
+        }
+      ]
+    }
+  ],
+  "resources": [
+    {
+      "url": "https://www.w3.org/WAI/ARIA/apg/",
+      "text": "WAI-ARIA Practices"
+    }
+  ]
+}