Menu and Friends workstream

packages/react/__tests__/__snapshots__/PublicAPI-test.js.snap

@@ -1372,6 +1372,19 @@ Map {
         "isRequired": true,
         "type": "string",
       },
+      "menuAlignment": Object {
+        "args": Array [
+          Array [
+            "top",
+            "top-start",
+            "top-end",
+            "bottom",
+            "bottom-start",
+            "bottom-end",
+          ],
+        ],
+        "type": "oneOf",
+      },
       "onClick": Object {
         "type": "func",
       },
@@ -4470,6 +4483,9 @@ Map {
       "label": Object {
         "type": "string",
       },
+      "menuAlignment": Object {
+        "type": "string",
+      },
       "mode": Object {
         "args": Array [
           Array [
@@ -4568,6 +4584,19 @@ Map {
         "isRequired": true,
         "type": "string",
       },
+      "menuAlignment": Object {
+        "args": Array [
+          Array [
+            "top",
+            "top-start",
+            "top-end",
+            "bottom",
+            "bottom-start",
+            "bottom-end",
+          ],
+        ],
+        "type": "oneOf",
+      },
       "size": Object {
         "args": Array [
           Array [

packages/react/src/components/ComboButton/ComboButton-test.js

@@ -1,3 +1,4 @@
+/* eslint-disable testing-library/no-node-access */
 /**
  * Copyright IBM Corp. 2023
  *
@@ -106,14 +107,40 @@ describe('ComboButton', () => {
             </ComboButton>
           );
 
-          // eslint-disable-next-line testing-library/no-node-access
           expect(container.firstChild.lastChild).toHaveClass(
             `${prefix}--popover--${alignment}`
           );
         });
       });
     });
 
+    describe('supports props.menuAlignment', () => {
+      const alignments = [
+        'top',
+        'top-start',
+        'top-end',
+        'bottom',
+        'bottom-start',
+        'bottom-end',
+      ];
+
+      alignments.forEach((alignment) => {
+        it(`menuAlignment="${alignment}"`, async () => {
+          render(
+            <ComboButton label="Primary action" menuAlignment={alignment}>
+              <MenuItem label="Additional action" />
+            </ComboButton>
+          );
+
+          await userEvent.click(screen.getAllByRole('button')[1]);
+
+          expect(screen.getByRole('menu')).toHaveClass(
+            `${prefix}--combo-button__${alignment}`
+          );
+        });
+      });
+    });
+
     it('supports props.translateWithId', () => {
       const t = () => 'test';
 
@@ -125,7 +152,6 @@ describe('ComboButton', () => {
 
       const triggerButton = screen.getAllByRole('button')[1];
       const tooltipId = triggerButton.getAttribute('aria-labelledby');
-      // eslint-disable-next-line testing-library/no-node-access
       const tooltip = document.getElementById(tooltipId);
 
       expect(tooltip).toHaveTextContent(t());
@@ -210,5 +236,20 @@ describe('ComboButton', () => {
       expect(spy).toHaveBeenCalled();
       spy.mockRestore();
     });
+
+    it('supports ellipsis in ComboButton by checking the className', async () => {
+      render(
+        <ComboButton label="Primary action super long text to enable ellipsis">
+          <MenuItem label="Submenu">
+            <MenuItem label="Action" />
+          </MenuItem>
+        </ComboButton>
+      );
+
+      expect(
+        screen.getByTitle('Primary action super long text to enable ellipsis')
+          .parentElement
+      ).toHaveClass(`${prefix}--combo-button__primary-action`);
+    });
   });
 });

packages/react/src/components/ComboButton/ComboButton.mdx

@@ -27,6 +27,19 @@ disclosed list next to the primary action. These additional actions must be
 </ComboButton>
 ```
 
+## Menu Alignment (experimental)
+
+The `menuAlignment` prop enables you to define the placement of the Menu in
+relation to the `ComboButton`. For instance, setting `menuAlignment="top"` on
+the `ComboButton` will render the Menu above the button.
+
+If it seems your specified `menuAlignment` isn't working, it's because we
+prioritize ensuring the Menu remains visible. We calculate the optimal position
+to display the Menu in case the provided `menuAlignment` obscures it.
+
+We encourage you to play around in the Storybook playground to better understand
+the `menuAlignment` prop.
+
 ## Component API
 
 <ArgsTable />

packages/react/src/components/ComboButton/ComboButton.stories.js

@@ -30,15 +30,15 @@ export default {
 
 export const Default = () => (
   <ComboButton label="Primary action">
-    <MenuItem label="Second action" />
+    <MenuItem label="Second action with a long label description" />
     <MenuItem label="Third action" />
     <MenuItem label="Fourth action" disabled />
   </ComboButton>
 );
 
 export const WithDanger = () => (
   <ComboButton label="Primary action">
-    <MenuItem label="Second action" />
+    <MenuItem label="Second action with a long label description" />
     <MenuItem label="Third action" />
     <MenuItem label="Fourth action" />
     <MenuItemDivider />
@@ -53,12 +53,70 @@ export const WithIcons = () => (
   </ComboButton>
 );
 
+export const WithMenuAlignment = () => (
+  <>
+    <div style={{ display: 'flex', justifyContent: 'space-between' }}>
+      <ComboButton label="Bottom" menuAlignment="bottom">
+        <MenuItem label="Second action with a long label description" />
+        <MenuItem label="Third action" />
+        <MenuItem label="Fourth action" disabled />
+      </ComboButton>
+
+      <ComboButton label="Bottom start" menuAlignment="bottom-start">
+        <MenuItem label="Second action with a long label description" />
+        <MenuItem label="Third action" />
+        <MenuItem label="Fourth action" disabled />
+      </ComboButton>
+
+      <ComboButton label="Bottom end" menuAlignment="bottom-end">
+        <MenuItem label="Second action with a long label description" />
+        <MenuItem label="Third action" />
+        <MenuItem label="Fourth action" disabled />
+      </ComboButton>
+    </div>
+
+    <div
+      style={{
+        display: 'flex',
+        marginTop: '15rem',
+        justifyContent: 'space-between',
+      }}>
+      <ComboButton label="Top" menuAlignment="top" tooltipAlignment="bottom">
+        <MenuItem label="Second action with a long label description" />
+        <MenuItem label="Third action" />
+        <MenuItem label="Fourth action" disabled />
+      </ComboButton>
+
+      <ComboButton
+        label="Top start"
+        menuAlignment="top-start"
+        tooltipAlignment="bottom">
+        <MenuItem label="Second action with a long label description" />
+        <MenuItem label="Third action" />
+        <MenuItem label="Fourth action" disabled />
+      </ComboButton>
+
+      <ComboButton
+        label="Top end"
+        menuAlignment="top-end"
+        tooltipAlignment="bottom">
+        <MenuItem label="Second action with a long label description" />
+        <MenuItem label="Third action" />
+        <MenuItem label="Fourth action" disabled />
+      </ComboButton>
+    </div>
+  </>
+);
+
 export const Playground = (args) => {
   const onClick = action('onClick (MenuItem)');
 
   return (
     <ComboButton {...args}>
-      <MenuItem label="Second action" onClick={onClick} />
+      <MenuItem
+        label="Second action with a long label description"
+        onClick={onClick}
+      />
       <MenuItem label="Third action" onClick={onClick} />
       <MenuItem label="Fourth action" disabled onClick={onClick} />
       <MenuItemDivider />

packages/react/src/components/ComboButton/index.js

@@ -36,6 +36,7 @@ const ComboButton = React.forwardRef(function ComboButton(
     label,
     onClick,
     size = 'lg',
+    menuAlignment = 'bottom',
     tooltipAlignment,
     translateWithId: t = defaultTranslateWithId,
     ...rest
@@ -44,7 +45,6 @@ const ComboButton = React.forwardRef(function ComboButton(
 ) {
   const id = useId('combobutton');
   const prefix = usePrefix();
-
   const containerRef = useRef(null);
   const menuRef = useRef(null);
   const ref = useMergedRefs([forwardRef, containerRef]);
@@ -74,6 +74,11 @@ const ComboButton = React.forwardRef(function ComboButton(
 
   function handleOpen() {
     menuRef.current.style.inlineSize = `${width}px`;
+    menuRef.current.style.minInlineSize = `${width}px`;
+
+    if (menuAlignment !== 'bottom' && menuAlignment !== 'top') {
+      menuRef.current.style.inlineSize = `fit-content`;
+    }
   }
 
   const containerClasses = classNames(
@@ -85,6 +90,8 @@ const ComboButton = React.forwardRef(function ComboButton(
     className
   );
 
+  const menuClasses = classNames(`${prefix}--combo-button__${menuAlignment}`);
+
   const primaryActionClasses = classNames(
     `${prefix}--combo-button__primary-action`
   );
@@ -98,6 +105,7 @@ const ComboButton = React.forwardRef(function ComboButton(
       aria-owns={open ? id : null}>
       <div className={primaryActionClasses}>
         <Button
+          title={label}
           size={size}
           disabled={disabled}
           onClick={handlePrimaryActionClick}>
@@ -118,6 +126,9 @@ const ComboButton = React.forwardRef(function ComboButton(
         <ChevronDown />
       </IconButton>
       <Menu
+        containerRef={containerRef}
+        menuAlignment={menuAlignment}
+        className={menuClasses}
         ref={menuRef}
         id={id}
         label={t('carbon.combo-button.additional-actions')}
@@ -155,6 +166,18 @@ ComboButton.propTypes = {
    */
   label: PropTypes.string.isRequired,
 
+  /**
+   * Experimental property. Specify how the menu should align with the button element
+   */
+  menuAlignment: PropTypes.oneOf([
+    'top',
+    'top-start',
+    'top-end',
+    'bottom',
+    'bottom-start',
+    'bottom-end',
+  ]),
+
   /**
    * Provide an optional function to be called when the primary action element is clicked.
    */