@momentum-design/components 0.85.5 → 0.85.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/dist/browser/index.js +242 -218
  2. package/dist/browser/index.js.map +4 -4
  3. package/dist/components/menubar/menubar.component.d.ts +7 -1
  4. package/dist/components/menubar/menubar.component.js +37 -19
  5. package/dist/components/menuitem/menuitem.component.d.ts +21 -1
  6. package/dist/components/menuitem/menuitem.component.js +29 -1
  7. package/dist/components/menuitemcheckbox/menuitemcheckbox.component.d.ts +26 -15
  8. package/dist/components/menuitemcheckbox/menuitemcheckbox.component.js +42 -25
  9. package/dist/components/menuitemcheckbox/menuitemcheckbox.constants.d.ts +1 -1
  10. package/dist/components/menuitemcheckbox/menuitemcheckbox.constants.js +1 -2
  11. package/dist/components/menuitemcheckbox/menuitemcheckbox.styles.js +0 -6
  12. package/dist/components/menuitemradio/menuitemradio.component.d.ts +61 -12
  13. package/dist/components/menuitemradio/menuitemradio.component.js +125 -40
  14. package/dist/components/menuitemradio/menuitemradio.constants.d.ts +9 -1
  15. package/dist/components/menuitemradio/menuitemradio.constants.js +9 -1
  16. package/dist/components/menuitemradio/menuitemradio.styles.d.ts +2 -0
  17. package/dist/components/menuitemradio/menuitemradio.styles.js +7 -0
  18. package/dist/components/menuitemradio/menuitemradio.types.d.ts +4 -1
  19. package/dist/components/menupopover/menupopover.component.d.ts +6 -0
  20. package/dist/components/menupopover/menupopover.component.js +11 -3
  21. package/dist/components/menupopover/menupopover.styles.js +4 -0
  22. package/dist/components/menupopover/menupopover.types.d.ts +11 -0
  23. package/dist/components/menupopover/menupopover.types.js +1 -0
  24. package/dist/components/menupopover/menupopover.utils.d.ts +4 -2
  25. package/dist/components/menupopover/menupopover.utils.js +1 -1
  26. package/dist/components/menusection/menusection.component.d.ts +15 -2
  27. package/dist/components/menusection/menusection.component.js +55 -4
  28. package/dist/components/menusection/menusection.constants.d.ts +1 -5
  29. package/dist/components/menusection/menusection.constants.js +1 -5
  30. package/dist/components/menusection/menusection.styles.d.ts +2 -0
  31. package/dist/components/menusection/menusection.styles.js +11 -0
  32. package/dist/components/menusection/menusection.types.d.ts +7 -4
  33. package/dist/custom-elements.json +619 -295
  34. package/dist/index.d.ts +3 -1
  35. package/dist/react/menuitem/index.d.ts +12 -1
  36. package/dist/react/menuitem/index.js +12 -1
  37. package/dist/react/menuitemcheckbox/index.d.ts +18 -7
  38. package/dist/react/menuitemcheckbox/index.js +18 -7
  39. package/dist/react/menuitemradio/index.d.ts +25 -2
  40. package/dist/react/menuitemradio/index.js +25 -2
  41. package/dist/react/menupopover/index.d.ts +8 -0
  42. package/dist/react/menupopover/index.js +8 -0
  43. package/dist/react/menusection/index.d.ts +6 -1
  44. package/dist/react/menusection/index.js +5 -1
  45. package/dist/utils/types.d.ts +10 -0
  46. package/package.json +1 -1
@@ -15228,7 +15228,9 @@
15228
15228
  "name": "menuItems",
15229
15229
  "type": {
15230
15230
  "text": "Array<HTMLElement>"
15231
- }
15231
+ },
15232
+ "description": "Returns all menuitem elements, including those nested inside menusection.",
15233
+ "readonly": true
15232
15234
  },
15233
15235
  {
15234
15236
  "kind": "method",
@@ -15386,7 +15388,8 @@
15386
15388
  "text": "HTMLElement"
15387
15389
  }
15388
15390
  }
15389
- ]
15391
+ ],
15392
+ "description": "Determines if a menuitem is a top-level menuitem (direct child of menubar or child of menusection whose parent is menubar)"
15390
15393
  },
