@momentum-design/components 0.83.5 → 0.83.6

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.
@@ -2203,138 +2203,6 @@
2203
2203
  }
2204
2204
  ]
2205
2205
  },
2206
- {
2207
- "kind": "javascript-module",
2208
- "path": "components/buttongroup/buttongroup.component.js",
2209
- "declarations": [
2210
- {
2211
- "kind": "class",
2212
- "description": "buttongroup component, is a styled wrapper for multiple buttons.\nIt can support icon buttons, combination of icon and pill buttons, and text buttons.\nThey are available in horizontal and vertical orientation.",
2213
- "name": "ButtonGroup",
2214
- "cssProperties": [
2215
- {
2216
- "description": "The border radius of the buttongroup",
2217
- "name": "--mdc-buttongroup-border-radius"
2218
- },
2219
- {
2220
- "description": "The border color of the buttongroup",
2221
- "name": "--mdc-buttongroup-border-color"
2222
- },
2223
- {
2224
- "description": "The color of the divider between buttons within the buttongroup",
2225
- "name": "--mdc-buttongroup-divider-color"
2226
- }
2227
- ],
2228
- "slots": [
2229
- {
2230
- "description": "This is a default/unnamed slot, which contains the buttons",
2231
- "name": "default"
2232
- }
2233
- ],
2234
- "members": [
2235
- {
2236
- "kind": "field",
2237
- "name": "orientation",
2238
- "type": {
2239
- "text": "ButtonGroupOrientation"
2240
- },
2241
- "description": "Orientation of the buttongroup.",
2242
- "default": "'horizontal'",
2243
- "attribute": "orientation",
2244
- "reflects": true
2245
- },
2246
- {
2247
- "kind": "field",
2248
- "name": "variant",
2249
- "type": {
2250
- "text": "ButtonGroupVariant"
2251
- },
2252
- "description": "Variant of the buttons within the buttongroup.",
2253
- "default": "'primary'",
2254
- "attribute": "variant",
2255
- "reflects": true
2256
- },
2257
- {
2258
- "kind": "field",
2259
- "name": "size",
2260
- "type": {
2261
- "text": "ButtonGroupSize"
2262
- },
2263
- "description": "Size of the buttons within the buttongroup.",
2264
- "default": "'28'",
2265
- "attribute": "size",
2266
- "reflects": true
2267
- },
2268
- {
2269
- "kind": "field",
2270
- "name": "compact",
2271
- "type": {
2272
- "text": "boolean"
2273
- },
2274
- "default": "false",
2275
- "description": "When this is true, the buttons within the buttongroup will be compact.\ni.e. Irrespective of the size of the buttons, they will have a height of 24px.",
2276
- "attribute": "compact",
2277
- "reflects": true
2278
- }
2279
- ],
2280
- "attributes": [
2281
- {
2282
- "name": "orientation",
2283
- "type": {
2284
- "text": "ButtonGroupOrientation"
2285
- },
2286
- "description": "Orientation of the buttongroup.",
2287
- "default": "'horizontal'",
2288
- "fieldName": "orientation"
2289
- },
2290
- {
2291
- "name": "variant",
2292
- "type": {
2293
- "text": "ButtonGroupVariant"
2294
- },
2295
- "description": "Variant of the buttons within the buttongroup.",
2296
- "default": "'primary'",
2297
- "fieldName": "variant"
2298
- },
2299
- {
2300
- "name": "size",
2301
- "type": {
2302
- "text": "ButtonGroupSize"
2303
- },
2304
- "description": "Size of the buttons within the buttongroup.",
2305
- "default": "'28'",
2306
- "fieldName": "size"
2307
- },
2308
- {
2309
- "name": "compact",
2310
- "type": {
2311
- "text": "boolean"
2312
- },
2313
- "default": "false",
2314
- "description": "When this is true, the buttons within the buttongroup will be compact.\ni.e. Irrespective of the size of the buttons, they will have a height of 24px.",
2315
- "fieldName": "compact"
2316
- }
2317
- ],
2318
- "superclass": {
2319
- "name": "Component",
2320
- "module": "/src/models"
2321
- },
2322
- "tagName": "mdc-buttongroup",
2323
- "jsDoc": "/**\n * buttongroup component, is a styled wrapper for multiple buttons.\n * It can support icon buttons, combination of icon and pill buttons, and text buttons.\n * They are available in horizontal and vertical orientation.\n *\n * @tagname mdc-buttongroup\n *\n * @slot default - This is a default/unnamed slot, which contains the buttons\n *\n * @cssproperty --mdc-buttongroup-border-radius - The border radius of the buttongroup\n * @cssproperty --mdc-buttongroup-border-color - The border color of the buttongroup\n * @cssproperty --mdc-buttongroup-divider-color - The color of the divider between buttons within the buttongroup\n */",
2324
- "customElement": true
2325
- }
2326
- ],
2327
- "exports": [
2328
- {
2329
- "kind": "js",
2330
- "name": "default",
2331
- "declaration": {
2332
- "name": "ButtonGroup",
2333
- "module": "components/buttongroup/buttongroup.component.js"
2334
- }
2335
- }
2336
- ]
2337
- },
2338
2206
  {
2339
2207
  "kind": "javascript-module",
2340
2208
  "path": "components/button/button.component.js",
@@ -3030,6 +2898,138 @@
3030
2898
  }
3031
2899
  ]
3032
2900
  },
