Files
upstream-mirror e7da97194a
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s
snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
2026-09-17 23:28:13 +05:00

675 lines
27 KiB
Plaintext

{/*
* _____ _
*|_ _|_ _____ _ __ | |_ _ _
* | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file
* | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten
* |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs
* |___/
*
* This file is generated from the documentation data in packages/twenty-ui/generated.
* To update it, edit the component prop types or design tokens in twenty-ui and run:
* npx nx generate:ui twenty-docs
*/}
### Menu.Root
<ParamField body="Root.actionsRef" type="RefObject&lt;MenuRootActions | null&gt;">
A ref to imperative actions.
- `unmount`: Manually unmounts the menu.
Call this after any externally controlled closing animation finishes.
- `close`: When specified, the menu can be closed imperatively.
</ParamField>
<ParamField body="Root.children" type="ReactNode | PayloadChildRenderFunction&lt;Payload&gt;">
The content of the menu.
This can be a regular React node or a render function that receives the `payload` of the active trigger.
</ParamField>
<ParamField body="Root.closeParentOnEsc" type="boolean" default="false">
When in a submenu, determines whether pressing the Escape key
closes the entire menu, or only the current child menu.
</ParamField>
<ParamField body="Root.defaultOpen" type="boolean" default="false">
Whether the menu is initially open.
To render a controlled menu, use the `open` prop instead.
</ParamField>
<ParamField body="Root.defaultTriggerId" type="string | null">
ID of the trigger that the menu is associated with.
This is useful in conjunction with the `defaultOpen` prop to create an initially open menu.
</ParamField>
<ParamField body="Root.disabled" type="boolean" default="false">
Whether the component should ignore user interaction.
</ParamField>
<ParamField body="Root.handle" type="MenuHandle&lt;Payload&gt;">
A handle to associate the menu with a trigger.
If specified, allows external triggers to control the menu's open state.
</ParamField>
<ParamField body="Root.highlightItemOnHover" type="boolean" default="true">
Whether moving the pointer over items should highlight them.
Disabling this prop allows CSS `:hover` to be differentiated from the `:focus` (`data-highlighted`) state.
</ParamField>
<ParamField body="Root.loopFocus" type="boolean" default="true">
Whether to loop keyboard focus back to the first item
when the end of the list is reached while using the arrow keys.
</ParamField>
<ParamField body="Root.modal" type="boolean" default="true">
Determines if the menu enters a modal state when open.
- `true`: user interaction is limited to the menu: document page scroll is locked and pointer interactions on outside elements are disabled.
- `false`: user interaction with the rest of the document is allowed.
On touch devices, a `true` modal blocks outside taps but leaves the page scrollable unless the popup spans nearly the full viewport width, matching native iOS behavior.
Nested menus ignore this prop, and menus opened by hover are never modal.
</ParamField>
<ParamField body="Root.onOpenChange" type="((open: boolean, eventDetails: MenuRootChangeEventDetails) =&gt; void)">
Event handler called when the menu is opened or closed.
</ParamField>
<ParamField body="Root.onOpenChangeComplete" type="((open: boolean) =&gt; void)">
Event handler called after any animations complete when the menu is opened or closed.
</ParamField>
<ParamField body="Root.open" type="boolean">
Whether the menu is currently open.
</ParamField>
<ParamField body="Root.orientation" type="&quot;horizontal&quot; | &quot;vertical&quot;" default="vertical">
The visual orientation of the menu.
Controls whether roving focus uses up/down or left/right arrow keys.
</ParamField>
<ParamField body="Root.triggerId" type="string | null">
ID of the trigger that the menu is associated with.
This is useful in conjunction with the `open` prop to create a controlled menu.
There's no need to specify this prop when the menu is uncontrolled (that is, when the `open` prop is not set).
</ParamField>
### Menu.Trigger
<ParamField body="Trigger.className" type="string | ((state: MenuTriggerState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="Trigger.closeDelay" type="number" default="0">
How long to wait before closing the menu that was opened on hover.
Specified in milliseconds.
Requires the `openOnHover` prop.
</ParamField>
<ParamField body="Trigger.delay" type="number" default="100">
How long to wait before the menu may be opened on hover. Specified in milliseconds.
Requires the `openOnHover` prop.
</ParamField>
<ParamField body="Trigger.disabled" type="boolean" default="false">
Whether the component should ignore user interaction.
</ParamField>
<ParamField body="Trigger.handle" type="MenuHandle&lt;Payload&gt;">
A handle to associate the trigger with a menu.
</ParamField>
<ParamField body="Trigger.nativeButton" type="boolean" default="true">
Whether the component renders a native `<button>` element when replacing it
via the `render` prop.
Set to `false` if the rendered element is not a button (for example, `<div>`).
</ParamField>
<ParamField body="Trigger.openOnHover" type="boolean">
Whether the menu should also open when the trigger is hovered.
</ParamField>
<ParamField body="Trigger.payload" type="Payload">
A payload to pass to the menu when it is opened.
</ParamField>
<ParamField body="Trigger.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuTriggerState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="Trigger.style" type="CSSProperties | ((state: MenuTriggerState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
### Menu.Popup
<ParamField body="Popup.align" type="&quot;center&quot; | &quot;start&quot; | &quot;end&quot;">
Alignment of the popup along the anchor. Defaults to `start`.
</ParamField>
<ParamField body="Popup.alignOffset" type="number">
Offset in pixels along the alignment axis. Defaults to `0` for a menu and
`-4` for a submenu.
</ParamField>
<ParamField body="Popup.anchor" type="Element | VirtualElement | RefObject&lt;Element | null&gt; | (() =&gt; Element | VirtualElement | null) | null">
Element or position the popup is anchored to. Defaults to the trigger.
</ParamField>
<ParamField body="Popup.className" type="string | ((state: MenuPopupState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="Popup.container" type="HTMLElement | ShadowRoot | RefObject&lt;HTMLElement | ShadowRoot | null&gt; | null">
Element the popup is portaled into. Defaults to the theme's portal
container.
</ParamField>
<ParamField body="Popup.finalFocus" type="boolean | RefObject&lt;HTMLElement | null&gt; | ((closeType: InteractionType) =&gt; boolean | void | HTMLElement | null)">
Determines the element to focus when the menu is closed.
- `false`: Do not move focus.
- `true`: Move focus based on the default behavior (trigger or previously focused element).
- `RefObject`: Move focus to the ref element.
- `function`: Called with the interaction type (`mouse`, `touch`, `pen`, or `keyboard`).
Return an element to focus, `true` to use the default behavior, or `false`/`undefined` to do nothing.
</ParamField>
<ParamField body="Popup.keepMounted" type="boolean">
Keeps the popup mounted in the DOM while the menu is closed.
</ParamField>
<ParamField body="Popup.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuPopupState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="Popup.side" type="&quot;top&quot; | &quot;right&quot; | &quot;bottom&quot; | &quot;left&quot; | &quot;inline-end&quot; | &quot;inline-start&quot;">
Side of the anchor the popup is placed on. Defaults to `bottom` for a menu
and `inline-end` for a submenu.
</ParamField>
<ParamField body="Popup.sideOffset" type="number">
Distance in pixels between the anchor and the popup. Defaults to `8` for a
menu and `0` for a submenu.
</ParamField>
<ParamField body="Popup.style" type="CSSProperties | ((state: MenuPopupState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
### Menu.Item
<ParamField body="Item.className" type="string | ((state: MenuItemState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="Item.closeOnClick" type="boolean" default="true">
Whether to close the menu when the item is clicked.
</ParamField>
<ParamField body="Item.color" type="&quot;neutral&quot; | &quot;danger&quot;">
Color of the text and icons. `danger` marks a destructive action.
</ParamField>
<ParamField body="Item.description" type="ReactNode">
Supporting text, placed according to `descriptionPlacement`.
</ParamField>
<ParamField body="Item.descriptionPlacement" type="&quot;inline&quot; | &quot;end&quot;">
Where the description renders: inline after the content or at the end of
the row.
</ParamField>
<ParamField body="Item.disabled" type="boolean" default="false">
Whether the component should ignore user interaction.
</ParamField>
<ParamField body="Item.endIcon" type="ReactNode">
Icon rendered after the content.
</ParamField>
<ParamField body="Item.hotkeys" type="string[]">
Keyboard shortcut keys displayed at the end of the row. Registering the
shortcut is up to the application.
</ParamField>
<ParamField body="Item.label" type="string">
Overrides the text label to use when the item is matched during keyboard text navigation.
</ParamField>
<ParamField body="Item.nativeButton" type="boolean" default="false">
Whether the component renders a native `<button>` element when replacing it
via the `render` prop.
Set to `true` if the rendered element is a native button.
</ParamField>
<ParamField body="Item.onClick" type="((event: BaseUIEvent&lt;MouseEvent&lt;HTMLDivElement, MouseEvent&gt;&gt;) =&gt; void)">
The click handler for the menu item.
</ParamField>
<ParamField body="Item.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuItemState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="Item.startIcon" type="ReactNode">
Icon rendered before the content.
</ParamField>
<ParamField body="Item.style" type="CSSProperties | ((state: MenuItemState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
### Menu.CheckboxItem
<ParamField body="CheckboxItem.checked" type="boolean">
Whether the checkbox item is currently ticked.
To render an uncontrolled checkbox item, use the `defaultChecked` prop instead.
</ParamField>
<ParamField body="CheckboxItem.className" type="string | ((state: MenuCheckboxItemState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="CheckboxItem.closeOnClick" type="boolean" default="false">
Whether to close the menu when the item is clicked.
</ParamField>
<ParamField body="CheckboxItem.color" type="&quot;neutral&quot; | &quot;danger&quot;">
Color of the text and icons. `danger` marks a destructive action.
</ParamField>
<ParamField body="CheckboxItem.defaultChecked" type="boolean" default="false">
Whether the checkbox item is initially ticked.
To render a controlled checkbox item, use the `checked` prop instead.
</ParamField>
<ParamField body="CheckboxItem.description" type="ReactNode">
Supporting text, placed according to `descriptionPlacement`.
</ParamField>
<ParamField body="CheckboxItem.descriptionPlacement" type="&quot;inline&quot; | &quot;end&quot;">
Where the description renders: inline after the content or at the end of
the row.
</ParamField>
<ParamField body="CheckboxItem.disabled" type="boolean" default="false">
Whether the component should ignore user interaction.
</ParamField>
<ParamField body="CheckboxItem.endIcon" type="ReactNode">
Icon rendered after the content.
</ParamField>
<ParamField body="CheckboxItem.hotkeys" type="string[]">
Keyboard shortcut keys displayed at the end of the row. Registering the
shortcut is up to the application.
</ParamField>
<ParamField body="CheckboxItem.label" type="string">
Overrides the text label to use when the item is matched during keyboard text navigation.
</ParamField>
<ParamField body="CheckboxItem.nativeButton" type="boolean" default="false">
Whether the component renders a native `<button>` element when replacing it
via the `render` prop.
Set to `true` if the rendered element is a native button.
</ParamField>
<ParamField body="CheckboxItem.onCheckedChange" type="((checked: boolean, eventDetails: MenuRootChangeEventDetails) =&gt; void)">
Event handler called when the checkbox item is ticked or unticked.
</ParamField>
<ParamField body="CheckboxItem.onClick" type="((event: BaseUIEvent&lt;MouseEvent&lt;HTMLDivElement, MouseEvent&gt;&gt;) =&gt; void)">
The click handler for the menu item.
</ParamField>
<ParamField body="CheckboxItem.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuCheckboxItemState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="CheckboxItem.startIcon" type="ReactNode">
Icon rendered before the content.
</ParamField>
<ParamField body="CheckboxItem.style" type="CSSProperties | ((state: MenuCheckboxItemState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
### Menu.RadioGroup
<ParamField body="RadioGroup.children" type="ReactNode">
The content of the component.
</ParamField>
<ParamField body="RadioGroup.className" type="string | ((state: MenuRadioGroupState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="RadioGroup.defaultValue" type="any">
The uncontrolled value of the radio item that should be initially selected.
To render a controlled radio group, use the `value` prop instead.
</ParamField>
<ParamField body="RadioGroup.disabled" type="boolean" default="false">
Whether the component should ignore user interaction.
</ParamField>
<ParamField body="RadioGroup.onValueChange" type="((value: any, eventDetails: MenuRootChangeEventDetails) =&gt; void)">
Function called when the selected value changes.
</ParamField>
<ParamField body="RadioGroup.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuRadioGroupState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="RadioGroup.style" type="CSSProperties | ((state: MenuRadioGroupState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
<ParamField body="RadioGroup.value" type="any">
The controlled value of the radio item that should be currently selected.
To render an uncontrolled radio group, use the `defaultValue` prop instead.
</ParamField>
### Menu.RadioItem
<ParamField body="RadioItem.className" type="string | ((state: MenuRadioItemState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="RadioItem.closeOnClick" type="boolean" default="false">
Whether to close the menu when the item is clicked.
</ParamField>
<ParamField body="RadioItem.color" type="&quot;neutral&quot; | &quot;danger&quot;">
Color of the text and icons. `danger` marks a destructive action.
</ParamField>
<ParamField body="RadioItem.description" type="ReactNode">
Supporting text, placed according to `descriptionPlacement`.
</ParamField>
<ParamField body="RadioItem.descriptionPlacement" type="&quot;inline&quot; | &quot;end&quot;">
Where the description renders: inline after the content or at the end of
the row.
</ParamField>
<ParamField body="RadioItem.disabled" type="boolean" default="false">
Whether the component should ignore user interaction.
</ParamField>
<ParamField body="RadioItem.endIcon" type="ReactNode">
Icon rendered after the content.
</ParamField>
<ParamField body="RadioItem.hotkeys" type="string[]">
Keyboard shortcut keys displayed at the end of the row. Registering the
shortcut is up to the application.
</ParamField>
<ParamField body="RadioItem.label" type="string">
Overrides the text label to use when the item is matched during keyboard text navigation.
</ParamField>
<ParamField body="RadioItem.nativeButton" type="boolean" default="false">
Whether the component renders a native `<button>` element when replacing it
via the `render` prop.
Set to `true` if the rendered element is a native button.
</ParamField>
<ParamField body="RadioItem.onClick" type="((event: BaseUIEvent&lt;MouseEvent&lt;HTMLDivElement, MouseEvent&gt;&gt;) =&gt; void)">
The click handler for the menu item.
</ParamField>
<ParamField body="RadioItem.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuRadioItemState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="RadioItem.startIcon" type="ReactNode">
Icon rendered before the content.
</ParamField>
<ParamField body="RadioItem.style" type="CSSProperties | ((state: MenuRadioItemState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
<ParamField body="RadioItem.value" type="any" required>
Value of the radio item.
This is the value that will be set in the MenuRadioGroup when the item is selected.
</ParamField>
### Menu.Group
<ParamField body="Group.children" type="ReactNode">
The content of the component.
</ParamField>
<ParamField body="Group.className" type="string | ((state: MenuGroupState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="Group.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuGroupState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="Group.style" type="CSSProperties | ((state: MenuGroupState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
### Menu.GroupLabel
<ParamField body="GroupLabel.className" type="string | ((state: MenuGroupLabelState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="GroupLabel.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuGroupLabelState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="GroupLabel.style" type="CSSProperties | ((state: MenuGroupLabelState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
### Menu.Separator
<ParamField body="Separator.className" type="string | ((state: SeparatorState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="Separator.orientation" type="&quot;horizontal&quot; | &quot;vertical&quot;" default="horizontal">
The orientation of the separator.
</ParamField>
<ParamField body="Separator.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, SeparatorState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="Separator.style" type="CSSProperties | ((state: SeparatorState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>
### Menu.SubmenuRoot
<ParamField body="SubmenuRoot.actionsRef" type="RefObject&lt;MenuRootActions | null&gt;">
A ref to imperative actions.
- `unmount`: Manually unmounts the menu.
Call this after any externally controlled closing animation finishes.
- `close`: When specified, the menu can be closed imperatively.
</ParamField>
<ParamField body="SubmenuRoot.children" type="ReactNode">
The content of the submenu.
</ParamField>
<ParamField body="SubmenuRoot.closeParentOnEsc" type="boolean" default="false">
When in a submenu, determines whether pressing the Escape key
closes the entire menu, or only the current child menu.
</ParamField>
<ParamField body="SubmenuRoot.defaultOpen" type="boolean" default="false">
Whether the menu is initially open.
To render a controlled menu, use the `open` prop instead.
</ParamField>
<ParamField body="SubmenuRoot.disabled" type="boolean" default="false">
Whether the component should ignore user interaction.
</ParamField>
<ParamField body="SubmenuRoot.highlightItemOnHover" type="boolean" default="true">
Whether moving the pointer over items should highlight them.
Disabling this prop allows CSS `:hover` to be differentiated from the `:focus` (`data-highlighted`) state.
</ParamField>
<ParamField body="SubmenuRoot.loopFocus" type="boolean" default="true">
Whether to loop keyboard focus back to the first item
when the end of the list is reached while using the arrow keys.
</ParamField>
<ParamField body="SubmenuRoot.onOpenChange" type="((open: boolean, eventDetails: MenuRootChangeEventDetails) =&gt; void)">
Event handler called when the menu is opened or closed.
</ParamField>
<ParamField body="SubmenuRoot.onOpenChangeComplete" type="((open: boolean) =&gt; void)">
Event handler called after any animations complete when the menu is opened or closed.
</ParamField>
<ParamField body="SubmenuRoot.open" type="boolean">
Whether the menu is currently open.
</ParamField>
<ParamField body="SubmenuRoot.orientation" type="&quot;horizontal&quot; | &quot;vertical&quot;" default="vertical">
The visual orientation of the menu.
Controls whether roving focus uses up/down or left/right arrow keys.
</ParamField>
### Menu.SubmenuTrigger
<ParamField body="SubmenuTrigger.className" type="string | ((state: MenuSubmenuTriggerState) =&gt; string | undefined)">
CSS class applied to the element, or a function that
returns a class based on the component's state.
</ParamField>
<ParamField body="SubmenuTrigger.closeDelay" type="number" default="0">
How long to wait before closing the menu that was opened on hover.
Specified in milliseconds.
Requires the `openOnHover` prop.
</ParamField>
<ParamField body="SubmenuTrigger.color" type="&quot;neutral&quot; | &quot;danger&quot;">
Color of the text and icons. `danger` marks a destructive action.
</ParamField>
<ParamField body="SubmenuTrigger.delay" type="number" default="100">
How long to wait before the menu may be opened on hover. Specified in milliseconds.
Requires the `openOnHover` prop.
</ParamField>
<ParamField body="SubmenuTrigger.description" type="ReactNode">
Supporting text, placed according to `descriptionPlacement`.
</ParamField>
<ParamField body="SubmenuTrigger.descriptionPlacement" type="&quot;inline&quot; | &quot;end&quot;">
Where the description renders: inline after the content or at the end of
the row.
</ParamField>
<ParamField body="SubmenuTrigger.disabled" type="boolean" default="false">
Whether the component should ignore user interaction.
</ParamField>
<ParamField body="SubmenuTrigger.endIcon" type="ReactNode">
Icon rendered after the content.
</ParamField>
<ParamField body="SubmenuTrigger.hotkeys" type="string[]">
Keyboard shortcut keys displayed at the end of the row. Registering the
shortcut is up to the application.
</ParamField>
<ParamField body="SubmenuTrigger.label" type="string">
Overrides the text label to use when the item is matched during keyboard text navigation.
</ParamField>
<ParamField body="SubmenuTrigger.nativeButton" type="boolean" default="false">
Whether the component renders a native `<button>` element when replacing it
via the `render` prop.
Set to `true` if the rendered element is a native button.
</ParamField>
<ParamField body="SubmenuTrigger.onClick" type="((event: BaseUIEvent&lt;MouseEvent&lt;HTMLDivElement, MouseEvent&gt;&gt;) =&gt; void)">
</ParamField>
<ParamField body="SubmenuTrigger.openOnHover" type="boolean" default="true">
Whether the menu should also open when the trigger is hovered.
</ParamField>
<ParamField body="SubmenuTrigger.render" type="ReactElement&lt;unknown, string | JSXElementConstructor&lt;any&gt;&gt; | ComponentRenderFn&lt;HTMLProps, MenuSubmenuTriggerState&gt;">
Allows you to replace the component's HTML element
with a different tag, or compose it with another component.
Accepts a `ReactElement` or a function that returns the element to render.
</ParamField>
<ParamField body="SubmenuTrigger.startIcon" type="ReactNode">
Icon rendered before the content.
</ParamField>
<ParamField body="SubmenuTrigger.style" type="CSSProperties | ((state: MenuSubmenuTriggerState) =&gt; CSSProperties | undefined)">
Style applied to the element, or a function that
returns a style object based on the component's state.
</ParamField>