igniteui-webcomponents 3.3.0 → 3.4.0

package/custom-elements.json

@@ -2069,13 +2069,142 @@
         }
       ]
     },
+    {
+      "name": "igc-dialog",
+      "path": "./src/components/dialog/dialog.ts",
+      "description": "Represents a Dialog component.",
+      "attributes": [
+        {
+          "name": "close-on-escape",
+          "description": "Whether the dialog should be closed when pressing the 'ESCAPE' button.",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "close-on-outside-click",
+          "description": "Whether the dialog should be closed when clicking outside of it.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "hide-default-action",
+          "description": "Whether to hide the default action button for the dialog.\n\nWhen there is projected content in the `footer` slot this property\nhas no effect.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "open",
+          "description": "Whether the dialog is opened.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "title",
+          "description": "Sets the title of the dialog.",
+          "type": "string"
+        }
+      ],
+      "properties": [
+        {
+          "name": "tagName",
+          "type": "\"igc-dialog\"",
+          "default": "\"igc-dialog\""
+        },
+        {
+          "name": "styles",
+          "type": "CSSResult[]",
+          "default": "[\"styles\"]"
+        },
+        {
+          "name": "closeOnEscape",
+          "attribute": "close-on-escape",
+          "description": "Whether the dialog should be closed when pressing the 'ESCAPE' button.",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "closeOnOutsideClick",
+          "attribute": "close-on-outside-click",
+          "description": "Whether the dialog should be closed when clicking outside of it.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "hideDefaultAction",
+          "attribute": "hide-default-action",
+          "description": "Whether to hide the default action button for the dialog.\n\nWhen there is projected content in the `footer` slot this property\nhas no effect.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "open",
+          "attribute": "open",
+          "description": "Whether the dialog is opened.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "title",
+          "attribute": "title",
+          "description": "Sets the title of the dialog.",
+          "type": "string"
+        },
+        {
+          "name": "returnValue",
+          "description": "Sets the return value for the dialog.",
+          "type": "string"
+        }
+      ],
+      "events": [
+        {
+          "name": "igcClosing",
+          "description": "Emitter just before the dialog is closed."
+        },
+        {
+          "name": "igcClosed",
+          "description": "Emitted after closing the dialog."
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Renders content inside the default slot."
+        },
+        {
+          "name": "title",
+          "description": "Renders the title of the dialog header."
+        },
+        {
+          "name": "footer",
+          "description": "Renders the dialog footer."
+        }
+      ],
+      "cssParts": [
+        {
+          "name": "base",
+          "description": "The base wrapper of the dialog."
+        },
+        {
+          "name": "title",
+          "description": "The title container."
+        },
+        {
+          "name": "footer",
+          "description": "The footer container."
+        },
+        {
+          "name": "overlay",
+          "description": "The overlay."
+        }
+      ]
+    },
     {
       "name": "igc-dropdown-group",
       "path": "./src/components/dropdown/dropdown-group.ts",
       "properties": [
         {
           "name": "tagName",
-          "type": "\"igc-dropdown-group\"",
+          "type": "string",
           "default": "\"igc-dropdown-group\""
         },
         {
@@ -2112,7 +2241,7 @@
       "properties": [
         {
           "name": "tagName",
-          "type": "\"igc-dropdown-header\"",
+          "type": "string",
           "default": "\"igc-dropdown-header\""
         },
         {
@@ -2160,7 +2289,7 @@
       "properties": [
         {
           "name": "tagName",
-          "type": "\"igc-dropdown-item\"",
+          "type": "string",
           "default": "\"igc-dropdown-item\""
         },
         {
@@ -2292,11 +2421,6 @@
         }
       ],
       "properties": [
-        {
-          "name": "tagName",
-          "type": "\"igc-dropdown\"",
-          "default": "\"igc-dropdown\""
-        },
         {
           "name": "styles",
           "type": "CSSResult",
@@ -2708,6 +2832,11 @@
           "description": "The autocomplete attribute of the control.",
           "type": "string"
         },
+        {
+          "name": "tabIndex",
+          "type": "number",
+          "default": "0"
+        },
         {
           "name": "value",
           "description": "The value attribute of the control.",
@@ -2839,6 +2968,12 @@
           "description": "The autocomplete attribute of the control.",
           "type": "string"
         },
+        {
+          "name": "tabIndex",
+          "attribute": "tabIndex",
+          "type": "number",
+          "default": "0"
+        },
         {
           "name": "styles",
           "type": "CSSResult",
@@ -4160,13 +4295,13 @@
       "attributes": [
         {
           "name": "max",
-          "description": "The maximum value for the rating",
+          "description": "The maximum value for the rating.\n\nIf there are projected symbols, the maximum value will be resolved\nbased on the number of symbols.",
           "type": "number",
           "default": "5"
         },
         {
           "name": "step",
-          "description": "The minimum value change allowed.",
+          "description": "The minimum value change allowed.\n\nValid values are in the interval between 0 and 1 inclusive.",
           "type": "number",
           "default": "1"
         },
@@ -4182,7 +4317,7 @@
         },
         {
           "name": "value-format",
-          "description": "A format string which sets aria-valuetext. All instances of '{0}' will be replaced\nwith the current value of the control.\nImportant for screen-readers and useful for localization.",
+          "description": "A format string which sets aria-valuetext. Instances of '{0}' will be replaced\nwith the current value of the control and instances of '{1}' with the maximum value for the control.\n\nImportant for screen-readers and useful for localization.",
           "type": "string"
         },
         {
@@ -4236,14 +4371,14 @@
         {
           "name": "max",
           "attribute": "max",
-          "description": "The maximum value for the rating",
+          "description": "The maximum value for the rating.\n\nIf there are projected symbols, the maximum value will be resolved\nbased on the number of symbols.",
           "type": "number",
           "default": "5"
         },
         {
           "name": "step",
           "attribute": "step",
-          "description": "The minimum value change allowed.",
+          "description": "The minimum value change allowed.\n\nValid values are in the interval between 0 and 1 inclusive.",
           "type": "number",
           "default": "1"
         },
@@ -4262,7 +4397,7 @@
         {
           "name": "valueFormat",
           "attribute": "value-format",
-          "description": "A format string which sets aria-valuetext. All instances of '{0}' will be replaced\nwith the current value of the control.\nImportant for screen-readers and useful for localization.",
+          "description": "A format string which sets aria-valuetext. Instances of '{0}' will be replaced\nwith the current value of the control and instances of '{1}' with the maximum value for the control.\n\nImportant for screen-readers and useful for localization.",
           "type": "string"
         },
         {
@@ -4388,6 +4523,470 @@
         }
       ]
     },
+    {
+      "name": "igc-select-group",
+      "path": "./src/components/select/select-group.ts",
+      "attributes": [
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "properties": [
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "styles",
+          "type": "CSSResult",
+          "default": "\"styles\""
+        },
+        {
+          "name": "items",
+          "description": "All child `igc-select-item`s.",
+          "type": "IgcSelectItemComponent[]"
+        }
+      ],
+      "slots": [
+        {
+          "name": "label",
+          "description": "Contains the group's label."
+        },
+        {
+          "name": "",
+          "description": "Intended to contain the items belonging to this group."
+        }
+      ],
+      "cssParts": [
+        {
+          "name": "label",
+          "description": "The native label element."
+        }
+      ]
+    },
+    {
+      "name": "igc-select-header",
+      "path": "./src/components/select/select-header.ts",
+      "properties": [
+        {
+          "name": "styles",
+          "type": "CSSResult",
+          "default": "\"styles\""
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Renders the header."
+        }
+      ]
+    },
+    {
+      "name": "igc-select-item",
+      "path": "./src/components/select/select-item.ts",
+      "description": "Represents an item in a select list.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "Тhe current value of the item.\nIf not specified, the element's text content is used.",
+          "type": "string"
+        },
+        {
+          "name": "selected",
+          "description": "Determines whether the item is selected.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "active",
+          "description": "Determines whether the item is active.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "disabled",
+          "description": "Determines whether the item is disabled.",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "properties": [
+        {
+          "name": "textContent",
+          "description": "Returns the text of the item without the prefix and suffix content.",
+          "type": "string"
+        },
+        {
+          "name": "styles",
+          "type": "CSSResult",
+          "default": "\"styles\""
+        },
+        {
+          "name": "value",
+          "attribute": "value",
+          "description": "Тhe current value of the item.\nIf not specified, the element's text content is used.",
+          "type": "string"
+        },
+        {
+          "name": "selected",
+          "attribute": "selected",
+          "description": "Determines whether the item is selected.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "active",
+          "attribute": "active",
+          "description": "Determines whether the item is active.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Determines whether the item is disabled.",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Renders the all content bar the prefix and suffix."
+        },
+        {
+          "name": "prefix",
+          "description": "Renders content before the main content area."
+        },
+        {
+          "name": "suffix",
+          "description": "Renders content after the main content area."
+        }
+      ],
+      "cssParts": [
+        {
+          "name": "prefix",
+          "description": "The prefix wrapper."
+        },
+        {
+          "name": "content",
+          "description": "The main content wrapper."
+        },
+        {
+          "name": "suffix",
+          "description": "The suffix wrapper."
+        }
+      ]
+    },
+    {
+      "name": "igc-select",
+      "path": "./src/components/select/select.ts",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The value attribute of the control.",
+          "type": "string | undefined"
+        },
+        {
+          "name": "name",
+          "description": "The name attribute of the control.",
+          "type": "string"
+        },
+        {
+          "name": "disabled",
+          "description": "The disabled attribute of the control.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "required",
+          "description": "The required attribute of the control.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "invalid",
+          "description": "The invalid attribute of the control.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "outlined",
+          "description": "The outlined attribute of the control.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "autofocus",
+          "description": "The autofocus attribute of the control.",
+          "type": "boolean"
+        },
+        {
+          "name": "label",
+          "description": "The label attribute of the control.",
+          "type": "string"
+        },
+        {
+          "name": "placeholder",
+          "description": "The placeholder attribute of the control.",
+          "type": "string"
+        },
+        {
+          "name": "dir",
+          "description": "The direction attribute of the control.",
+          "type": "\"ltr\" | \"rtl\" | \"auto\"",
+          "default": "\"auto\""
+        },
+        {
+          "name": "keep-open-on-select",
+          "description": "Whether the dropdown should be kept open on selection.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "scroll-strategy",
+          "description": "Determines the behavior of the component during scrolling the container.",
+          "type": "\"scroll\" | \"block\" | \"close\"",
+          "default": "\"scroll\""
+        },
+        {
+          "name": "keep-open-on-outside-click",
+          "description": "Whether the component should be kept open on clicking outside of it.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "open",
+          "description": "Sets the open state of the component.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "placement",
+          "description": "The preferred placement of the component around the target element.",
+          "type": "\"top\" | \"top-start\" | \"top-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"right\" | \"right-start\" | \"right-end\" | \"left\" | \"left-start\" | \"left-end\"",
+          "default": "\"bottom-start\""
+        },
+        {
+          "name": "position-strategy",
+          "description": "Sets the component's positioning strategy.",
+          "type": "\"absolute\" | \"fixed\"",
+          "default": "\"absolute\""
+        },
+        {
+          "name": "flip",
+          "description": "Whether the component should be flipped to the opposite side of the target once it's about to overflow the visible area.\nWhen true, once enough space is detected on its preferred side, it will flip back.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "distance",
+          "description": "The distance from the target element.",
+          "type": "number",
+          "default": "0"
+        },
+        {
+          "name": "same-width",
+          "description": "Whether the dropdown's width should be the same as the target's one.",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "size",
+          "description": "Determines the size of the component.",
+          "type": "\"small\" | \"medium\" | \"large\"",
+          "default": "\"medium\""
+        }
+      ],
+      "properties": [
+        {
+          "name": "value",
+          "attribute": "value",
+          "description": "The value attribute of the control.",
+          "type": "string | undefined"
+        },
+        {
+          "name": "name",
+          "attribute": "name",
+          "description": "The name attribute of the control.",
+          "type": "string"
+        },
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "The disabled attribute of the control.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "required",
+          "attribute": "required",
+          "description": "The required attribute of the control.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "invalid",
+          "attribute": "invalid",
+          "description": "The invalid attribute of the control.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "outlined",
+          "attribute": "outlined",
+          "description": "The outlined attribute of the control.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "autofocus",
+          "attribute": "autofocus",
+          "description": "The autofocus attribute of the control.",
+          "type": "boolean"
+        },
+        {
+          "name": "label",
+          "attribute": "label",
+          "description": "The label attribute of the control.",
+          "type": "string"
+        },
+        {
+          "name": "placeholder",
+          "attribute": "placeholder",
+          "description": "The placeholder attribute of the control.",
+          "type": "string"
+        },
+        {
+          "name": "dir",
+          "attribute": "dir",
+          "description": "The direction attribute of the control.",
+          "type": "\"ltr\" | \"rtl\" | \"auto\"",
+          "default": "\"auto\""
+        },
+        {
+          "name": "styles",
+          "type": "CSSResult",
+          "default": "\"styles\""
+        },
+        {
+          "name": "keepOpenOnSelect",
+          "attribute": "keep-open-on-select",
+          "description": "Whether the dropdown should be kept open on selection.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "scrollStrategy",
+          "attribute": "scroll-strategy",
+          "description": "Determines the behavior of the component during scrolling the container.",
+          "type": "\"scroll\" | \"block\" | \"close\"",
+          "default": "\"scroll\""
+        },
+        {
+          "name": "keepOpenOnOutsideClick",
+          "attribute": "keep-open-on-outside-click",
+          "description": "Whether the component should be kept open on clicking outside of it.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "open",
+          "attribute": "open",
+          "description": "Sets the open state of the component.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "placement",
+          "attribute": "placement",
+          "description": "The preferred placement of the component around the target element.",
+          "type": "\"top\" | \"top-start\" | \"top-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"right\" | \"right-start\" | \"right-end\" | \"left\" | \"left-start\" | \"left-end\"",
+          "default": "\"bottom-start\""
+        },
+        {
+          "name": "positionStrategy",
+          "attribute": "position-strategy",
+          "description": "Sets the component's positioning strategy.",
+          "type": "\"absolute\" | \"fixed\"",
+          "default": "\"absolute\""
+        },
+        {
+          "name": "flip",
+          "attribute": "flip",
+          "description": "Whether the component should be flipped to the opposite side of the target once it's about to overflow the visible area.\nWhen true, once enough space is detected on its preferred side, it will flip back.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "distance",
+          "attribute": "distance",
+          "description": "The distance from the target element.",
+          "type": "number",
+          "default": "0"
+        },
+        {
+          "name": "sameWidth",
+          "attribute": "same-width",
+          "description": "Whether the dropdown's width should be the same as the target's one.",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "size",
+          "attribute": "size",
+          "description": "Determines the size of the component.",
+          "type": "\"small\" | \"medium\" | \"large\"",
+          "default": "\"medium\""
+        }
+      ],
+      "events": [
+        {
+          "name": "igcChange",
+          "description": "Emitted when the selected item changes."
+        },
+        {
+          "name": "igcOpening",
+          "description": "Emitted just before the dropdown is open."
+        },
+        {
+          "name": "igcOpened",
+          "description": "Emitted after the dropdown is open."
+        },
+        {
+          "name": "igcClosing",
+          "description": "Emitter just before the dropdown is closed."
+        },
+        {
+          "name": "igcClosed",
+          "description": "Emitted after closing the dropdown."
+        }
+      ],
+      "slots": [
+        {
+          "name": "target",
+          "description": "Renders the dropdown's target element."
+        },
+        {
+          "name": "",
+          "description": "Renders the dropdown list items."
+        }
+      ],
+      "cssParts": [
+        {
+          "name": "base",
+          "description": "The dropdown list wrapper."
+        },
+        {
+          "name": "list",
+          "description": "The dropdown list."
+        }
+      ]
+    },
     {
       "name": "igc-range-slider",
       "path": "./src/components/slider/range-slider.ts",