2901
+ {
2902
+ "kind": "javascript-module",
2903
+ "path": "components/buttongroup/buttongroup.component.js",
2904
+ "declarations": [
2905
+ {
2906
+ "kind": "class",
2907
+ "description": "buttongroup component, is a styled wrapper for multiple buttons.\nIt can support icon buttons, combination of icon and pill buttons, and text buttons.\nThey are available in horizontal and vertical orientation.",
2908
+ "name": "ButtonGroup",
2909
+ "cssProperties": [
2910
+ {
2911
+ "description": "The border radius of the buttongroup",
2912
+ "name": "--mdc-buttongroup-border-radius"
2913
+ },
2914
+ {
2915
+ "description": "The border color of the buttongroup",
2916
+ "name": "--mdc-buttongroup-border-color"
2917
+ },
2918
+ {
2919
+ "description": "The color of the divider between buttons within the buttongroup",
2920
+ "name": "--mdc-buttongroup-divider-color"
2921
+ }
2922
+ ],
2923
+ "slots": [
2924
+ {
2925
+ "description": "This is a default/unnamed slot, which contains the buttons",
2926
+ "name": "default"
2927
+ }
2928
+ ],
2929
+ "members": [
2930
+ {
2931
+ "kind": "field",
2932
+ "name": "orientation",
2933
+ "type": {
2934
+ "text": "ButtonGroupOrientation"
2935
+ },
2936
+ "description": "Orientation of the buttongroup.",
2937
+ "default": "'horizontal'",
2938
+ "attribute": "orientation",
2939
+ "reflects": true
2940
+ },
2941
+ {
2942
+ "kind": "field",
2943
+ "name": "variant",
2944
+ "type": {
2945
+ "text": "ButtonGroupVariant"
2946
+ },
2947
+ "description": "Variant of the buttons within the buttongroup.",
2948
+ "default": "'primary'",
2949
+ "attribute": "variant",
2950
+ "reflects": true
2951
+ },
2952
+ {
2953
+ "kind": "field",
2954
+ "name": "size",
2955
+ "type": {
2956
+ "text": "ButtonGroupSize"
2957
+ },
2958
+ "description": "Size of the buttons within the buttongroup.",
2959
+ "default": "'28'",
2960
+ "attribute": "size",
2961
+ "reflects": true
2962
+ },
2963
+ {
2964
+ "kind": "field",
2965
+ "name": "compact",
2966
+ "type": {
2967
+ "text": "boolean"
2968
+ },
2969
+ "default": "false",
2970
+ "description": "When this is true, the buttons within the buttongroup will be compact.\ni.e. Irrespective of the size of the buttons, they will have a height of 24px.",
2971
+ "attribute": "compact",
2972
+ "reflects": true
2973
+ }
2974
+ ],
2975
+ "attributes": [
2976
+ {
2977
+ "name": "orientation",
2978
+ "type": {
2979
+ "text": "ButtonGroupOrientation"
2980
+ },
2981
+ "description": "Orientation of the buttongroup.",
2982
+ "default": "'horizontal'",
2983
+ "fieldName": "orientation"
2984
+ },
2985
+ {
2986
+ "name": "variant",
2987
+ "type": {
2988
+ "text": "ButtonGroupVariant"
2989
+ },
2990
+ "description": "Variant of the buttons within the buttongroup.",
2991
+ "default": "'primary'",
2992
+ "fieldName": "variant"
2993
+ },
2994
+ {
2995
+ "name": "size",
2996
+ "type": {
2997
+ "text": "ButtonGroupSize"
2998
+ },
2999
+ "description": "Size of the buttons within the buttongroup.",
3000
+ "default": "'28'",
3001
+ "fieldName": "size"
3002
+ },
3003
+ {
3004
+ "name": "compact",
3005
+ "type": {
3006
+ "text": "boolean"
3007
+ },
3008
+ "default": "false",
3009
+ "description": "When this is true, the buttons within the buttongroup will be compact.\ni.e. Irrespective of the size of the buttons, they will have a height of 24px.",
3010
+ "fieldName": "compact"
3011
+ }
3012
+ ],
3013
+ "superclass": {
3014
+ "name": "Component",
3015
+ "module": "/src/models"
3016
+ },
3017
+ "tagName": "mdc-buttongroup",
3018
+ "jsDoc": "/**\n * buttongroup component, is a styled wrapper for multiple buttons.\n * It can support icon buttons, combination of icon and pill buttons, and text buttons.\n * They are available in horizontal and vertical orientation.\n *\n * @tagname mdc-buttongroup\n *\n * @slot default - This is a default/unnamed slot, which contains the buttons\n *\n * @cssproperty --mdc-buttongroup-border-radius - The border radius of the buttongroup\n * @cssproperty --mdc-buttongroup-border-color - The border color of the buttongroup\n * @cssproperty --mdc-buttongroup-divider-color - The color of the divider between buttons within the buttongroup\n */",
3019
+ "customElement": true
3020
+ }
3021
+ ],
3022
+ "exports": [
3023
+ {
3024
+ "kind": "js",
3025
+ "name": "default",
3026
+ "declaration": {
3027
+ "name": "ButtonGroup",
3028
+ "module": "components/buttongroup/buttongroup.component.js"
3029
+ }
3030
+ }
3031
+ ]
3032
+ },
3033
3033
  {
3034
3034
  "kind": "javascript-module",
3035
3035
  "path": "components/buttonlink/buttonlink.component.js",
@@ -8773,7 +8773,7 @@
8773
8773
  {
8774
8774
  "kind": "field",
8775
8775
  "name": "onOutsidePopoverClick",
8776
- "privacy": "private",
8776
+ "privacy": "protected",
8777
8777
  "description": "Handles the outside click event to close the popover.",
8778
8778
  "parameters": [
8779
8779
  {
@@ -14627,7 +14627,7 @@
14627
14627
  {
14628
14628
  "kind": "method",
14629
14629
  "name": "handleKeyDown",
14630
- "privacy": "private",
14630
+ "privacy": "protected",
14631
14631
  "return": {
14632
14632
  "type": {
14633
14633
  "text": "void"
@@ -14642,12 +14642,12 @@
14642
14642
  "description": "The keyboard event triggered when a key is pressed down."
14643
14643
  }
14644
14644
  ],
14645
- "description": "Fires the click event when the enter or space key is pressed."
14645
+ "description": "Fires the click event when the enter or space key is pressed down.\nThis behavior is similar to a button click and key interaction."
14646
14646
  },
14647
14647
  {
14648
14648
  "kind": "method",
14649
14649
  "name": "triggerClickEvent",
14650
- "privacy": "private",
14650
+ "privacy": "protected",
14651
14651
  "description": "Triggers a click event on the list item."
14652
14652
  },
14653
14653
  {
@@ -15731,6 +15731,50 @@
15731
15731
  "attribute": "arrow-direction",
15732
15732
  "reflects": true
15733
15733
  },
15734
+ {
15735
+ "kind": "method",
15736
+ "name": "handleKeyDown",
15737
+ "privacy": "protected",
15738
+ "return": {
15739
+ "type": {
15740
+ "text": "void"
15741
+ }
15742
+ },
15743
+ "parameters": [
15744
+ {
15745
+ "name": "event",
15746
+ "type": {
15747
+ "text": "KeyboardEvent"
15748
+ },
15749
+ "description": "The keyboard event that triggered the action."
15750
+ }
15751
+ ],
15752
+ "description": "Handles the keydown event for the menu item.\nIf the Enter key is pressed, it triggers a click event on the menu item.\nThis allows keyboard users to activate the menu item using the Enter key.",
15753
+ "inheritedFrom": {
15754
+ "name": "ListItem",
15755
+ "module": "components/listitem/listitem.component.js"
15756
+ }
15757
+ },
15758
+ {
15759
+ "kind": "method",
15760
+ "name": "handleKeyUp",
15761
+ "privacy": "private",
15762
+ "return": {
15763
+ "type": {
15764
+ "text": "void"
15765
+ }
15766
+ },
15767
+ "parameters": [
15768
+ {
15769
+ "name": "event",
15770
+ "type": {
15771
+ "text": "KeyboardEvent"
15772
+ },
15773
+ "description": "The keyboard event that triggered the action."
15774
+ }
15775
+ ],
15776
+ "description": "Handles the keyup event for the menu item.\nIf the Space key is released, it triggers a click event on the menu item.\nThis allows keyboard users to activate the menu item using the Space key.\nIt also prevents the default action of the Space key to avoid scrolling the page."
15777
+ },
15734
15778
  {
15735
15779
  "kind": "method",
15736
15780
  "name": "renderTrailingControls",
@@ -15905,34 +15949,10 @@
15905
15949
  "module": "components/listitem/listitem.component.js"
15906
15950
  }
15907
15951
  },
15908
- {
15909
- "kind": "method",
15910
- "name": "handleKeyDown",
15911
- "privacy": "private",
15912
- "return": {
15913
- "type": {
15914
- "text": "void"
15915
- }
15916
- },
15917
- "parameters": [
15918
- {
15919
- "name": "event",
15920
- "type": {
15921
- "text": "KeyboardEvent"
15922
- },
15923
- "description": "The keyboard event triggered when a key is pressed down."
15924
- }
15925
- ],
15926
- "description": "Fires the click event when the enter or space key is pressed.",
15927
- "inheritedFrom": {
15928
- "name": "ListItem",
15929
- "module": "components/listitem/listitem.component.js"
15930
- }
15931
- },
15932
15952
  {
15933
15953
  "kind": "method",
15934
15954
  "name": "triggerClickEvent",
15935
- "privacy": "private",
15955
+ "privacy": "protected",
15936
15956
  "description": "Triggers a click event on the list item.",
15937
15957
  "inheritedFrom": {
15938
15958
  "name": "ListItem",
@@ -16497,15 +16517,22 @@
16497
16517
  "attribute": "indicator",
16498
16518
  "reflects": true
16499
16519
  },
16520
+ {
16521
+ "kind": "field",
16522
+ "name": "menuitemcheckboxHandleClick",
16523
+ "privacy": "private",
16524
+ "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`."
16525
+ },
16500
16526
  {
16501
16527
  "kind": "method",
16502
16528
  "name": "staticCheckbox",
16503
16529
  "privacy": "private",
16504
16530
  "return": {
16505
16531
  "type": {
16506
- "text": "TemplateResult | typeof nothing"
16532
+ "text": ""
16507
16533
  }
16508
- }
16534
+ },
16535
+ "description": "Returns a static checkbox element if the indicator is set to checkbox.\nIf the indicator is not set to checkbox, it returns nothing."
16509
16536
  },
16510
16537
  {
16511
16538
  "kind": "method",
@@ -16513,9 +16540,10 @@
16513
16540
  "privacy": "private",
16514
16541
  "return": {
16515
16542
  "type": {
16516
- "text": "TemplateResult | typeof nothing"
16543
+ "text": ""
16517
16544
  }
16518
- }
16545
+ },
16546
+ "description": "Returns a static toggle element if the indicator is set to toggle.\nIf the indicator is not set to toggle, it returns nothing.\n\nThe toggle will always be positioned on the trailing side of the menuitem label."
16519
16547
  },
16520
16548
  {
16521
16549
  "kind": "method",
@@ -16523,9 +16551,10 @@
16523
16551
  "privacy": "private",
16524
16552
  "return": {
16525
16553
  "type": {
16526
- "text": "TemplateResult | typeof nothing"
16554
+ "text": ""
16527
16555
  }
16528
- }
16556
+ },
16557
+ "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."
16529
16558
  },
16530
16559
  {
16531
16560
  "kind": "field",
@@ -16555,6 +16584,54 @@
16555
16584
  "module": "components/menuitem/menuitem.component.js"
16556
16585
  }
16557
16586
  },
