Merge branch 'angular:main' into aria-isnot

Author: adolgachev

src/aria/accordion/accordion.ts

@@ -80,6 +80,21 @@ export class AccordionPanel {
       this._deferredContentAware.contentVisible.set(this.visible());
     });
   }
+
+  /** Expands this item. */
+  expand() {
+    this.accordionTrigger()?.expansionControl.open();
+  }
+
+  /** Collapses this item. */
+  collapse() {
+    this.accordionTrigger()?.expansionControl.close();
+  }
+
+  /** Toggles the expansion state of this item. */
+  toggle() {
+    this.accordionTrigger()?.expansionControl.toggle();
+  }
 }
 
 /**
@@ -145,6 +160,21 @@ export class AccordionTrigger {
     accordionGroup: computed(() => this._accordionGroup._pattern),
     accordionPanel: this.accordionPanel,
   });
+
+  /** Expands this item. */
+  expand() {
+    this._pattern.expansionControl.open();
+  }
+
+  /** Collapses this item. */
+  collapse() {
+    this._pattern.expansionControl.close();
+  }
+
+  /** Toggles the expansion state of this item. */
+  toggle() {
+    this._pattern.expansionControl.toggle();
+  }
 }
 
 /**
@@ -214,6 +244,16 @@ export class AccordionGroup {
       }
     });
   }
+
+  /** Expands all accordion panels if multi-expandable. */
+  expandAll() {
+    this._pattern.expansionManager.openAll();
+  }
+
+  /** Collapses all accordion panels. */
+  collapseAll() {
+    this._pattern.expansionManager.closeAll();
+  }
 }
 
 /**

src/aria/combobox/combobox.ts

@@ -117,6 +117,16 @@ export class Combobox<V> {
       }
     });
   }
+
+  /** Opens the combobox to the selected item. */
+  open() {
+    this._pattern.open({selected: true});
+  }
+
+  /** Closes the combobox. */
+  close() {
+    this._pattern.close();
+  }
 }
 
 @Directive({

src/aria/menu/menu.ts

@@ -83,6 +83,16 @@ export class MenuTrigger<V> {
   constructor() {
     effect(() => this.menu()?.parent.set(this));
   }
+
+  /** Opens the menu focusing on the first menu item. */
+  open() {
+    this._pattern.open({first: true});
+  }
+
+  /** Closes the menu. */
+  close() {
+    this._pattern.close();
+  }
 }
 
 /**
@@ -220,24 +230,9 @@ export class Menu<V> {
     });
   }
 
-  // TODO(wagnermaciel): Author close, closeAll, and open methods for each directive.
-
   /** Closes the menu. */
-  close(opts?: {refocus?: boolean}) {
-    this._pattern.inputs.parent()?.close(opts);
-  }
-
-  /** Closes all parent menus. */
-  closeAll(opts?: {refocus?: boolean}) {
-    const root = this._pattern.root();
-
-    if (root instanceof MenuTriggerPattern) {
-      root.close(opts);
-    }
-
-    if (root instanceof MenuPattern || root instanceof MenuBarPattern) {
-      root.inputs.activeItem()?.close(opts);
-    }
+  close() {
+    this._pattern.close();
   }
 }
 
@@ -318,6 +313,11 @@ export class MenuBar<V> {
       }
     });
   }
+
+  /** Closes the menubar. */
+  close() {
+    this._pattern.close();
+  }
 }
 
 /**
@@ -396,6 +396,16 @@ export class MenuItem<V> {
   constructor() {
     effect(() => this.submenu()?.parent.set(this));
   }
+
+  /** Opens the submenu focusing on the first menu item. */
+  open() {
+    this._pattern.open({first: true});
+  }
+
+  /** Closes the submenu. */
+  close() {
+    this._pattern.close();
+  }
 }
 
 /** Defers the rendering of the menu content. */

src/aria/private/menu/menu.ts

@@ -395,6 +395,11 @@ export class MenuPattern<V> {
     }
   }
 
+  /** Closes the menu. */
+  close() {
+    this.inputs.parent()?.close();
+  }
+
   /** Closes the menu and all parent menus. */
   closeAll() {
     const root = this.root();

src/aria/tabs/tabs.ts

@@ -112,6 +112,13 @@ export class Tabs {
       this._unorderedPanels.set(new Set(this._unorderedPanels()));
     }
   }
+
+  /** Opens the tab panel with the specified value. */
+  open(value: string) {
+    const tab = this.tabs()?.find(t => t.value() === value);
+
+    tab?.expansion.open();
+  }
 }
 
 /**
@@ -286,6 +293,11 @@ export class Tab implements HasElement, OnInit, OnDestroy {
     value: this.value,
   });
 
+  /** Opens this tab panel. */
+  open() {
+    this._pattern.expansion.open();
+  }
+
   ngOnInit() {
     this._tabList.register(this);
   }

src/components-examples/aria/menu/menu-context/menu-context-example.ts

@@ -37,7 +37,7 @@ export class MenuContextExample {
 
   open(event: MouseEvent) {
     const menu = this.menu();
-    menu?.closeAll();
+    menu?._pattern.closeAll();
 
     if (menu) {
       event.preventDefault();