`. Spread `props` onto the host element. |
| Attribute | Description |
| ------------------ | ------------------------------------------- |
| `data-orientation` | Indicates the orientation of the separator. |
## useFilter
When filtering items yourself, `Menu.useFilter` matches text according to the user's locale.
**Parameters:**
| Parameter | Type | Default | Description |
| --------- | --------------------- | ------- | ----------- |
| options? | `GetFilterParameters` | `{}` | - |
**Return Value:**
```ts
type ReturnValue = Filter;
```
`GetFilterParameters` takes a `locale` and any `Intl.CollatorOptions`. `Filter` has three functions, each of the form `(item, query, itemToString?) => boolean`.
```ts
type Filter = {
/** Returns whether the item matches the query anywhere. */
contains:
- (item: Item, query: string, itemToString?: (item: Item) => string) => boolean;
/** Returns whether the item starts with the query. */
startsWith:
- (item: Item, query: string, itemToString?: (item: Item) => string) => boolean;
/** Returns whether the item ends with the query. */
endsWith:
- (item: Item, query: string, itemToString?: (item: Item) => string) => boolean;
};
```
## createHandle
Creates a new handle to connect a `Menu.Root` with detached `Menu.Trigger` components.
**Return Value:**
```ts
type ReturnValue = Menu.Handle;
```
### Handle
Controls a Menu imperatively and associates detached `Menu.Trigger` components with a `Menu.Root`.
Create one with `Menu.createHandle()` and pass it to the `handle` prop of the root and of any triggers rendered outside of it.
The imperative methods take effect only while a root using this handle is mounted. Calls made before a root attaches (or after it unmounts) are ignored.
**Properties:**
| Property | Type | Modifiers | Description |
| -------- | ---------------------- | --------- | -------------------------------------------------------------------------------------------- |
| isOpen | `boolean` | readonly | Whether the menu is currently open. Returns `false` while no root is attached to the handle. |
| payload | `Payload \| undefined` | readonly | The payload of the trigger that owns the menu. |
**Methods:**
```ts
function open(triggerId: string): void;
```
Opens the menu and associates it with the trigger with the given id.
This method should only be called in an event handler or an effect (not during rendering).
```ts
function close(): void;
```
Closes the menu.
This method should only be called in an event handler or an effect (not during rendering).
```ts
function unmount(): void;
```
Ends the closing phase of the menu after an externally controlled closing animation finishes.