16587
+ {
16588
+ "kind": "method",
16589
+ "name": "handleKeyDown",
16590
+ "privacy": "protected",
16591
+ "return": {
16592
+ "type": {
16593
+ "text": "void"
16594
+ }
16595
+ },
16596
+ "parameters": [
16597
+ {
16598
+ "name": "event",
16599
+ "type": {
16600
+ "text": "KeyboardEvent"
16601
+ },
16602
+ "description": "The keyboard event that triggered the action."
16603
+ }
16604
+ ],
16605
+ "description": "Handles the keydown event for the menu item.\nIf the Enter key is pressed, it triggers a click event on the menu item.\nThis allows keyboard users to activate the menu item using the Enter key.",
16606
+ "inheritedFrom": {
16607
+ "name": "ListItem",
16608
+ "module": "components/listitem/listitem.component.js"
16609
+ }
16610
+ },
16611
+ {
16612
+ "kind": "method",
16613
+ "name": "handleKeyUp",
16614
+ "privacy": "private",
16615
+ "return": {
16616
+ "type": {
16617
+ "text": "void"
16618
+ }
16619
+ },
16620
+ "parameters": [
16621
+ {
16622
+ "name": "event",
16623
+ "type": {
16624
+ "text": "KeyboardEvent"
16625
+ },
16626
+ "description": "The keyboard event that triggered the action."
16627
+ }
16628
+ ],
16629
+ "description": "Handles the keyup event for the menu item.\nIf the Space key is released, it triggers a click event on the menu item.\nThis allows keyboard users to activate the menu item using the Space key.\nIt also prevents the default action of the Space key to avoid scrolling the page.",
16630
+ "inheritedFrom": {
16631
+ "name": "MenuItem",
16632
+ "module": "components/menuitem/menuitem.component.js"
16633
+ }
16634
+ },
16558
16635
  {
16559
16636
  "kind": "method",
16560
16637
  "name": "renderTrailingControls",
@@ -16729,34 +16806,10 @@
16729
16806
  "module": "components/listitem/listitem.component.js"
16730
16807
  }
16731
16808
  },
16732
- {
16733
- "kind": "method",
16734
- "name": "handleKeyDown",
16735
- "privacy": "private",
16736
- "return": {
16737
- "type": {
16738
- "text": "void"
16739
- }
16740
- },
16741
- "parameters": [
16742
- {
16743
- "name": "event",
16744
- "type": {
16745
- "text": "KeyboardEvent"
16746
- },
16747
- "description": "The keyboard event triggered when a key is pressed down."
16748
- }
16749
- ],
16750
- "description": "Fires the click event when the enter or space key is pressed.",
16751
- "inheritedFrom": {
16752
- "name": "ListItem",
16753
- "module": "components/listitem/listitem.component.js"
16754
- }
16755
- },
16756
16809
  {
16757
16810
  "kind": "method",
16758
16811
  "name": "triggerClickEvent",
16759
- "privacy": "private",
16812
+ "privacy": "protected",
16760
16813
  "description": "Triggers a click event on the list item.",
16761
16814
  "inheritedFrom": {
16762
16815
  "name": "ListItem",
@@ -17205,6 +17258,23 @@
17205
17258
  "attribute": "aria-checked",
17206
17259
  "reflects": true
17207
17260
  },
17261
+ {
17262
+ "kind": "field",
17263
+ "name": "name",
17264
+ "type": {
17265
+ "text": "string"
17266
+ },
17267
+ "default": "''",
17268
+ "description": "The name attribute is used to group radio items within the same menu container.",
17269
+ "attribute": "name",
17270
+ "reflects": true
17271
+ },
17272
+ {
17273
+ "kind": "field",
17274
+ "name": "menuitemradioHandleClick",
17275
+ "privacy": "private",
17276
+ "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`."
17277
+ },
17208
17278
  {
17209
17279
  "kind": "field",
17210
17280
  "name": "arrowPosition",
@@ -17233,6 +17303,54 @@
17233
17303
  "module": "components/menuitem/menuitem.component.js"
17234
17304
  }
17235
17305
  },