15391
15394
  {
15392
15395
  "kind": "method",
@@ -15528,8 +15531,66 @@
15528
15531
  "declarations": [
15529
15532
  {
15530
15533
  "kind": "class",
15531
- "description": "menuitem component is inherited by listitem component with the role set `menuitem`.<br/>\nA menu item can contain an icon on the leading or trailing side.\n\nThe leading and trailing slots can be used to display controls and text.<br/>\nBased on the leading/trailing slot, the position of the controls and text can be adjusted.\n\nPlease use mdc-menu as a parent element even when there is only menuitem for a11y purpose.",
15534
+ "description": "menuitem component is inherited by listitem component with the role set `menuitem`.<br/>\nA menu item can contain an icon on the leading or trailing side.\n\nThe leading and trailing slots can be used to display controls and text.<br/>\nBased on the leading/trailing slot, the position of the controls and text can be adjusted.\n\nPlease use element with role=menu as a parent element even when there is only menuitem for a11y purpose.\nFor example mdc-menupopover or mdc-menubar.\n\nMenu item has `name` and `value` attribute that can be used to identify the menu item when it is selected.",
15532
15535
  "name": "MenuItem",
15536
+ "slots": [
15537
+ {
15538
+ "description": "slot for menu item controls to appear of leading end.",
15539
+ "name": "leading-controls",
15540
+ "inheritedFrom": {
15541
+ "name": "ListItem",
15542
+ "module": "src/components/listitem/listitem.component.ts"
15543
+ }
15544
+ },
15545
+ {
15546
+ "description": "slot for menu item primary label.",
15547
+ "name": "leading-text-primary-label",
15548
+ "inheritedFrom": {
15549
+ "name": "ListItem",
15550
+ "module": "src/components/listitem/listitem.component.ts"
15551
+ }
15552
+ },
15553
+ {
15554
+ "description": "slot for menu item secondary label.",
15555
+ "name": "leading-text-secondary-label",
15556
+ "inheritedFrom": {
15557
+ "name": "ListItem",
15558
+ "module": "src/components/listitem/listitem.component.ts"
15559
+ }
15560
+ },
15561
+ {
15562
+ "description": "slot for menu item tertiary label.",
15563
+ "name": "leading-text-tertiary-label",
15564
+ "inheritedFrom": {
15565
+ "name": "ListItem",
15566
+ "module": "src/components/listitem/listitem.component.ts"
15567
+ }
15568
+ },
15569
+ {
15570
+ "description": "slot for menu item side header text.",
15571
+ "name": "trailing-text-side-header",
15572
+ "inheritedFrom": {
15573
+ "name": "ListItem",
15574
+ "module": "src/components/listitem/listitem.component.ts"
15575
+ }
15576
+ },
15577
+ {
15578
+ "description": "slot for menu item subline text.",
15579
+ "name": "trailing-text-subline",
15580
+ "inheritedFrom": {
15581
+ "name": "ListItem",
15582
+ "module": "src/components/listitem/listitem.component.ts"
15583
+ }
15584
+ },
15585
+ {
15586
+ "description": "slot for menu item controls to appear of trailing end.",
15587
+ "name": "trailing-controls",
15588
+ "inheritedFrom": {
15589
+ "name": "ListItem",
15590
+ "module": "src/components/listitem/listitem.component.ts"
15591
+ }
15592
+ }
15593
+ ],
15533
15594
  "members": [
15534
15595
  {
15535
15596
  "kind": "field",
@@ -15551,6 +15612,28 @@
15551
15612
  "attribute": "arrow-direction",
15552
15613
  "reflects": true
15553
15614
  },
15615
+ {
15616
+ "kind": "field",
15617
+ "name": "name",
15618
+ "type": {
15619
+ "text": "undefined | string | undefined"
15620
+ },
15621
+ "default": "undefined",
15622
+ "description": "The name attribute is used to identify the menu item when it is selected.",
15623
+ "attribute": "name",
15624
+ "reflects": true
15625
+ },
15626
+ {
15627
+ "kind": "field",
15628
+ "name": "value",
15629
+ "type": {
15630
+ "text": "undefined | string | undefined"
15631
+ },
15632
+ "default": "undefined",
15633
+ "description": "The value attribute is used to represent a value when the menu item is selected.\nIt is typically used with checkbox and radio menu items, but can be handy for any menu item.",
15634
+ "attribute": "value",
15635
+ "reflects": true
15636
+ },
15554
15637
  {
15555
15638
  "kind": "method",
15556
15639
  "name": "handleKeyDown",
@@ -15983,6 +16066,24 @@
15983
16066
  "description": "Defines the direction the arrow icon points.\n- `'positive'`: Arrow points toward the trailing side.\n- `'negative'`: Arrow points toward the leading side.",
15984
16067
  "fieldName": "arrowDirection"
15985
16068
  },
16069
+ {
16070
+ "name": "name",
16071
+ "type": {
16072
+ "text": "undefined | string | undefined"
16073
+ },
16074
+ "default": "undefined",
16075
+ "description": "The name attribute is used to identify the menu item when it is selected.",
16076
+ "fieldName": "name"
16077
+ },
16078
+ {
16079
+ "name": "value",
16080
+ "type": {
16081
+ "text": "undefined | string | undefined"
16082
+ },
16083
+ "default": "undefined",
16084
+ "description": "The value attribute is used to represent a value when the menu item is selected.\nIt is typically used with checkbox and radio menu items, but can be handy for any menu item.",
16085
+ "fieldName": "value"
16086
+ },
15986
16087
  {
15987
16088
  "name": "disabled",
15988
16089
  "type": {
@@ -16126,66 +16227,8 @@
16126
16227
  "module": "/src/components/listitem/listitem.component"
16127
16228
  },
16128
16229
  "tagName": "mdc-menuitem",
16129
- "jsDoc": "/**\n * menuitem component is inherited by listitem component with the role set `menuitem`.<br/>\n * A menu item can contain an icon on the leading or trailing side.\n *\n * The leading and trailing slots can be used to display controls and text.<br/>\n * Based on the leading/trailing slot, the position of the controls and text can be adjusted.\n *\n * Please use mdc-menu as a parent element even when there is only menuitem for a11y purpose.\n *\n * @dependency mdc-text\n * @dependency mdc-icon\n * @dependency mdc-tooltip\n *\n * @tagname mdc-menuitem\n *\n * @event click - (React: onClick) This event is dispatched when the menuitem is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the menuitem.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the menuitem.\n * @event focus - (React: onFocus) This event is dispatched when the menuitem receives focus.\n */",
16230
+ "jsDoc": "/**\n * menuitem component is inherited by listitem component with the role set `menuitem`.<br/>\n * A menu item can contain an icon on the leading or trailing side.\n *\n * The leading and trailing slots can be used to display controls and text.<br/>\n * Based on the leading/trailing slot, the position of the controls and text can be adjusted.\n *\n * Please use element with role=menu as a parent element even when there is only menuitem for a11y purpose.\n * For example mdc-menupopover or mdc-menubar.\n *\n * Menu item has `name` and `value` attribute that can be used to identify the menu item when it is selected.\n *\n * @dependency mdc-text\n * @dependency mdc-icon\n * @dependency mdc-tooltip\n *\n * @tagname mdc-menuitem\n *\n * @slot leading-controls - slot for menu item controls to appear of leading end.\n * @slot leading-text-primary-label - slot for menu item primary label.\n * @slot leading-text-secondary-label - slot for menu item secondary label.\n * @slot leading-text-tertiary-label - slot for menu item tertiary label.\n * @slot trailing-text-side-header - slot for menu item side header text.\n * @slot trailing-text-subline - slot for menu item subline text.\n * @slot trailing-controls - slot for menu item controls to appear of trailing end.\n *\n * @event click - (React: onClick) This event is dispatched when the menuitem is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the menuitem.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the menuitem.\n * @event focus - (React: onFocus) This event is dispatched when the menuitem receives focus.\n */",
16130
16231
  "customElement": true,
16131
- "slots": [
16132
- {
16133
- "description": "slot for list item controls to appear of leading end.",
16134
- "name": "leading-controls",
16135
- "inheritedFrom": {
16136
- "name": "ListItem",
16137
- "module": "src/components/listitem/listitem.component.ts"
16138
- }
16139
- },
16140
- {
16141
- "description": "slot for list item primary label.",
16142
- "name": "leading-text-primary-label",
16143
- "inheritedFrom": {
16144
- "name": "ListItem",
16145
- "module": "src/components/listitem/listitem.component.ts"
16146
- }
16147
- },
16148
- {
16149
- "description": "slot for list item secondary label.",
16150
- "name": "leading-text-secondary-label",
16151
- "inheritedFrom": {
16152
- "name": "ListItem",
16153
- "module": "src/components/listitem/listitem.component.ts"
16154
- }
16155
- },
16156
- {
16157
- "description": "slot for list item tertiary label.",
16158
- "name": "leading-text-tertiary-label",
16159
- "inheritedFrom": {
16160
- "name": "ListItem",
16161
- "module": "src/components/listitem/listitem.component.ts"
16162
- }
16163
- },
16164
- {
16165
- "description": "slot for list item side header text.",
16166
- "name": "trailing-text-side-header",
16167
- "inheritedFrom": {
16168
- "name": "ListItem",
16169
- "module": "src/components/listitem/listitem.component.ts"
16170
- }
16171
- },
16172
- {
16173
- "description": "slot for list item subline text.",
16174
- "name": "trailing-text-subline",
16175
- "inheritedFrom": {
16176
- "name": "ListItem",
16177
- "module": "src/components/listitem/listitem.component.ts"
16178
- }
16179
- },
16180
- {
16181
- "description": "slot for list item controls to appear of trailing end.",
16182
- "name": "trailing-controls",
16183
- "inheritedFrom": {
16184
- "name": "ListItem",
16185
- "module": "src/components/listitem/listitem.component.ts"
16186
- }
16187
- }
16188
- ],
16189
16232
  "cssProperties": [
16190
16233
  {
16191
16234
  "description": "Allows customization of the default background color.",
@@ -16271,72 +16314,60 @@
16271
16314
  "declarations": [
16272
16315
  {
16273
16316
  "kind": "class",
16274
- "description": "A menuitemcheckbox component is a checkable menuitem.\nThere should be no focusable descendants inside this menuitemcheckbox component.\n\nThe `aria-checked` attribute indicates whether the menuitemcheckbox is checked or not.\n\nThe `indicator` attribute is used to differentiate between <b>checkbox</b>, <b>checkmark</b> and <b>toggle</b>.\nBy default the `indicator` is set to <b>checkbox</b>.<br/>\n\nThe checkbox will always be positioned on the leading side of the menuitem label and\nthe toggle and checkmark will always be positioned on the trailing side.\n\nThe checkbox will have the possible states of `true` or `false`.\nIf the indicator is set to <b>checkmark</b> and if the `aria-checked` attribute is set to `true`,\nthen the checkmark will be displayed. if not, then no indicator will be displayed.\n\nIf you want only one item in a group to be checked, consider using menuitemradio component.\n\nIf a menuitemcheckbox is disabled, then the `aria-disabled` attribute is set to `true`.",
16317
+ "description": "A menuitemcheckbox component is a checkable menuitem.\nThere should be no focusable descendants inside this menuitemcheckbox component.\n\nThe `checked` attribute indicates whether the menuitemcheckbox is checked or not.\n\nMenu item checkbox has `name` and `value` attribute that can be used to identify the menu item when it is selected.\n\nThe `indicator` attribute is used to differentiate between <b>checkbox</b>, <b>checkmark</b>, <b>toggle</b> and <b>none</b>.\nBy default, the `indicator` is set to <b>checkbox</b>.<br/>\n\nThe checkbox will always be positioned on the leading side of the menuitem label and\nthe toggle and checkmark will always be positioned on the trailing side.\n\nThe checkbox will have the possible states of `true` or `false`.\nIf the indicator is set to <b>checkmark</b> and if the `checked` attribute is set to `true`,\nthen the checkmark will be displayed. if not, then no indicator will be displayed.\n\nThe forth options for the `indicator` is <b>none</b>, which will not display any indicator at all.\nIt is intended to be used for customised menu items where the indicator is implemented differently.\nFor example, you can use a custom icon or a different visual element to indicate the state of the menu item.\nMake sure the new indicator is accessible.\n\nIf you want only one item in a group to be checked, consider using menuitemradio component.",
16275
16318
  "name": "MenuItemCheckbox",
16276
- "cssProperties": [
16277
- {
16278
- "description": "Allows customization of the checkmark indicator color",
16279
- "name": "--mdc-checkmark-indicator-color"
16280
- },
16281
- {
16282
- "description": "Allows customization of the default background color.",
16283
- "name": "--mdc-listitem-default-background-color",
16284
- "inheritedFrom": {
16285
- "name": "ListItem",
16286
- "module": "src/components/listitem/listitem.component.ts"
16287
- }
16288
- },
16319
+ "slots": [
16289
16320
  {
16290
- "description": "Allows customization of the background color on hover.",
16291
- "name": "--mdc-listitem-background-color-hover",
16321
+ "description": "slot for menu item checkbox controls to appear of leading end.",
16322
+ "name": "leading-controls",
16292
16323
  "inheritedFrom": {
16293
16324
  "name": "ListItem",
16294
16325
  "module": "src/components/listitem/listitem.component.ts"
16295
16326
  }
16296
16327
  },
16297
16328
  {
16298
- "description": "Allows customization of the background color when pressed.",
16299
- "name": "--mdc-listitem-background-color-active",
16329
+ "description": "slot for menu item checkbox primary label.",
16330
+ "name": "leading-text-primary-label",
16300
16331
  "inheritedFrom": {
16301
16332
  "name": "ListItem",
16302
16333
  "module": "src/components/listitem/listitem.component.ts"
16303
16334
  }
16304
16335
  },
16305
16336
  {
16306
- "description": "Allows customization of the primary label, side header and subline text slot color.",
16307
- "name": "--mdc-listitem-primary-label-color",
16337
+ "description": "slot for menu item checkbox secondary label.",
16338
+ "name": "leading-text-secondary-label",
16308
16339
  "inheritedFrom": {
16309
16340
  "name": "ListItem",
16310
16341
  "module": "src/components/listitem/listitem.component.ts"
16311
16342
  }
16312
16343
  },
16313
16344
  {
16314
- "description": "Allows customization of the secondary and tertiary label text slot color.",
16315
- "name": "--mdc-listitem-secondary-label-color",
16345
+ "description": "slot for menu item checkbox tertiary label.",
16346
+ "name": "leading-text-tertiary-label",
16316
16347
  "inheritedFrom": {
16317
16348
  "name": "ListItem",
16318
16349
  "module": "src/components/listitem/listitem.component.ts"
16319
16350
  }
16320
16351
  },
16321
16352
  {
16322
- "description": "Allows customization of the disabled color.",
16323
- "name": "--mdc-listitem-disabled-color",
16353
+ "description": "slot for menu item checkbox side header text.",
16354
+ "name": "trailing-text-side-header",
16324
16355
  "inheritedFrom": {
16325
16356
  "name": "ListItem",
16326
16357
  "module": "src/components/listitem/listitem.component.ts"
16327
16358
  }
16328
16359
  },
16329
16360
  {
16330
- "description": "Allows customization of column gap.",
16331
- "name": "--mdc-listitem-column-gap",
16361
+ "description": "slot for menu item checkbox subline text.",
16362
+ "name": "trailing-text-subline",
16332
16363
  "inheritedFrom": {
16333
16364
  "name": "ListItem",
16334
16365
  "module": "src/components/listitem/listitem.component.ts"
16335
16366
  }
16336
16367
  },
16337
16368
  {
16338
- "description": "Allows customization of padding left and right.",
16339
- "name": "--mdc-listitem-padding-left-and-right",
16369
+ "description": "slot for menu item checkbox controls to appear of trailing end.",
16370
+ "name": "trailing-controls",
16340
16371
  "inheritedFrom": {
16341
16372
  "name": "ListItem",
16342
16373
  "module": "src/components/listitem/listitem.component.ts"
@@ -16346,13 +16377,13 @@
16346
16377
  "members": [
16347
16378
  {
16348
16379
  "kind": "field",
16349
- "name": "ariaChecked",
16380
+ "name": "checked",
16350
16381
  "type": {
16351
- "text": "AriaCheckedStates"
16382
+ "text": "boolean"
16352
16383
  },
16353
- "description": "The aria-checked attribute is used to indicate that the menuitemcheckbox is checked or not.",
16354
- "default": "'false'",
16355
- "attribute": "aria-checked",
16384
+ "default": "false",
16385
+ "description": "The checked attribute is used to indicate that the menuitemcheckbox is checked or not.",
16386
+ "attribute": "checked",
16356
16387
  "reflects": true
16357
16388
  },
16358
16389
  {
@@ -16370,7 +16401,7 @@
16370
16401
  "kind": "field",
16371
16402
  "name": "menuitemcheckboxHandleClick",
16372
16403
  "privacy": "private",
16373
- "description": "Handles click events to toggle checked state\nIf the menuitemcheckbox is disabled, it does nothing.\nIf the menuitemcheckbox is not disabled, it toggles the `aria-checked` state between `true` and `false`."
16404
+ "description": "Handles click events to toggle checked state\nIf the menuitemcheckbox is disabled, it does nothing.\nIf the menuitemcheckbox is not disabled, it toggles the `checked` state between `true` and `false`."
16374
16405
  },
16375
16406
  {
16376
16407
  "kind": "method",
@@ -16403,7 +16434,7 @@
16403
16434
  "text": ""
16404
16435
  }
16405
16436
  },
16406
- "description": "Returns a checkmark icon if the indicator is set to checkmark and the aria-checked state is true.\nIf the indicator is not set to checkmark or the aria-checked state is false, it returns nothing.\n\nThe checkmark icon will always be positioned on the trailing side of the menuitem label."
16437
+ "description": "Returns a checkmark icon if the indicator is set to checkmark and the checked state is true.\nIf the indicator is not set to checkmark or the checked state is false, it returns nothing.\n\nThe checkmark icon will always be positioned on the trailing side of the menuitem label."
16407
16438
  },
16408
16439
  {
16409
16440
  "kind": "field",
@@ -16433,6 +16464,36 @@
16433
16464
  "module": "components/menuitem/menuitem.component.js"
16434
16465
  }
16435
16466
  },
16467
+ {
16468
+ "kind": "field",
16469
+ "name": "name",
16470
+ "type": {
16471
+ "text": "undefined | string | undefined"
16472
+ },
16473
+ "default": "undefined",
16474
+ "description": "The name attribute is used to identify the menu item when it is selected.",
16475
+ "attribute": "name",
16476
+ "reflects": true,
16477
+ "inheritedFrom": {
16478
+ "name": "MenuItem",
16479
+ "module": "components/menuitem/menuitem.component.js"
16480
+ }
16481
+ },
16482
+ {
16483
+ "kind": "field",
16484
+ "name": "value",
16485
+ "type": {
16486
+ "text": "undefined | string | undefined"
16487
+ },
16488
+ "default": "undefined",
16489
+ "description": "The value attribute is used to represent a value when the menu item is selected.\nIt is typically used with checkbox and radio menu items, but can be handy for any menu item.",
16490
+ "attribute": "value",
16491
+ "reflects": true,
16492
+ "inheritedFrom": {
16493
+ "name": "MenuItem",
16494
+ "module": "components/menuitem/menuitem.component.js"
16495
+ }
16496
+ },
16436
16497
  {
16437
16498
  "kind": "method",
16438
16499
  "name": "handleKeyDown",
@@ -16859,13 +16920,13 @@
16859
16920
  ],
16860
16921
  "attributes": [
16861
16922
  {
16862
- "name": "aria-checked",
16923
+ "name": "checked",
16863
16924
  "type": {
16864
- "text": "AriaCheckedStates"
16925
+ "text": "boolean"
16865
16926
  },
16866
- "description": "The aria-checked attribute is used to indicate that the menuitemcheckbox is checked or not.",
16867
- "default": "'false'",
16868
- "fieldName": "ariaChecked"
16927
+ "default": "false",
16928
+ "description": "The checked attribute is used to indicate that the menuitemcheckbox is checked or not.",
16929
+ "fieldName": "checked"
16869
16930
  },
16870
16931
  {
16871
16932
  "name": "indicator",
@@ -16900,6 +16961,32 @@
16900
16961
  "module": "src/components/menuitem/menuitem.component.ts"
16901
16962
  }
16902
16963
  },
16964
+ {
16965
+ "name": "name",
16966
+ "type": {
16967
+ "text": "undefined | string | undefined"
16968
+ },
16969
+ "default": "undefined",
16970
+ "description": "The name attribute is used to identify the menu item when it is selected.",
16971
+ "fieldName": "name",
16972
+ "inheritedFrom": {
16973
+ "name": "MenuItem",
16974
+ "module": "src/components/menuitem/menuitem.component.ts"
16975
+ }
16976
+ },
16977
+ {
16978
+ "name": "value",
16979
+ "type": {
16980
+ "text": "undefined | string | undefined"
16981
+ },
16982
+ "default": "undefined",
16983
+ "description": "The value attribute is used to represent a value when the menu item is selected.\nIt is typically used with checkbox and radio menu items, but can be handy for any menu item.",
16984
+ "fieldName": "value",
16985
+ "inheritedFrom": {
16986
+ "name": "MenuItem",
16987
+ "module": "src/components/menuitem/menuitem.component.ts"
16988
+ }
16989
+ },
16903
16990
  {
16904
16991
  "name": "disabled",
16905
16992
  "type": {
@@ -17043,60 +17130,68 @@
17043
17130
  "module": "/src/components/menuitem/menuitem.component"
17044
17131
  },
17045
17132
  "tagName": "mdc-menuitemcheckbox",
17046
- "jsDoc": "/**\n * A menuitemcheckbox component is a checkable menuitem.\n * There should be no focusable descendants inside this menuitemcheckbox component.\n *\n * The `aria-checked` attribute indicates whether the menuitemcheckbox is checked or not.\n *\n * The `indicator` attribute is used to differentiate between <b>checkbox</b>, <b>checkmark</b> and <b>toggle</b>.\n * By default the `indicator` is set to <b>checkbox</b>.<br/>\n *\n * The checkbox will always be positioned on the leading side of the menuitem label and\n * the toggle and checkmark will always be positioned on the trailing side.\n *\n * The checkbox will have the possible states of `true` or `false`.\n * If the indicator is set to <b>checkmark</b> and if the `aria-checked` attribute is set to `true`,\n * then the checkmark will be displayed. if not, then no indicator will be displayed.\n *\n * If you want only one item in a group to be checked, consider using menuitemradio component.\n *\n * If a menuitemcheckbox is disabled, then the `aria-disabled` attribute is set to `true`.\n *\n * @dependency mdc-staticcheckbox\n * @dependency mdc-statictoggle\n * @dependency mdc-icon\n *\n * @tagname mdc-menuitemcheckbox\n *\n * @cssproperty --mdc-checkmark-indicator-color - Allows customization of the checkmark indicator color\n *\n * @event change - (React: onChange) This event is dispatched when the menuitemcheckbox changes.\n * @event click - (React: onClick) This event is dispatched when the menuitemcheckbox is clicked.\n * @event focus - (React: onFocus) This event is dispatched when the menuitemcheckbox receives focus.\n */",
17133
+ "jsDoc": "/**\n * A menuitemcheckbox component is a checkable menuitem.\n * There should be no focusable descendants inside this menuitemcheckbox component.\n *\n * The `checked` attribute indicates whether the menuitemcheckbox is checked or not.\n *\n * Menu item checkbox has `name` and `value` attribute that can be used to identify the menu item when it is selected.\n *\n * The `indicator` attribute is used to differentiate between <b>checkbox</b>, <b>checkmark</b>, <b>toggle</b> and <b>none</b>.\n * By default, the `indicator` is set to <b>checkbox</b>.<br/>\n *\n * The checkbox will always be positioned on the leading side of the menuitem label and\n * the toggle and checkmark will always be positioned on the trailing side.\n *\n * The checkbox will have the possible states of `true` or `false`.\n * If the indicator is set to <b>checkmark</b> and if the `checked` attribute is set to `true`,\n * then the checkmark will be displayed. if not, then no indicator will be displayed.\n *\n * The forth options for the `indicator` is <b>none</b>, which will not display any indicator at all.\n * It is intended to be used for customised menu items where the indicator is implemented differently.\n * For example, you can use a custom icon or a different visual element to indicate the state of the menu item.\n * Make sure the new indicator is accessible.\n *\n * If you want only one item in a group to be checked, consider using menuitemradio component.\n *\n * @dependency mdc-staticcheckbox\n * @dependency mdc-statictoggle\n * @dependency mdc-icon\n *\n * @tagname mdc-menuitemcheckbox\n *\n * @slot leading-controls - slot for menu item checkbox controls to appear of leading end.\n * @slot leading-text-primary-label - slot for menu item checkbox primary label.\n * @slot leading-text-secondary-label - slot for menu item checkbox secondary label.\n * @slot leading-text-tertiary-label - slot for menu item checkbox tertiary label.\n * @slot trailing-text-side-header - slot for menu item checkbox side header text.\n * @slot trailing-text-subline - slot for menu item checkbox subline text.\n * @slot trailing-controls - slot for menu item checkbox controls to appear of trailing end.\n *\n * @event change - (React: onChange) This event is dispatched when the menuitemcheckbox changes.\n * @event click - (React: onClick) This event is dispatched when the menuitemcheckbox is clicked.\n * @event focus - (React: onFocus) This event is dispatched when the menuitemcheckbox receives focus.\n */",
17047
17134
  "customElement": true,
17048
- "slots": [
17135
+ "cssProperties": [
17049
17136
  {
17050
- "description": "slot for list item controls to appear of leading end.",
17051
- "name": "leading-controls",
17137
+ "description": "Allows customization of the default background color.",
17138
+ "name": "--mdc-listitem-default-background-color",
17052
17139
  "inheritedFrom": {
17053
17140
  "name": "ListItem",
17054
17141
  "module": "src/components/listitem/listitem.component.ts"
17055
17142
  }
17056
17143
  },
17057
17144
  {
17058
- "description": "slot for list item primary label.",
17059
- "name": "leading-text-primary-label",
17145
+ "description": "Allows customization of the background color on hover.",
17146
+ "name": "--mdc-listitem-background-color-hover",
17060
17147
  "inheritedFrom": {
17061
17148
  "name": "ListItem",
17062
17149
  "module": "src/components/listitem/listitem.component.ts"
17063
17150
  }
17064
17151
  },
17065
17152
  {
17066
- "description": "slot for list item secondary label.",
17067
- "name": "leading-text-secondary-label",
17153
+ "description": "Allows customization of the background color when pressed.",
17154
+ "name": "--mdc-listitem-background-color-active",
17068
17155
  "inheritedFrom": {
17069
17156
  "name": "ListItem",
17070
17157
  "module": "src/components/listitem/listitem.component.ts"
17071
17158
  }
17072
17159
  },
17073
17160
  {
17074
- "description": "slot for list item tertiary label.",
17075
- "name": "leading-text-tertiary-label",
17161
+ "description": "Allows customization of the primary label, side header and subline text slot color.",
17162
+ "name": "--mdc-listitem-primary-label-color",
17076
17163
  "inheritedFrom": {
17077
17164
  "name": "ListItem",
17078
17165
  "module": "src/components/listitem/listitem.component.ts"
17079
17166
  }
17080
17167
  },
17081
17168
  {
17082
- "description": "slot for list item side header text.",
17083
- "name": "trailing-text-side-header",
17084
- "inheritedFrom": {
17169
+ "description": "Allows customization of the secondary and tertiary label text slot color.",
17170
+ "name": "--mdc-listitem-secondary-label-color",
17171
+ "inheritedFrom": {
17085
17172
  "name": "ListItem",
17086
17173
  "module": "src/components/listitem/listitem.component.ts"
17087
17174
  }
17088
17175
  },
17089
17176
  {
17090
- "description": "slot for list item subline text.",
17091
- "name": "trailing-text-subline",
17177
+ "description": "Allows customization of the disabled color.",
17178
+ "name": "--mdc-listitem-disabled-color",
17092
17179
  "inheritedFrom": {
17093
17180
  "name": "ListItem",
17094
17181
  "module": "src/components/listitem/listitem.component.ts"
17095
17182
  }
17096
17183
  },
17097
17184
  {
17098
- "description": "slot for list item controls to appear of trailing end.",
17099
- "name": "trailing-controls",
17185
+ "description": "Allows customization of column gap.",
17186
+ "name": "--mdc-listitem-column-gap",
17187
+ "inheritedFrom": {
17188
+ "name": "ListItem",
17189
+ "module": "src/components/listitem/listitem.component.ts"
17190
+ }
17191
+ },
17192
+ {
17193
+ "description": "Allows customization of padding left and right.",
17194
+ "name": "--mdc-listitem-padding-left-and-right",
17100
17195
  "inheritedFrom": {
17101
17196
  "name": "ListItem",
17102
17197
  "module": "src/components/listitem/listitem.component.ts"
@@ -17122,36 +17217,138 @@
17122
17217
  "declarations": [
17123
17218
  {
17124
17219
  "kind": "class",
17125
- "description": "A menuitemradio component is a checkable menuitem that is used in a menu.\nA menuitemradio should be checked only one at a time. <br/>\nThere should be no focusable descendants inside this menuitemradio component.\n\nThe `aria-checked` menuitemradio attribute is used to indicate that the menuitemradio is checked or not.\n\nIf you want more than one item in a group to be checked, consider using menuitemcheckbox component.\n\nIf a menuitemradio is disabled, then the `aria-disabled` attribute is set to `true`.",
17220
+ "description": "A menuitemradio component is a checkable menuitem that is used in a menu.\nA menuitemradio should be checked only one at a time. <br/>\nThere should be no focusable descendants inside this menuitemradio component.\n\nThe `checked` menuitemradio attribute is used to indicate that the menuitemradio is checked or not.\n\nMenu item radio has `name` and `value` attribute that can be used to identify the menu item when it is selected.\n\nIf you want more than one item in a group to be checked, consider using menuitemcheckbox component.\n\nThe `indicator` attribute is used to differentiate between <b>radio</b>, <b>checkmark</b> and <b>none</b>.\nBy default, the `indicator` is set to <b>radio</b>.<br/>\n\nThe checkbox will always be positioned on the leading side of the menuitem label and\nthe checkmark will always be positioned on the trailing side.\n\nThe radio will have the possible states of `true` or `false`.\nIf the indicator is set to <b>checkmark</b> and if the `checked` attribute is set to `true`,\nthen the checkmark will be displayed. if not, then no indicator will be displayed.\n\nThe third options for the `indicator` is <b>none</b>, which will not display any indicator at all.\nIt is intended to be used for customised menu items where the indicator is implemented differently.\nFor example, you can use a custom icon or a different visual element to indicate the state of the menu item.\nMake sure the new indicator is accessible.",
17126
17221
  "name": "MenuItemRadio",
17222
+ "slots": [
17223
+ {
17224
+ "description": "slot for menu item radio controls to appear of leading end.",
17225
+ "name": "leading-controls",
17226
+ "inheritedFrom": {
17227
+ "name": "ListItem",
17228
+ "module": "src/components/listitem/listitem.component.ts"
17229
+ }
17230
+ },
17231
+ {
17232
+ "description": "slot for menu item radio primary label.",
17233
+ "name": "leading-text-primary-label",
17234
+ "inheritedFrom": {
17235
+ "name": "ListItem",
17236
+ "module": "src/components/listitem/listitem.component.ts"
17237
+ }
17238
+ },
17239
+ {
17240
+ "description": "slot for menu item radio secondary label.",
17241
+ "name": "leading-text-secondary-label",
17242
+ "inheritedFrom": {
17243
+ "name": "ListItem",
17244
+ "module": "src/components/listitem/listitem.component.ts"
17245
+ }
17246
+ },
17247
+ {
17248
+ "description": "slot for menu item radio tertiary label.",
17249
+ "name": "leading-text-tertiary-label",
17250
+ "inheritedFrom": {
17251
+ "name": "ListItem",
17252
+ "module": "src/components/listitem/listitem.component.ts"
17253
+ }
17254
+ },
17255
+ {
17256
+ "description": "slot for menu item radio side header text.",
17257
+ "name": "trailing-text-side-header",
17258
+ "inheritedFrom": {
17259
+ "name": "ListItem",
17260
+ "module": "src/components/listitem/listitem.component.ts"
17261
+ }
17262
+ },
17263
+ {
17264
+ "description": "slot for menu item radio subline text.",
17265
+ "name": "trailing-text-subline",
17266
+ "inheritedFrom": {
17267
+ "name": "ListItem",
17268
+ "module": "src/components/listitem/listitem.component.ts"
17269
+ }
17270
+ },
17271
+ {
17272
+ "description": "slot for menu item radio controls to appear of trailing end.",
17273
+ "name": "trailing-controls",
17274
+ "inheritedFrom": {
17275
+ "name": "ListItem",
17276
+ "module": "src/components/listitem/listitem.component.ts"
17277
+ }
17278
+ }
17279
+ ],
17127
17280
  "members": [
17128
17281
  {
17129
17282
  "kind": "field",
17130
- "name": "ariaChecked",
17283
+ "name": "checked",
17131
17284
  "type": {
17132
- "text": "AriaCheckedStates"
17285
+ "text": "boolean"
17133
17286
  },
17287
+ "default": "false",
17134
17288
  "description": "The aria-checked attribute is used to indicate that the menuitemradio is checked or not.",
17135
- "default": "'false'",
17136
- "attribute": "aria-checked",
17289
+ "attribute": "checked",
17137
17290
  "reflects": true
17138
17291
  },
17139
17292
  {
17140
17293
  "kind": "field",
17141
- "name": "name",
17294
+ "name": "indicator",
17142
17295
  "type": {
17143
- "text": "string"
17296
+ "text": "Indicator"
17144
17297
  },
17145
- "default": "''",
17146
- "description": "The name attribute is used to group radio items within the same menu container.",
17147
- "attribute": "name",
17298
+ "description": "The indicator attribute is used to differentiate between <b>radio</b>, <b>checkmark</b> and <b>none</b>.",
17299
+ "default": "'radio'",
17300
+ "attribute": "indicator",
17148
17301
  "reflects": true
17149
17302
  },
17303
+ {
17304
+ "kind": "method",
17305
+ "name": "getAllRadiosWithinSameGroup",
17306
+ "privacy": "private",
17307
+ "return": {
17308
+ "type": {
17309
+ "text": "MenuItemRadio[]"
17310
+ }
17311
+ },
17312
+ "description": "Returns all radios within the same group (name)."
17313
+ },
17314
+ {
17315
+ "kind": "method",
17316
+ "name": "updateOtherRadiosCheckedState",
17317
+ "privacy": "private",
17318
+ "return": {
17319
+ "type": {
17320
+ "text": "void"
17321
+ }
17322
+ },
17323
+ "description": "Updates the checked state of all other radios in the same group.\nThis method is called when a radio is clicked to ensure that only one radio in the group can be checked at a time.\nIt sets the `checked` property of all other radios in the same group to `false`."
17324
+ },
17150
17325
  {
17151
17326
  "kind": "field",
17152
- "name": "menuitemradioHandleClick",
17327
+ "name": "radioHandleClick",
17153
17328
  "privacy": "private",
17154
- "description": "Handles click events to set checked state and uncheck siblings in the same group and container.\nIf the menuitemradio is not checked, it sets its aria-checked state to `true`\nand sets all other menuitemradio elements of the same group with aria-checked state to `false`."
17329
+ "description": "Handles click events to set checked state and uncheck siblings in the same group and container.\nIf the menuitemradio is not checked, it sets its checked state to `true`\nand sets all other menuitemradio elements of the same group with checked state to `false`."
17330
+ },
17331
+ {
17332
+ "kind": "method",
17333
+ "name": "renderStaticRadio",
17334
+ "privacy": "private",
17335
+ "return": {
17336
+ "type": {
17337
+ "text": ""
17338
+ }
17339
+ },
17340
+ "description": "Returns a static checkbox element if the indicator is set to checkbox.\nIf the indicator is not set to checkbox, it returns nothing."
17341
+ },
17342
+ {
17343
+ "kind": "method",
17344
+ "name": "renderCheckmarkIcon",
17345
+ "privacy": "private",
17346
+ "return": {
17347
+ "type": {
17348
+ "text": ""
17349
+ }
17350
+ },
17351
+ "description": "Returns a checkmark icon if the indicator is set to checkmark and the checked state is true.\nIf the indicator is not set to checkmark or the checked state is false, it returns nothing.\n\nThe checkmark icon will always be positioned on the trailing side of the menuitem label."
17155
17352
  },
17156
17353
  {
17157
17354
  "kind": "field",
@@ -17181,6 +17378,36 @@
17181
17378
  "module": "components/menuitem/menuitem.component.js"
17182
17379
  }
17183
17380
  },
17381
+ {
17382
+ "kind": "field",
17383
+ "name": "name",
17384
+ "type": {
17385
+ "text": "undefined | string | undefined"
17386
+ },
17387
+ "default": "undefined",
17388
+ "description": "The name attribute is used to identify the menu item when it is selected.",
17389
+ "attribute": "name",
17390
+ "reflects": true,
17391
+ "inheritedFrom": {
17392
+ "name": "MenuItem",
17393
+ "module": "components/menuitem/menuitem.component.js"
17394
+ }
17395
+ },
17396
+ {
17397
+ "kind": "field",
17398
+ "name": "value",
17399
+ "type": {
17400
+ "text": "undefined | string | undefined"
17401
+ },
17402
+ "default": "undefined",
17403
+ "description": "The value attribute is used to represent a value when the menu item is selected.\nIt is typically used with checkbox and radio menu items, but can be handy for any menu item.",
17404
+ "attribute": "value",
17405
+ "reflects": true,
17406
+ "inheritedFrom": {
17407
+ "name": "MenuItem",
17408
+ "module": "components/menuitem/menuitem.component.js"
17409
+ }
17410
+ },
17184
17411
  {
17185
17412
  "kind": "method",
17186
17413
  "name": "handleKeyDown",
@@ -17607,22 +17834,22 @@
17607
17834
  ],
17608
17835
  "attributes": [
17609
17836
  {
17610
- "name": "aria-checked",
17837
+ "name": "checked",
17611
17838
  "type": {
17612
- "text": "AriaCheckedStates"
17839
+ "text": "boolean"
17613
17840
  },
17841
+ "default": "false",
17614
17842
  "description": "The aria-checked attribute is used to indicate that the menuitemradio is checked or not.",
17615
- "default": "'false'",
17616
- "fieldName": "ariaChecked"
17843
+ "fieldName": "checked"
17617
17844
  },
17618
17845
  {
17619
- "name": "name",
17846
+ "name": "indicator",
17620
17847
  "type": {
17621
- "text": "string"
17848
+ "text": "Indicator"
17622
17849
  },
17623
- "default": "''",
17624
- "description": "The name attribute is used to group radio items within the same menu container.",
17625
- "fieldName": "name"
17850
+ "description": "The indicator attribute is used to differentiate between <b>radio</b>, <b>checkmark</b> and <b>none</b>.",
17851
+ "default": "'radio'",
17852
+ "fieldName": "indicator"
17626
17853
  },
17627
17854
  {
17628
17855
  "name": "arrow-position",
@@ -17648,6 +17875,32 @@
17648
17875
  "module": "src/components/menuitem/menuitem.component.ts"
17649
17876
  }
17650
17877
  },
17878
+ {
17879
+ "name": "name",
17880
+ "type": {
17881
+ "text": "undefined | string | undefined"
17882
+ },
17883
+ "default": "undefined",
17884
+ "description": "The name attribute is used to identify the menu item when it is selected.",
17885
+ "fieldName": "name",
17886
+ "inheritedFrom": {
17887
+ "name": "MenuItem",
17888
+ "module": "src/components/menuitem/menuitem.component.ts"
17889
+ }
17890
+ },
17891
+ {
17892
+ "name": "value",
17893
+ "type": {
17894
+ "text": "undefined | string | undefined"
17895
+ },
17896
+ "default": "undefined",
17897
+ "description": "The value attribute is used to represent a value when the menu item is selected.\nIt is typically used with checkbox and radio menu items, but can be handy for any menu item.",
17898
+ "fieldName": "value",
17899
+ "inheritedFrom": {
17900
+ "name": "MenuItem",
17901
+ "module": "src/components/menuitem/menuitem.component.ts"
17902
+ }
17903
+ },
17651
17904
  {
17652
17905
  "name": "disabled",
17653
17906
  "type": {
@@ -17713,144 +17966,86 @@
17713
17966
  },
17714
17967
  {
17715
17968
  "name": "tertiary-label",
17716
- "type": {
17717
- "text": "string | undefined"
17718
- },
17719
- "description": "The tertiary label of the list item.\nThis appears on the leading side of the list item.",
17720
- "fieldName": "tertiaryLabel",
17721
- "inheritedFrom": {
17722
- "name": "ListItem",
17723
- "module": "src/components/listitem/listitem.component.ts"
17724
- }
17725
- },
17726
- {
17727
- "name": "side-header-text",
17728
- "type": {
17729
- "text": "string | undefined"
17730
- },
17731
- "description": "The header text of the list item.\nThis appears on the trailing side of the list item.",
17732
- "fieldName": "sideHeaderText",
17733
- "inheritedFrom": {
17734
- "name": "ListItem",
17735
- "module": "src/components/listitem/listitem.component.ts"
17736
- }
17737
- },
17738
- {
17739
- "name": "subline-text",
17740
- "type": {
17741
- "text": "string | undefined"
17742
- },
17743
- "description": "The subline text of the list item.\nThis appears on the trailing side of the list item.",
17744
- "fieldName": "sublineText",
17745
- "inheritedFrom": {
17746
- "name": "ListItem",
17747
- "module": "src/components/listitem/listitem.component.ts"
17748
- }
17749
- },
17750
- {
17751
- "name": "soft-disabled",
17752
- "type": {
17753
- "text": "boolean | undefined"
17754
- },
17755
- "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
17756
- "default": "undefined",
17757
- "fieldName": "softDisabled",
17758
- "inheritedFrom": {
17759
- "name": "ListItem",
17760
- "module": "src/components/listitem/listitem.component.ts"
17761
- }
17762
- },
17763
- {
17764
- "name": "tooltip-text",
17765
- "type": {
17766
- "text": "string | undefined"
17767
- },
17768
- "description": "The tooltip text is displayed on hover of the list item.",
17769
- "fieldName": "tooltipText",
17770
- "inheritedFrom": {
17771
- "name": "ListItem",
17772
- "module": "src/components/listitem/listitem.component.ts"
17773
- }
17774
- },
17775
- {
17776
- "name": "tooltip-placement",
17777
- "type": {
17778
- "text": "PopoverPlacement"
17779
- },
17780
- "description": "The tooltip placement of the list item. If the tooltip text is present,\nthen this tooltip placement will be applied.",
17781
- "default": "'top'",
17782
- "fieldName": "tooltipPlacement",
17783
- "inheritedFrom": {
17784
- "name": "ListItem",
17785
- "module": "src/components/listitem/listitem.component.ts"
17786
- }
17787
- }
17788
- ],
17789
- "superclass": {
17790
- "name": "MenuItem",
17791
- "module": "/src/components/menuitem/menuitem.component"
17792
- },
17793
- "tagName": "mdc-menuitemradio",
17794
- "jsDoc": "/**\n * A menuitemradio component is a checkable menuitem that is used in a menu.\n * A menuitemradio should be checked only one at a time. <br/>\n * There should be no focusable descendants inside this menuitemradio component.\n *\n * The `aria-checked` menuitemradio attribute is used to indicate that the menuitemradio is checked or not.\n *\n * If you want more than one item in a group to be checked, consider using menuitemcheckbox component.\n *\n * If a menuitemradio is disabled, then the `aria-disabled` attribute is set to `true`.\n *\n * @dependency mdc-staticradio\n * @dependency mdc-text\n *\n * @tagname mdc-menuitemradio\n *\n * @event change - (React: onChange) This event is dispatched when the menuitemradio changes.\n * @event click - (React: onClick) This event is dispatched when the menuitemradio is clicked.\n * @event focus - (React: onFocus) This event is dispatched when the menuitemradio receives focus.\n */",
17795
- "customElement": true,
17796
- "slots": [
17797
- {
17798
- "description": "slot for list item controls to appear of leading end.",
17799
- "name": "leading-controls",
17800
- "inheritedFrom": {
17801
- "name": "ListItem",
17802
- "module": "src/components/listitem/listitem.component.ts"
17803
- }
17804
- },
17805
- {
17806
- "description": "slot for list item primary label.",
17807
- "name": "leading-text-primary-label",
17969
+ "type": {
17970
+ "text": "string | undefined"
17971
+ },
17972
+ "description": "The tertiary label of the list item.\nThis appears on the leading side of the list item.",
17973
+ "fieldName": "tertiaryLabel",
17808
17974
  "inheritedFrom": {
17809
17975
  "name": "ListItem",
17810
17976
  "module": "src/components/listitem/listitem.component.ts"
17811
17977
  }
17812
17978
  },
17813
17979
  {
17814
- "description": "slot for list item secondary label.",
17815
- "name": "leading-text-secondary-label",
17980
+ "name": "side-header-text",
17981
+ "type": {
17982
+ "text": "string | undefined"
17983
+ },
17984
+ "description": "The header text of the list item.\nThis appears on the trailing side of the list item.",
17985
+ "fieldName": "sideHeaderText",
17816
17986
  "inheritedFrom": {
17817
17987
  "name": "ListItem",
17818
17988
  "module": "src/components/listitem/listitem.component.ts"
17819
17989
  }
17820
17990
  },
17821
17991
  {
17822
- "description": "slot for list item tertiary label.",
17823
- "name": "leading-text-tertiary-label",
17992
+ "name": "subline-text",
17993
+ "type": {
17994
+ "text": "string | undefined"
17995
+ },
17996
+ "description": "The subline text of the list item.\nThis appears on the trailing side of the list item.",
17997
+ "fieldName": "sublineText",
17824
17998
  "inheritedFrom": {
17825
17999
  "name": "ListItem",
17826
18000
  "module": "src/components/listitem/listitem.component.ts"
17827
18001
  }
17828
18002
  },
17829
18003
  {
17830
- "description": "slot for list item side header text.",
17831
- "name": "trailing-text-side-header",
18004
+ "name": "soft-disabled",
18005
+ "type": {
18006
+ "text": "boolean | undefined"
18007
+ },
18008
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
18009
+ "default": "undefined",
18010
+ "fieldName": "softDisabled",
17832
18011
  "inheritedFrom": {
17833
18012
  "name": "ListItem",
17834
18013
  "module": "src/components/listitem/listitem.component.ts"
17835
18014
  }
17836
18015
  },
17837
18016
  {
17838
- "description": "slot for list item subline text.",
17839
- "name": "trailing-text-subline",
18017
+ "name": "tooltip-text",
18018
+ "type": {
18019
+ "text": "string | undefined"
18020
+ },
18021
+ "description": "The tooltip text is displayed on hover of the list item.",
18022
+ "fieldName": "tooltipText",
17840
18023
  "inheritedFrom": {
17841
18024
  "name": "ListItem",
17842
18025
  "module": "src/components/listitem/listitem.component.ts"
17843
18026
  }
17844
18027
  },
17845
18028
  {
17846
- "description": "slot for list item controls to appear of trailing end.",
17847
- "name": "trailing-controls",
18029
+ "name": "tooltip-placement",
18030
+ "type": {
18031
+ "text": "PopoverPlacement"
18032
+ },
18033
+ "description": "The tooltip placement of the list item. If the tooltip text is present,\nthen this tooltip placement will be applied.",
18034
+ "default": "'top'",
18035
+ "fieldName": "tooltipPlacement",
17848
18036
  "inheritedFrom": {
17849
18037
  "name": "ListItem",
17850
18038
  "module": "src/components/listitem/listitem.component.ts"
17851
18039
  }
17852
18040
  }
17853
18041
  ],
18042
+ "superclass": {
18043
+ "name": "MenuItem",
18044
+ "module": "/src/components/menuitem/menuitem.component"
18045
+ },
18046
+ "tagName": "mdc-menuitemradio",
18047
+ "jsDoc": "/**\n * A menuitemradio component is a checkable menuitem that is used in a menu.\n * A menuitemradio should be checked only one at a time. <br/>\n * There should be no focusable descendants inside this menuitemradio component.\n *\n * The `checked` menuitemradio attribute is used to indicate that the menuitemradio is checked or not.\n *\n * Menu item radio has `name` and `value` attribute that can be used to identify the menu item when it is selected.\n *\n * If you want more than one item in a group to be checked, consider using menuitemcheckbox component.\n *\n * The `indicator` attribute is used to differentiate between <b>radio</b>, <b>checkmark</b> and <b>none</b>.\n * By default, the `indicator` is set to <b>radio</b>.<br/>\n *\n * The checkbox will always be positioned on the leading side of the menuitem label and\n * the checkmark will always be positioned on the trailing side.\n *\n * The radio will have the possible states of `true` or `false`.\n * If the indicator is set to <b>checkmark</b> and if the `checked` attribute is set to `true`,\n * then the checkmark will be displayed. if not, then no indicator will be displayed.\n *\n * The third options for the `indicator` is <b>none</b>, which will not display any indicator at all.\n * It is intended to be used for customised menu items where the indicator is implemented differently.\n * For example, you can use a custom icon or a different visual element to indicate the state of the menu item.\n * Make sure the new indicator is accessible.\n *\n * @dependency mdc-staticradio\n * @dependency mdc-text\n *\n * @tagname mdc-menuitemradio\n *\n * @slot leading-controls - slot for menu item radio controls to appear of leading end.\n * @slot leading-text-primary-label - slot for menu item radio primary label.\n * @slot leading-text-secondary-label - slot for menu item radio secondary label.\n * @slot leading-text-tertiary-label - slot for menu item radio tertiary label.\n * @slot trailing-text-side-header - slot for menu item radio side header text.\n * @slot trailing-text-subline - slot for menu item radio subline text.\n * @slot trailing-controls - slot for menu item radio controls to appear of trailing end.\n *\n * @event change - (React: onChange) This event is dispatched when the menuitemradio changes.\n * @event click - (React: onClick) This event is dispatched when the menuitemradio is clicked.\n * @event focus - (React: onFocus) This event is dispatched when the menuitemradio receives focus.\n */",
18048
+ "customElement": true,
17854
18049
  "cssProperties": [
17855
18050
  {
17856
18051
  "description": "Allows customization of the default background color.",
@@ -17940,16 +18135,16 @@
17940
18135
  "name": "MenuPopover",
17941
18136
  "slots": [
17942
18137
  {
17943
- "description": "Contains the menu items to be displayed in the popover",
17944
- "name": "default"
17945
- },
17946
- {
17947
- "description": "Default slot for the popover content",
18138
+ "description": "Default slot for the menu popover content",
17948
18139
  "name": "",
17949
18140
  "inheritedFrom": {
17950
18141
  "name": "Popover",
17951
18142
  "module": "src/components/popover/popover.component.ts"
17952
18143
  }
18144
+ },
18145
+ {
18146
+ "description": "Contains the menu items to be displayed in the popover",
18147
+ "name": "default"
17953
18148
  }
17954
18149
  ],
17955
18150
  "members": [
@@ -18019,6 +18214,11 @@
18019
18214
  "kind": "method",
18020
18215
  "name": "closeAllMenuPopovers",
18021
18216
  "privacy": "private",
18217
+ "return": {
18218
+ "type": {
18219
+ "text": "void"
18220
+ }
18221
+ },
18022
18222
  "parameters": [
18023
18223
  {
18024
18224
  "name": "until",
@@ -19274,6 +19474,54 @@
19274
19474
  }
19275
19475
  }
19276
19476
  ],
19477
+ "events": [
19478
+ {
19479
+ "description": "(React: onChange) This event is dispatched when a `menuitemcheckbox`, or `menuitemradio` changes.",
19480
+ "name": "change",
19481
+ "reactName": "onChange"
19482
+ },
19483
+ {
19484
+ "description": "(React: onAction) This event is dispatched when a menuItem selected and the menu closes.",
19485
+ "name": "action",
19486
+ "reactName": "onAction"
19487
+ },
19488
+ {
19489
+ "description": "(React: onShown) This event is dispatched when the popover is shown",
19490
+ "name": "shown",
19491
+ "reactName": "onShown",
19492
+ "inheritedFrom": {
19493
+ "name": "Popover",
19494
+ "module": "src/components/popover/popover.component.ts"
19495
+ }
19496
+ },
19497
+ {
19498
+ "description": "(React: onHidden) This event is dispatched when the popover is hidden",
19499
+ "name": "hidden",
19500
+ "reactName": "onHidden",
19501
+ "inheritedFrom": {
19502
+ "name": "Popover",
19503
+ "module": "src/components/popover/popover.component.ts"
19504
+ }
19505
+ },
19506
+ {
19507
+ "description": "(React: onCreated) This event is dispatched when the popover is created (added to the DOM)",
19508
+ "name": "created",
19509
+ "reactName": "onCreated",
19510
+ "inheritedFrom": {
19511
+ "name": "Popover",
19512
+ "module": "src/components/popover/popover.component.ts"
19513
+ }
19514
+ },
19515
+ {
19516
+ "description": "(React: onDestroyed) This event is dispatched when the popover is destroyed (removed from the DOM)",
19517
+ "name": "destroyed",
19518
+ "reactName": "onDestroyed",
19519
+ "inheritedFrom": {
19520
+ "name": "Popover",
19521
+ "module": "src/components/popover/popover.component.ts"
19522
+ }
19523
+ }
19524
+ ],
19277
19525
  "attributes": [
19278
19526
  {
19279
19527
  "name": "placement",
@@ -19671,7 +19919,7 @@
19671
19919
  "module": "/src/components/popover/popover.component"
19672
19920
  },
19673
19921
  "tagName": "mdc-menupopover",
19674
- "jsDoc": "/**\n * A popover menu component that displays a list of menu items in a floating container.\n * It's designed to work in conjunction with `mdc-menubar` and `mdc-menuitem` to create\n * accessible, nested menu structures with the following features:\n * - Appears adjacent to the triggering menu item\n * - Supports keyboard navigation (arrow keys, Home, End)\n * - Manages focus trapping when open\n * - Closes on Escape key or outside click\n * - Supports both mouse and keyboard interactions\n * - Automatically handles ARIA attributes for accessibility\n *\n * The component extends `mdc-popover` and adds menu-specific behaviors and styling.\n * When nested within another `mdc-menupopover`, it automatically adjusts its behavior\n * to work as a submenu (right-aligned, shows on hover).\n *\n * The orientation of the menu popover is always set to `vertical`.\n *\n * @tagname mdc-menupopover\n * @slot default - Contains the menu items to be displayed in the popover\n */",
19922
+ "jsDoc": "/**\n * A popover menu component that displays a list of menu items in a floating container.\n * It's designed to work in conjunction with `mdc-menubar` and `mdc-menuitem` to create\n * accessible, nested menu structures with the following features:\n * - Appears adjacent to the triggering menu item\n * - Supports keyboard navigation (arrow keys, Home, End)\n * - Manages focus trapping when open\n * - Closes on Escape key or outside click\n * - Supports both mouse and keyboard interactions\n * - Automatically handles ARIA attributes for accessibility\n *\n * The component extends `mdc-popover` and adds menu-specific behaviors and styling.\n * When nested within another `mdc-menupopover`, it automatically adjusts its behavior\n * to work as a submenu (right-aligned, shows on hover).\n *\n * The orientation of the menu popover is always set to `vertical`.\n *\n * @tagname mdc-menupopover\n *\n * @slot - Default slot for the menu popover content\n *\n * @event change - (React: onChange) This event is dispatched when a `menuitemcheckbox`, or `menuitemradio` changes.\n * @event action - (React: onAction) This event is dispatched when a menuItem selected and the menu closes.\n *\n * @slot default - Contains the menu items to be displayed in the popover\n */",
19675
19923
  "customElement": true,
19676
19924
  "cssProperties": [
19677
19925
  {
@@ -19754,44 +20002,6 @@
19754
20002
  "module": "src/components/popover/popover.component.ts"
19755
20003
  }
19756
20004
  }
19757
- ],
19758
- "events": [
19759
- {
19760
- "description": "(React: onShown) This event is dispatched when the popover is shown",
19761
- "name": "shown",
19762
- "reactName": "onShown",
19763
- "inheritedFrom": {
19764
- "name": "Popover",
19765
- "module": "src/components/popover/popover.component.ts"
19766
- }
19767
- },
19768
- {
19769
- "description": "(React: onHidden) This event is dispatched when the popover is hidden",
19770
- "name": "hidden",
19771
- "reactName": "onHidden",
19772
- "inheritedFrom": {
19773
- "name": "Popover",
19774
- "module": "src/components/popover/popover.component.ts"
19775
- }
19776
- },
19777
- {
19778
- "description": "(React: onCreated) This event is dispatched when the popover is created (added to the DOM)",
19779
- "name": "created",
19780
- "reactName": "onCreated",
19781
- "inheritedFrom": {
19782
- "name": "Popover",
19783
- "module": "src/components/popover/popover.component.ts"
19784
- }
19785
- },
19786
- {
19787
- "description": "(React: onDestroyed) This event is dispatched when the popover is destroyed (removed from the DOM)",
19788
- "name": "destroyed",
19789
- "reactName": "onDestroyed",
19790
- "inheritedFrom": {
19791
- "name": "Popover",
19792
- "module": "src/components/popover/popover.component.ts"
19793
- }
19794
- }
19795
20005
  ]
19796
20006
  }
19797
20007
  ],
@@ -19820,13 +20030,68 @@
19820
20030
  "name": ""
19821
20031
  }
19822
20032
  ],
19823
- "members": [],
20033
+ "members": [
20034
+ {
20035
+ "kind": "field",
20036
+ "name": "ariaLabel",
20037
+ "type": {
20038
+ "text": "string | null"
20039
+ },
20040
+ "default": "null",
20041
+ "description": "The primary headerText of the list item.\nThis appears on the leading side of the list item.",
20042
+ "attribute": "aria-label",
20043
+ "reflects": true
20044
+ },
20045
+ {
20046
+ "kind": "field",
20047
+ "name": "headerText",
20048
+ "type": {
20049
+ "text": "string | null"
20050
+ },
20051
+ "default": "null",
20052
+ "description": "The primary headerText of the list item.\nThis appears on the leading side of the list item.",
20053
+ "attribute": "headerText",
20054
+ "reflects": true
20055
+ },
20056
+ {
20057
+ "kind": "method",
20058
+ "name": "renderLabel",
20059
+ "privacy": "private"
20060
+ }
20061
+ ],
20062
+ "events": [
20063
+ {
20064
+ "description": "(React: onChange) This event is dispatched when a `menuitemcheckbox`, or `menuitemradio` changes.",
20065
+ "name": "change",
20066
+ "reactName": "onChange"
20067
+ }
20068
+ ],
20069
+ "attributes": [
20070
+ {
20071
+ "name": "aria-label",
20072
+ "type": {
20073
+ "text": "string | null"
20074
+ },
20075
+ "default": "null",
20076
+ "description": "The primary headerText of the list item.\nThis appears on the leading side of the list item.",
20077
+ "fieldName": "ariaLabel"
20078
+ },
20079
+ {
20080
+ "name": "headerText",
20081
+ "type": {
20082
+ "text": "string | null"
20083
+ },
20084
+ "default": "null",
20085
+ "description": "The primary headerText of the list item.\nThis appears on the leading side of the list item.",
20086
+ "fieldName": "headerText"
20087
+ }
20088
+ ],
19824
20089
  "superclass": {
19825
20090
  "name": "Component",
19826
20091
  "module": "/src/models"
19827
20092
  },
19828
20093
  "tagName": "mdc-menusection",
19829
- "jsDoc": "/**\n * `mdc-menusection` is a container element used to group a set of menu items.\n *\n * This component supports a mix of `menuitem`, `menuitemcheckbox`, and `menuitemradio` components.\n *\n * - If multiple `menuitemradio` components are slotted into the section, the group enforces a single-selection rule:\n * only one radio item can be selected at a time.\n * - If `menuitemcheckbox` components are included, their checked state can be toggled independently.\n *\n * @tagname mdc-menusection\n *\n * @slot - Default slot for inserting `menuitem`, `menuitemcheckbox`, or `menuitemradio`\n */",
20094
+ "jsDoc": "/**\n * `mdc-menusection` is a container element used to group a set of menu items.\n *\n * This component supports a mix of `menuitem`, `menuitemcheckbox`, and `menuitemradio` components.\n *\n * - If multiple `menuitemradio` components are slotted into the section, the group enforces a single-selection rule:\n * only one radio item can be selected at a time.\n * - If `menuitemcheckbox` components are included, their checked state can be toggled independently.\n *\n * @tagname mdc-menusection\n *\n * @slot - Default slot for inserting `menuitem`, `menuitemcheckbox`, or `menuitemradio`\n *\n * @event change - (React: onChange) This event is dispatched when a `menuitemcheckbox`, or `menuitemradio` changes.\n */",
19830
20095
  "customElement": true
19831
20096
  }
19832
20097
  ],
@@ -20134,6 +20399,36 @@
20134
20399
  "module": "components/menuitem/menuitem.component.js"
20135
20400
  }
20136
20401
  },
20402
+ {
20403
+ "kind": "field",
20404
+ "name": "name",
20405
+ "type": {
20406
+ "text": "undefined | string | undefined"
20407
+ },
20408
+ "default": "undefined",
20409
+ "description": "The name attribute is used to identify the menu item when it is selected.",
20410
+ "attribute": "name",
20411
+ "reflects": true,
20412
+ "inheritedFrom": {
20413
+ "name": "MenuItem",
20414
+ "module": "components/menuitem/menuitem.component.js"
20415
+ }
20416
+ },
20417
+ {
20418
+ "kind": "field",
20419
+ "name": "value",
20420
+ "type": {
20421
+ "text": "undefined | string | undefined"
20422
+ },
20423
+ "default": "undefined",
20424
+ "description": "The value attribute is used to represent a value when the menu item is selected.\nIt is typically used with checkbox and radio menu items, but can be handy for any menu item.",
20425
+ "attribute": "value",
20426
+ "reflects": true,
20427
+ "inheritedFrom": {
20428
+ "name": "MenuItem",
20429
+ "module": "components/menuitem/menuitem.component.js"
20430
+ }
20431
+ },
20137
20432
  {
20138
20433
  "kind": "method",
20139
20434
  "name": "handleKeyDown",
@@ -20655,6 +20950,32 @@
20655
20950
  "module": "src/components/menuitem/menuitem.component.ts"
20656
20951
  }
20657
20952
  },
20953
+ {
20954
+ "name": "name",
20955
+ "type": {
20956
+ "text": "undefined | string | undefined"
20957
+ },
20958
+ "default": "undefined",
20959
+ "description": "The name attribute is used to identify the menu item when it is selected.",
20960
+ "fieldName": "name",
20961
+ "inheritedFrom": {
20962
+ "name": "MenuItem",
20963
+ "module": "src/components/menuitem/menuitem.component.ts"
20964
+ }
20965
+ },
20966
+ {
20967
+ "name": "value",
20968
+ "type": {
20969
+ "text": "undefined | string | undefined"
20970
+ },
20971
+ "default": "undefined",
20972
+ "description": "The value attribute is used to represent a value when the menu item is selected.\nIt is typically used with checkbox and radio menu items, but can be handy for any menu item.",
20973
+ "fieldName": "value",
20974
+ "inheritedFrom": {
20975
+ "name": "MenuItem",
20976
+ "module": "src/components/menuitem/menuitem.component.ts"
20977
+ }
20978
+ },
20658
20979
  {
20659
20980
  "name": "disabled",
20660
20981
  "type": {
@@ -20808,7 +21129,7 @@
20808
21129
  "customElement": true,
20809
21130
  "slots": [
20810
21131
  {
20811
- "description": "slot for list item controls to appear of leading end.",
21132
+ "description": "slot for menu item controls to appear of leading end.",
20812
21133
  "name": "leading-controls",
20813
21134
  "inheritedFrom": {
20814
21135
  "name": "ListItem",
@@ -20816,7 +21137,7 @@
20816
21137
  }
20817
21138
  },
20818
21139
  {
20819
- "description": "slot for list item primary label.",
21140
+ "description": "slot for menu item primary label.",
20820
21141
  "name": "leading-text-primary-label",
20821
21142
  "inheritedFrom": {
20822
21143
  "name": "ListItem",
@@ -20824,7 +21145,7 @@
20824
21145
  }
20825
21146
  },
20826
21147
  {
20827
- "description": "slot for list item secondary label.",
21148
+ "description": "slot for menu item secondary label.",
20828
21149
  "name": "leading-text-secondary-label",
20829
21150
  "inheritedFrom": {
20830
21151
  "name": "ListItem",
@@ -20832,7 +21153,7 @@
20832
21153
  }
20833
21154
  },
20834
21155
  {
20835
- "description": "slot for list item tertiary label.",
21156
+ "description": "slot for menu item tertiary label.",
20836
21157
  "name": "leading-text-tertiary-label",
20837
21158
  "inheritedFrom": {
20838
21159
  "name": "ListItem",
@@ -20840,7 +21161,7 @@
20840
21161
  }
20841
21162
  },
20842
21163
  {
20843
- "description": "slot for list item side header text.",
21164
+ "description": "slot for menu item side header text.",
20844
21165
  "name": "trailing-text-side-header",
20845
21166
  "inheritedFrom": {
20846
21167
  "name": "ListItem",
@@ -20848,7 +21169,7 @@
20848
21169
  }
20849
21170
  },
20850
21171
  {
20851
- "description": "slot for list item subline text.",
21172
+ "description": "slot for menu item subline text.",
20852
21173
  "name": "trailing-text-subline",
20853
21174
  "inheritedFrom": {
20854
21175
  "name": "ListItem",
@@ -20856,7 +21177,7 @@
20856
21177
  }
20857
21178
  },
20858
21179
  {
20859
- "description": "slot for list item controls to appear of trailing end.",
21180
+ "description": "slot for menu item controls to appear of trailing end.",
20860
21181
  "name": "trailing-controls",
20861
21182
  "inheritedFrom": {
20862
21183
  "name": "ListItem",
@@ -20922,6 +21243,8 @@
20922
21243
  "type": {
20923
21244
  "text": "Array<HTMLElement>"
20924
21245
  },
21246
+ "description": "Returns all menuitem elements, including those nested inside menusection.",
21247
+ "readonly": true,
20925
21248
  "inheritedFrom": {
20926
21249
  "name": "MenuBar",
20927
21250
  "module": "components/menubar/menubar.component.js"
@@ -21112,6 +21435,7 @@
21112
21435
  }
21113
21436
  }
21114
21437
  ],
21438
+ "description": "Determines if a menuitem is a top-level menuitem (direct child of menubar or child of menusection whose parent is menubar)",
21115
21439
  "inheritedFrom": {
21116
21440
  "name": "MenuBar",
21117
21441
  "module": "components/menubar/menubar.component.js"