17306
+ {
17307
+ "kind": "method",
17308
+ "name": "handleKeyDown",
17309
+ "privacy": "protected",
17310
+ "return": {
17311
+ "type": {
17312
+ "text": "void"
17313
+ }
17314
+ },
17315
+ "parameters": [
17316
+ {
17317
+ "name": "event",
17318
+ "type": {
17319
+ "text": "KeyboardEvent"
17320
+ },
17321
+ "description": "The keyboard event that triggered the action."
17322
+ }
17323
+ ],
17324
+ "description": "Handles the keydown event for the menu item.\nIf the Enter key is pressed, it triggers a click event on the menu item.\nThis allows keyboard users to activate the menu item using the Enter key.",
17325
+ "inheritedFrom": {
17326
+ "name": "ListItem",
17327
+ "module": "components/listitem/listitem.component.js"
17328
+ }
17329
+ },
17330
+ {
17331
+ "kind": "method",
17332
+ "name": "handleKeyUp",
17333
+ "privacy": "private",
17334
+ "return": {
17335
+ "type": {
17336
+ "text": "void"
17337
+ }
17338
+ },
17339
+ "parameters": [
17340
+ {
17341
+ "name": "event",
17342
+ "type": {
17343
+ "text": "KeyboardEvent"
17344
+ },
17345
+ "description": "The keyboard event that triggered the action."
17346
+ }
17347
+ ],
17348
+ "description": "Handles the keyup event for the menu item.\nIf the Space key is released, it triggers a click event on the menu item.\nThis allows keyboard users to activate the menu item using the Space key.\nIt also prevents the default action of the Space key to avoid scrolling the page.",
17349
+ "inheritedFrom": {
17350
+ "name": "MenuItem",
17351
+ "module": "components/menuitem/menuitem.component.js"
17352
+ }
17353
+ },
17236
17354
  {
17237
17355
  "kind": "method",
17238
17356
  "name": "renderTrailingControls",
@@ -17407,34 +17525,10 @@
17407
17525
  "module": "components/listitem/listitem.component.js"
17408
17526
  }
17409
17527
  },
17410
- {
17411
- "kind": "method",
17412
- "name": "handleKeyDown",
17413
- "privacy": "private",
17414
- "return": {
17415
- "type": {
17416
- "text": "void"
17417
- }
17418
- },
17419
- "parameters": [
17420
- {
17421
- "name": "event",
17422
- "type": {
17423
- "text": "KeyboardEvent"
17424
- },
17425
- "description": "The keyboard event triggered when a key is pressed down."
17426
- }
17427
- ],
17428
- "description": "Fires the click event when the enter or space key is pressed.",
17429
- "inheritedFrom": {
17430
- "name": "ListItem",
17431
- "module": "components/listitem/listitem.component.js"
17432
- }
17433
- },
17434
17528
  {
17435
17529
  "kind": "method",
17436
17530
  "name": "triggerClickEvent",
17437
- "privacy": "private",
17531
+ "privacy": "protected",
17438
17532
  "description": "Triggers a click event on the list item.",
17439
17533
  "inheritedFrom": {
17440
17534
  "name": "ListItem",
@@ -17627,6 +17721,15 @@
17627
17721
  "default": "'false'",
17628
17722
  "fieldName": "ariaChecked"
17629
17723
  },
17724
+ {
17725
+ "name": "name",
17726
+ "type": {
17727
+ "text": "string"
17728
+ },
17729
+ "default": "''",
17730
+ "description": "The name attribute is used to group radio items within the same menu container.",
17731
+ "fieldName": "name"
17732
+ },
17630
17733
  {
17631
17734
  "name": "arrow-position",
17632
17735
  "type": {
@@ -17945,51 +18048,12 @@
17945
18048
  "members": [
17946
18049
  {
17947
18050
  "kind": "field",
17948
- "name": "ariaOrientation",
17949
- "type": {
17950
- "text": "Orientation"
17951
- },
17952
- "description": "Defines the orientation of the menu. This value is reflected to\nthe `aria-orientation` attribute and can be either `'horizontal'` or `'vertical'`.",
17953
- "default": "'horizontal'",
17954
- "attribute": "aria-orientation",
17955
- "reflects": true,
17956
- "inheritedFrom": {
17957
- "name": "MenuMixin",
17958
- "module": "utils/mixins/MenuMixin.js"
17959
- }
17960
- },
17961
- {
17962
- "kind": "method",
17963
- "name": "setMenuBarPopoverValue",
17964
- "privacy": "private",
17965
- "parameters": [
17966
- {
17967
- "name": "value",
17968
- "type": {
17969
- "text": "boolean"
17970
- },
17971
- "description": "The value to set."
17972
- }
17973
- ],
17974
- "description": "Sets the value of the data-menu-popover-open attribute on the menu element.",
17975
- "inheritedFrom": {
17976
- "name": "MenuMixin",
17977
- "module": "utils/mixins/MenuMixin.js"
17978
- }
17979
- },
17980
- {
17981
- "kind": "method",
17982
- "name": "isMenuPopoverOpen",
17983
- "privacy": "private",
17984
- "return": {
17985
- "type": {
17986
- "text": "boolean"
17987
- }
17988
- },
17989
- "description": "Returns true if the data-menu-popover-open attribute on the menu element is set to 'true', false otherwise.",
18051
+ "name": "hidePopover",
18052
+ "privacy": "public",
18053
+ "description": "Hides the popover.",
17990
18054
  "inheritedFrom": {
17991
- "name": "MenuMixin",
17992
- "module": "utils/mixins/MenuMixin.js"
18055
+ "name": "Popover",
18056
+ "module": "components/popover/popover.component.js"
17993
18057
  }
17994
18058
  },
17995
18059
  {
@@ -18007,255 +18071,63 @@
18007
18071
  "type": {
18008
18072
  "text": "EventTarget | null"
18009
18073
  },
18010
- "description": "The target element to find the index of."
18074
+ "description": "The target element that triggered the event."
18011
18075
  }
18012
18076
  ],
18013
- "description": "Returns the index of the given target in the menuItems array.\nIf the target is not a menu item, but a child element of a menu item,\nit returns the index of the parent menu item.",
18014
- "inheritedFrom": {
18015
- "name": "MenuMixin",
18016
- "module": "utils/mixins/MenuMixin.js"
18017
- }
18077
+ "description": "Retrieves the current index of the menu item that triggered the event."
18018
18078
  },
18019
18079
  {
18020
18080
  "kind": "method",
18021
- "name": "updatePopoverPlacementBasedOnOrientation",
18022
- "privacy": "protected",
18023
- "return": {
18024
- "type": {
18025
- "text": "void"
18026
- }
18027
- },
18028
- "description": "Updates the placement of the popover based on the aria-orientation property.",
18029
- "inheritedFrom": {
18030
- "name": "MenuMixin",
18031
- "module": "utils/mixins/MenuMixin.js"
18032
- }
18033
- },
18034
- {
18035
- "kind": "method",
18036
- "name": "updateTabIndexAndFocusNewIndex",
18081
+ "name": "resetTabIndexAndSetFocus",
18037
18082
  "privacy": "private",
18038
18083
  "parameters": [
18039
18084
  {
18040
- "name": "menuItems",
18041
- "type": {
18042
- "text": "Array<HTMLElement>"
18043
- },
18044
- "description": "The list of menu items."
18045
- },
18046
- {
18047
- "name": "currentIndex",
18085
+ "name": "newIndex",
18048
18086
  "type": {
18049
18087
  "text": "number"
18050
18088
  },
18051
- "description": "The current index of the focused menu item."
18089
+ "description": "The index of the new menu item to focus."
18052
18090
  },
18053
18091
  {
18054
- "name": "newIndex",
18092
+ "name": "oldIndex",
18055
18093
  "type": {
18056
18094
  "text": "number"
18057
18095
  },
18058
- "description": "The index of the new active element in the list."
18096
+ "description": "The index of the currently focused menu item."
18059
18097
  }
18060
18098
  ],
18061
- "description": "Updates the tabindex of the current index to -1 and the tabindex of the new index to 0,\neffectively setting the active element. This is used when navigating the menu via keyboard.",
18062
- "inheritedFrom": {
18063
- "name": "MenuMixin",
18064
- "module": "utils/mixins/MenuMixin.js"
18065
- }
18066
- },
18067
- {
18068
- "kind": "method",
18069
- "name": "isValidMenu",
18070
- "privacy": "private",
18071
- "return": {
18072
- "type": {
18073
- "text": ""
18074
- }
18075
- },
18076
- "parameters": [
18077
- {
18078
- "name": "tagName",
18079
- "optional": true,
18080
- "type": {
18081
- "text": "string"
18082
- },
18083
- "description": "The tag name to check."
18084
- }
18085
- ],
18086
- "description": "Checks if the given tag name is a valid menu tag name.",
18087
- "inheritedFrom": {
18088
- "name": "MenuMixin",
18089
- "module": "utils/mixins/MenuMixin.js"
18090
- }
18091
- },
18092
- {
18093
- "kind": "method",
18094
- "name": "isValidNavItemList",
18095
- "privacy": "private",
18096
- "return": {
18097
- "type": {
18098
- "text": ""
18099
- }
18100
- },
18101
- "parameters": [
18102
- {
18103
- "name": "tagName",
18104
- "optional": true,
18105
- "type": {
18106
- "text": "string"
18107
- },
18108
- "description": "The tag name to check."
18109
- }
18110
- ],
18111
- "description": "Checks if the given tag name is a valid navitemlist tag name.",
18112
- "inheritedFrom": {
18113
- "name": "MenuMixin",
18114
- "module": "utils/mixins/MenuMixin.js"
18115
- }
18116
- },
18117
- {
18118
- "kind": "method",
18119
- "name": "isValidPopover",
18120
- "privacy": "private",
18099
+ "description": "Resets the tabindex of the currently focused menu item and sets focus to a new menu item.",
18121
18100
  "return": {
18122
18101
  "type": {
18123
18102
  "text": ""
18124
18103
  }
18125
- },
18126
- "parameters": [
18127
- {
18128
- "name": "tagName",
18129
- "optional": true,
18130
- "type": {
18131
- "text": "string"
18132
- },
18133
- "description": "The tag name to check."
18134
- }
18135
- ],
18136
- "description": "Checks if the given tag name is a valid menu popover tag name.",
18137
- "inheritedFrom": {
18138
- "name": "MenuMixin",
18139
- "module": "utils/mixins/MenuMixin.js"
18140
18104
  }
18141
18105
  },
18142
18106
  {
18143
18107
  "kind": "method",
18144
- "name": "openPopover",
18108
+ "name": "closeAllMenuPopovers",
18145
18109
  "privacy": "private",
18146
- "return": {
18147
- "type": {
18148
- "text": ""
18149
- }
18150
- },
18151
- "parameters": [
18152
- {
18153
- "name": "index",
18154
- "type": {
18155
- "text": "number"
18156
- },
18157
- "description": "The index of the menu item to open the popover for."
18158
- }
18159
- ],
18160
- "description": "Opens the popover at the given index if it exists.",
18161
- "inheritedFrom": {
18162
- "name": "MenuMixin",
18163
- "module": "utils/mixins/MenuMixin.js"
18164
- }
18110
+ "description": "Closes all menu popovers in the stack.\nThis method is used to ensure that when a menu item is clicked,\nall other open popovers are closed, maintaining a clean user interface.\nIt iterates through the `popoverStack` and hides each popover until the stack is empty."
18165
18111
  },
18166
18112
  {
18167
- "kind": "method",
18168
- "name": "navigateToPrevMenuItem",
18169
- "privacy": "private",
18170
- "return": {
18171
- "type": {
18172
- "text": "void"
18173
- }
18174
- },
18175
- "parameters": [
18176
- {
18177
- "name": "currentIndex",
18178
- "type": {
18179
- "text": "number"
18180
- },
18181
- "description": "The current index of the focused menu item."
18182
- },
18183
- {
18184
- "name": "firstMenuIndex",
18185
- "type": {
18186
- "text": "number"
18187
- },
18188
- "description": "The index of the first menu item."
18189
- },
18190
- {
18191
- "name": "lastMenuIndex",
18192
- "type": {
18193
- "text": "number"
18194
- },
18195
- "description": "The index of the last menu item."
18196
- },
18197
- {
18198
- "name": "ariaOrientation",
18199
- "type": {
18200
- "text": "Orientation"
18201
- },
18202
- "description": "The orientation of the menu."
18203
- }
18204
- ],
18205
- "description": "Navigates to the previous menu item and updates the tabindex of the current index\nto -1 and the tabindex of the new index to 0.",
18206
- "inheritedFrom": {
18207
- "name": "MenuMixin",
18208
- "module": "utils/mixins/MenuMixin.js"
18209
- }
18210
- },
18211
- {
18212
- "kind": "method",
18213
- "name": "navigateToNextMenuItem",
18214
- "privacy": "private",
18215
- "return": {
18216
- "type": {
18217
- "text": "void"
18218
- }
18219
- },
18113
+ "kind": "field",
18114
+ "name": "onOutsidePopoverClick",
18115
+ "privacy": "protected",
18116
+ "description": "Handles outside click events to close the popover.\nThis method checks if the click occurred outside the popover and its trigger element.\nIf so, it closes the popover by calling `closeAllMenuPopovers`.\nIt also checks if the click was on the backdrop element (if present) to close the popover.",
18220
18117
  "parameters": [
18221
18118
  {
18222
- "name": "currentIndex",
18223
- "type": {
18224
- "text": "number"
18225
- },
18226
- "description": "The current index of the focused menu item."
18227
- },
18228
- {
18229
- "name": "firstMenuIndex",
18230
- "type": {
18231
- "text": "number"
18232
- },
18233
- "description": "The index of the first menu item."
18234
- },
18235
- {
18236
- "name": "lastMenuIndex",
18237
- "type": {
18238
- "text": "number"
18239
- },
18240
- "description": "The index of the last menu item."
18241
- },
18242
- {
18243
- "name": "ariaOrientation",
18244
- "type": {
18245
- "text": "Orientation"
18246
- },
18247
- "description": "The orientation of the menu."
18119
+ "description": "The mouse event that triggered the outside click.",
18120
+ "name": "event"
18248
18121
  }
18249
18122
  ],
18250
- "description": "Navigates to the next menu item and updates the tabindex of the current index\nto -1 and the tabindex of the new index to 0.",
18251
18123
  "inheritedFrom": {
18252
- "name": "MenuMixin",
18253
- "module": "utils/mixins/MenuMixin.js"
18124
+ "name": "Popover",
18125
+ "module": "components/popover/popover.component.js"
18254
18126
  }
18255
18127
  },
18256
18128
  {
18257
18129
  "kind": "method",
18258
- "name": "getParentMenuItemDetails",
18130
+ "name": "hasSubmenuWithTriggerId",
18259
18131
  "privacy": "private",
18260
18132
  "return": {
18261
18133
  "type": {
@@ -18264,30 +18136,18 @@
18264
18136
  },
18265
18137
  "parameters": [
18266
18138
  {
18267
- "name": "menuChildId",
18268
- "type": {
18269
- "text": "string"
18270
- },
18271
- "description": "The id of the menu child element."
18272
- },
18273
- {
18274
- "name": "menu",
18275
- "optional": true,
18139
+ "name": "id",
18276
18140
  "type": {
18277
- "text": "HTMLElement | null"
18141
+ "text": "string | null"
18278
18142
  },
18279
- "description": "The current menu element to start traversing from."
18143
+ "description": "The ID of the menu item to check for a submenu."
18280
18144
  }
18281
18145
  ],
18282
- "description": "Returns the parent menu item details for the given menu child id.\nIt recursively traverses up the DOM tree until it finds a menu or menubar element.",
18283
- "inheritedFrom": {
18284
- "name": "MenuMixin",
18285
- "module": "utils/mixins/MenuMixin.js"
18286
- }
18146
+ "description": "Checks if the menu popover has a submenu with the specified trigger ID.\nThis method is used to determine if a menu item has a submenu associated with it,\nwhich is indicated by the presence of a `triggerid` attribute in the submenu popover.\nIt queries the parent element for any popover with the specified trigger ID."
18287
18147
  },
18288
18148
  {
18289
18149
  "kind": "method",
18290
- "name": "hideAllPopovers",
18150
+ "name": "handleMouseClick",
18291
18151
  "privacy": "private",
18292
18152
  "return": {
18293
18153
  "type": {
@@ -18296,268 +18156,60 @@
18296
18156
  },
18297
18157
  "parameters": [
18298
18158
  {
18299
- "name": "menu",
18300
- "optional": true,
18159
+ "name": "event",
18301
18160
  "type": {
18302
- "text": "HTMLElement | null"
18161
+ "text": "MouseEvent"
18303
18162
  },
18304
- "description": "The current menu element to start traversing from."
18163
+ "description": "The mouse event that triggered the click."
18305
18164
  }
18306
18165
  ],
18307
- "description": "Recursively hides all the popovers up the DOM tree until it finds a menu or menubar element.",
18308
- "inheritedFrom": {
18309
- "name": "MenuMixin",
18310
- "module": "utils/mixins/MenuMixin.js"
18311
- }
18166
+ "description": "Handles mouse click events on the menu items.\nThis method checks if the clicked element is a valid menu item and not a submenu trigger.\nIf it is, it closes all other menu popovers to ensure only one menu is open at a time."
18312
18167
  },
18313
18168
  {
18314
18169
  "kind": "method",
18315
- "name": "navigateToPrevParentMenuItem",
18170
+ "name": "resolveDirectionKey",
18316
18171
  "privacy": "private",
18317
- "return": {
18318
- "type": {
18319
- "text": "void"
18320
- }
18321
- },
18322
18172
  "parameters": [
18323
- {
18324
- "name": "currentIndex",
18325
- "type": {
18326
- "text": "number"
18327
- },
18328
- "description": "The current index of the focused menu item."
18329
- },
18330
18173
  {
18331
18174
  "name": "key",
18332
18175
  "type": {
18333
18176
  "text": "string"
18334
- }
18335
- }
18336
- ],
18337
- "description": "Recursively navigates up the DOM tree until it finds the previous menu item\nand updates the tabindex of the current index to -1 and the tabindex of the new index to 0.\nAlso opens the popover of the previous menu item.",
18338
- "inheritedFrom": {
18339
- "name": "MenuMixin",
18340
- "module": "utils/mixins/MenuMixin.js"
18341
- }
18342
- },
18343
- {
18344
- "kind": "method",
18345
- "name": "closePopoverAndNavigateToPrevParentMenuItem",
18346
- "privacy": "private",
18347
- "return": {
18348
- "type": {
18349
- "text": "void"
18350
- }
18351
- },
18352
- "parameters": [
18353
- {
18354
- "name": "currentIndex",
18355
- "type": {
18356
- "text": "number"
18357
18177
  },
18358
- "description": "The current index of the focused menu item."
18178
+ "description": "The key pressed by the user."
18359
18179
  },
18360
18180
  {
18361
- "name": "key",
18362
- "type": {
18363
- "text": "string"
18364
- }
18365
- }
18366
- ],
18367
- "description": "Closes the current menu popover and navigates to the previous parent menu item.",
18368
- "inheritedFrom": {
18369
- "name": "MenuMixin",
18370
- "module": "utils/mixins/MenuMixin.js"
18371
- }
18372
- },
18373
- {
18374
- "kind": "method",
18375
- "name": "getParentMenuContents",
18376
- "privacy": "private",
18377
- "return": {
18378
- "type": {
18379
- "text": ""
18380
- }
18381
- },
18382
- "parameters": [
18383
- {
18384
- "name": "currentMenuItem",
18385
- "type": {
18386
- "text": "HTMLElement | null"
18387
- },
18388
- "description": "The current menu item to start traversing from."
18389
- }
18390
- ],
18391
- "description": "Gets the parent menu contents of the given current menu item.\nIt recursively traverses up the DOM tree until it finds the parent menu element\nand gets the parent menu item details and the children of the parent menu item.",
18392
- "inheritedFrom": {
18393
- "name": "MenuMixin",
18394
- "module": "utils/mixins/MenuMixin.js"
18395
- }
18396
- },
18397
- {
18398
- "kind": "method",
18399
- "name": "openPopoverAndNavigateToNextChildrenMenuItem",
18400
- "privacy": "private",
18401
- "return": {
18402
- "type": {
18403
- "text": "void"
18404
- }
18405
- },
18406
- "parameters": [
18407
- {
18408
- "name": "currentIndex",
18181
+ "name": "isRtl",
18409
18182
  "type": {
18410
- "text": "number"
18183
+ "text": "boolean"
18411
18184
  },
18412
- "description": "The current index of the focused menu item."
18185
+ "description": "A boolean indicating if the layout is right-to-left (RTL)."
18413
18186
  }
18414
18187
  ],
18415
- "description": "Opens the popover of the next children menu item if there are children.\nIf there are no children, then it closes all popovers recursively and\nnavigates to the next menu item from the menu bar.\nIf the parent menu item does not have any children, then we will go to the next menu item.",
18416
- "inheritedFrom": {
18417
- "name": "MenuMixin",
18418
- "module": "utils/mixins/MenuMixin.js"
18419
- }
18420
- },
18421
- {
18422
- "kind": "method",
18423
- "name": "isValidMenuItem",
18424
- "privacy": "private",
18188
+ "description": "Resolves the key pressed by the user based on the direction of the layout.\nThis method is used to handle keyboard navigation in a right-to-left (RTL) layout.\nIt checks if the layout is RTL and adjusts the arrow keys accordingly.\nFor example, in RTL, the left arrow key behaves like the right arrow key and vice versa.",
18425
18189
  "return": {
18426
18190
  "type": {
18427
18191
  "text": ""
18428
18192
  }
18429
- },
18430
- "parameters": [
18431
- {
18432
- "name": "menuItem",
18433
- "type": {
18434
- "text": "HTMLElement"
18435
- },
18436
- "description": "The menu item to check."
18437
- }
18438
- ],
18439
- "description": "Checks if the given menu item is a valid menu item.",
18440
- "inheritedFrom": {
18441
- "name": "MenuMixin",
18442
- "module": "utils/mixins/MenuMixin.js"
18443
- }
18444
- },
18445
- {
18446
- "kind": "method",
18447
- "name": "resetTabIndexAndSetActiveTabIndex",
18448
- "privacy": "private",
18449
- "parameters": [
18450
- {
18451
- "name": "menuItems",
18452
- "type": {
18453
- "text": "Array<HTMLElement>"
18454
- }
18455
- },
18456
- {
18457
- "description": "The index of the new active element in the list.",
18458
- "name": "newIndex"
18459
- }
18460
- ],
18461
- "description": "Resets all list items tabindex to -1 and sets the tabindex of the\nelement at the given index to 0, effectively setting the active\nelement. This is used when navigating the list via keyboard.",
18462
- "inheritedFrom": {
18463
- "name": "MenuMixin",
18464
- "module": "utils/mixins/MenuMixin.js"
18465
- }
18466
- },
18467
- {
18468
- "kind": "method",
18469
- "name": "getKeyBasedOnDirection",
18470
- "privacy": "private",
18471
- "return": {
18472
- "type": {
18473
- "text": ""
18474
- }
18475
- },
18476
- "parameters": [
18477
- {
18478
- "name": "originalKey",
18479
- "type": {
18480
- "text": "string"
18481
- },
18482
- "description": "The original key pressed."
18483
- }
18484
- ],
18485
- "description": "Returns the key based on the direction of the document.\nIf the document is in RTL mode and the key is ARROW_LEFT or ARROW_RIGHT,\nit will swap them to maintain the correct navigation direction.",
18486
- "inheritedFrom": {
18487
- "name": "MenuMixin",
18488
- "module": "utils/mixins/MenuMixin.js"
18489
18193
  }
18490
18194
  },
18491
18195
  {
18492
18196
  "kind": "method",
18493
18197
  "name": "handleKeyDown",
18494
- "privacy": "protected",
18495
- "return": {
18496
- "type": {
18497
- "text": "void"
18498
- }
18499
- },
18198
+ "privacy": "private",
18500
18199
  "parameters": [
18501
18200
  {
18502
18201
  "name": "event",
18503
18202
  "type": {
18504
18203
  "text": "KeyboardEvent"
18505
18204
  },
18506
- "description": "The keyboard event."
18507
- }
18508
- ],
18509
- "description": "Handles the keydown event on the menu bar.\nThe keys are as follows:\n- HOME: Sets focus to the first menu item.\n- END: Sets focus to the last menu item.\n- ARROW_LEFT:\n - If orientation is horizontal, then it navigates to the previous menu item.\n - If orientation is vertical, then it closes the popover of the current menu item and\n navigates to the previous parent menu item.\n- ARROW_RIGHT:\n - If orientation is horizontal, then it navigates to the next menu item.\n - If orientation is vertical, then it opens the popover of the current menu item and\n navigates to the next children menu item.\n- ARROW_UP:\n - If orientation is horizontal, then it opens the popover of the current menu item.\n - If orientation is vertical, then it navigates to the previous menu item.\n- ARROW_DOWN:\n - If orientation is horizontal, then it opens the popover of the current menu item.\n - If orientation is vertical, then it navigates to the next menu item.\n- SPACE:\n- ENTER:\n - If the next element sibling is a menu popover, then it opens the popover of the current\n menu item and navigates to the next children menu item.\n - If the target element is a menu item, then it closes all popovers recursively and\n navigates to the previous parent menu item.\n- ESCAPE:\n - If a popover is already open then we close it and navigate to the parent menu item.\n - If the current menuitem is a child of menubar, then we will set the value of isMenuPopoverOpen to false.,",
18510
- "inheritedFrom": {
18511
- "name": "MenuMixin",
18512
- "module": "utils/mixins/MenuMixin.js"
18513
- }
18514
- },
18515
- {
18516
- "kind": "method",
18517
- "name": "closeAllPopoversExceptCurrent",
18518
- "privacy": "private",
18519
- "return": {
18520
- "type": {
18521
- "text": "void"
18522
- }
18523
- },
18524
- "parameters": [
18525
- {
18526
- "name": "currentIndex",
18527
- "type": {
18528
- "text": "number"
18529
- },
18530
- "description": "The index of the current menu item."
18205
+ "description": "The keyboard event that triggered the keydown action."
18531
18206
  }
18532
18207
  ],
18533
- "description": "Closes all popovers except the current one.",
18534
- "inheritedFrom": {
18535
- "name": "MenuMixin",
18536
- "module": "utils/mixins/MenuMixin.js"
18537
- }
18538
- },
18539
- {
18540
- "kind": "method",
18541
- "name": "handleMouseClick",
18542
- "privacy": "protected",
18208
+ "description": "Handles keydown events for keyboard navigation within the menu popover.\nThis method allows users to navigate through the menu items using the keyboard.\nIt supports Home, End, Arrow Up, Arrow Down, Arrow Left, Arrow Right, and Escape keys.",
18543
18209
  "return": {
18544
18210
  "type": {
18545
- "text": "void"
18546
- }
18547
- },
18548
- "parameters": [
18549
- {
18550
- "name": "event",
18551
- "type": {
18552
- "text": "MouseEvent"
18553
- },
18554
- "description": "The mouse click event."
18211
+ "text": ""
18555
18212
  }
18556
- ],
18557
- "description": "Handles the mouse click event on the menu items.\n- If the menuitem has children, then it opens the popover of the next children menu item.\n- If the menuitem does not have children, then it closes all popovers recursively.",
18558
- "inheritedFrom": {
18559
- "name": "MenuMixin",
18560
- "module": "utils/mixins/MenuMixin.js"
18561
18213
  }
18562
18214
  },
18563
18215
  {
@@ -19530,22 +19182,6 @@
19530
19182
  "module": "components/popover/popover.component.js"
19531
19183
  }
19532
19184
  },
19533
- {
19534
- "kind": "field",
19535
- "name": "onOutsidePopoverClick",
19536
- "privacy": "private",
19537
- "description": "Handles the outside click event to close the popover.",
19538
- "parameters": [
19539
- {
19540
- "description": "The mouse event.",
19541
- "name": "event"
19542
- }
19543
- ],
19544
- "inheritedFrom": {
19545
- "name": "Popover",
19546
- "module": "components/popover/popover.component.js"
19547
- }
19548
- },
19549
19185
  {
19550
19186
  "kind": "field",
19551
19187
  "name": "onEscapeKeydown",
@@ -19634,16 +19270,6 @@
19634
19270
  "module": "components/popover/popover.component.js"
19635
19271
  }
19636
19272
  },
19637
- {
19638
- "kind": "field",
19639
- "name": "hidePopover",
19640
- "privacy": "public",
19641
- "description": "Hides the popover.",
19642
- "inheritedFrom": {
19643
- "name": "Popover",
19644
- "module": "components/popover/popover.component.js"
19645
- }
19646
- },
19647
19273
  {
19648
19274
  "kind": "field",
19649
19275
  "name": "togglePopoverVisible",
@@ -19674,12 +19300,6 @@
19674
19300
  }
19675
19301
  }
19676
19302
  ],
19677
- "mixins": [
19678
- {
19679
- "name": "MenuMixin",
19680
- "module": "/src/utils/mixins/MenuMixin"
19681
- }
19682
- ],
19683
19303
  "superclass": {
19684
19304
  "name": "Popover",
19685
19305
  "module": "/src/components/popover/popover.component"
@@ -19688,19 +19308,6 @@
19688
19308
  "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 */",
19689
19309
  "customElement": true,
19690
19310
  "attributes": [
19691
- {
19692
- "name": "aria-orientation",
19693
- "type": {
19694
- "text": "Orientation"
19695
- },
19696
- "description": "Defines the orientation of the menu. This value is reflected to\nthe `aria-orientation` attribute and can be either `'horizontal'` or `'vertical'`.",
19697
- "default": "'horizontal'",
19698
- "fieldName": "ariaOrientation",
19699
- "inheritedFrom": {
19700
- "name": "MenuMixin",
19701
- "module": "src/utils/mixins/MenuMixin.ts"
19702
- }
19703
- },
19704
19311
  {
19705
19312
  "name": "should-focus-trap-wrap",
19706
19313
  "type": {
@@ -20553,6 +20160,54 @@
20553
20160
  "module": "components/menuitem/menuitem.component.js"
20554
20161
  }
20555
20162
  },
20163
+ {
20164
+ "kind": "method",
20165
+ "name": "handleKeyDown",
20166
+ "privacy": "protected",
20167
+ "return": {
20168
+ "type": {
20169
+ "text": "void"
20170
+ }
20171
+ },
20172
+ "parameters": [
20173
+ {
20174
+ "name": "event",
20175
+ "type": {
20176
+ "text": "KeyboardEvent"
20177
+ },
20178
+ "description": "The keyboard event that triggered the action."
20179
+ }
20180
+ ],
20181
+ "description": "Handles the keydown event for the menu item.\nIf the Enter key is pressed, it triggers a click event on the menu item.\nThis allows keyboard users to activate the menu item using the Enter key.",
20182
+ "inheritedFrom": {
20183
+ "name": "ListItem",
20184
+ "module": "components/listitem/listitem.component.js"
20185
+ }
20186
+ },
20187
+ {
20188
+ "kind": "method",
20189
+ "name": "handleKeyUp",
20190
+ "privacy": "private",
20191
+ "return": {
20192
+ "type": {
20193
+ "text": "void"
20194
+ }
20195
+ },
20196
+ "parameters": [
20197
+ {
20198
+ "name": "event",
20199
+ "type": {
20200
+ "text": "KeyboardEvent"
20201
+ },
20202
+ "description": "The keyboard event that triggered the action."
20203
+ }
20204
+ ],
20205
+ "description": "Handles the keyup event for the menu item.\nIf the Space key is released, it triggers a click event on the menu item.\nThis allows keyboard users to activate the menu item using the Space key.\nIt also prevents the default action of the Space key to avoid scrolling the page.",
20206
+ "inheritedFrom": {
20207
+ "name": "MenuItem",
20208
+ "module": "components/menuitem/menuitem.component.js"
20209
+ }
20210
+ },
20556
20211
  {
20557
20212
  "kind": "method",
20558
20213
  "name": "renderTrailingControls",
@@ -20727,34 +20382,10 @@
20727
20382
  "module": "components/listitem/listitem.component.js"
20728
20383
  }
20729
20384
  },
20730
- {
20731
- "kind": "method",
20732
- "name": "handleKeyDown",
20733
- "privacy": "private",
20734
- "return": {
20735
- "type": {
20736
- "text": "void"
20737
- }
20738
- },
20739
- "parameters": [
20740
- {
20741
- "name": "event",
20742
- "type": {
20743
- "text": "KeyboardEvent"
20744
- },
20745
- "description": "The keyboard event triggered when a key is pressed down."
20746
- }
20747
- ],
20748
- "description": "Fires the click event when the enter or space key is pressed.",
20749
- "inheritedFrom": {
20750
- "name": "ListItem",
20751
- "module": "components/listitem/listitem.component.js"
20752
- }
20753
- },
20754
20385
  {
20755
20386
  "kind": "method",
20756
20387
  "name": "triggerClickEvent",
20757
- "privacy": "private",
20388
+ "privacy": "protected",
20758
20389
  "description": "Triggers a click event on the list item.",
20759
20390
  "inheritedFrom": {
20760
20391
  "name": "ListItem",
@@ -22444,7 +22075,7 @@
22444
22075
  {
22445
22076
  "kind": "method",
22446
22077
  "name": "handleKeyDown",
22447
- "privacy": "private",
22078
+ "privacy": "protected",
22448
22079
  "return": {
22449
22080
  "type": {
22450
22081
  "text": "void"
@@ -22459,7 +22090,7 @@
22459
22090
  "description": "The keyboard event triggered when a key is pressed down."
22460
22091
  }
22461
22092
  ],
22462
- "description": "Fires the click event when the enter or space key is pressed.",
22093
+ "description": "Fires the click event when the enter or space key is pressed down.\nThis behavior is similar to a button click and key interaction.",
22463
22094
  "inheritedFrom": {
22464
22095
  "name": "ListItem",
22465
22096
  "module": "components/listitem/listitem.component.js"
@@ -22468,7 +22099,7 @@
22468
22099
  {
22469
22100
  "kind": "method",
22470
22101
  "name": "triggerClickEvent",
22471
- "privacy": "private",
22102
+ "privacy": "protected",
22472
22103
  "description": "Triggers a click event on the list item.",
22473
22104
  "inheritedFrom": {
22474
22105
  "name": "ListItem",
@@ -23377,7 +23008,7 @@
23377
23008
  {
23378
23009
  "kind": "field",
23379
23010
  "name": "onOutsidePopoverClick",
23380
- "privacy": "private",
23011
+ "privacy": "protected",
23381
23012
  "description": "Handles the outside click event to close the popover.",
23382
23013
  "parameters": [
23383
23014
  {
@@ -33823,7 +33454,7 @@
33823
33454
  {
33824
33455
  "kind": "field",
33825
33456
  "name": "onOutsidePopoverClick",
33826
- "privacy": "private",
33457
+ "privacy": "protected",
33827
33458
  "description": "Handles the outside click event to close the popover.",
33828
33459
  "parameters": [
33829
33460
  {
@@ -35593,7 +35224,7 @@
35593
35224
  {
35594
35225
  "kind": "field",
35595
35226
  "name": "onOutsidePopoverClick",
35596
- "privacy": "private",
35227
+ "privacy": "protected",
35597
35228
  "description": "Handles the outside click event to close the popover.",
35598
35229
  "parameters": [
35599
35230
  {