@ui5/webcomponents-react
Version:
React Wrapper for UI5 Web Components and additional components
54 lines (53 loc) • 2.77 kB
TypeScript
import '@ui5/webcomponents/dist/ToolbarItem.js';
import type ToolbarItemOverflowBehavior from '@ui5/webcomponents/dist/types/ToolbarItemOverflowBehavior.js';
import type { CommonProps, Ui5DomRef } from '@ui5/webcomponents-react-base';
import type { ReactNode } from 'react';
interface ToolbarItemAttributes {
/**
* Property used to define the access of the item to the overflow Popover. If "NeverOverflow" option is set,
* the item never goes in the Popover, if "AlwaysOverflow" - it never comes out of it.
* @default "Default"
*/
overflowPriority?: ToolbarItemOverflowBehavior | keyof typeof ToolbarItemOverflowBehavior;
/**
* Defines if the toolbar overflow popup should close upon interaction with the item.
* It will close by default.
* @default false
*/
preventOverflowClosing?: boolean;
}
interface ToolbarItemDomRef extends Required<ToolbarItemAttributes>, Ui5DomRef {
}
interface ToolbarItemPropTypes extends ToolbarItemAttributes, Omit<CommonProps, keyof ToolbarItemAttributes | 'children'> {
/**
* Wrapped component slot.
*
* **Note:** Available since [v2.20.0](https://github.com/UI5/webcomponents/releases/tag/v2.20.0) of **@ui5/webcomponents**.
*
* __Supported Node Type/s:__ `Array<IToolbarItemContent>`
*/
children?: ReactNode | ReactNode[];
}
/**
* The `ToolbarItem` is a wrapper component used to integrate UI5 Web Components into the `Toolbar`.
* It renders within the toolbar's shadow DOM and manages the lifecycle
* and overflow behavior of its child component.
*
* ### Structure
* The toolbar item wraps a single UI5 Web Component (such as CheckBox, Title, etc.) and handles:
* - Overflow management (determining if the item should be displayed in the main toolbar or overflow popover)
* - Automatic popover closing on interaction
* - CSS custom state exposure for styling based on overflow state
*
* ### Usage
* The `ToolbarItem` is typically used implicitly when adding components to a toolbar,
* but specialized wrappers like `ToolbarButton` provide
* component-specific functionality and should be preferred when available.
*
* __Note:__ This is a UI5 Web Component! [ToolbarItem UI5 Web Component Documentation](https://ui5.github.io/webcomponents/components/ToolbarItem) | [Repository](https://github.com/UI5/webcomponents)
*
* @since [2.20.0](https://github.com/UI5/webcomponents/releases/tag/v2.20.0) of __@ui5/webcomponents__.
*/
declare const ToolbarItem: import("react").ForwardRefExoticComponent<ToolbarItemPropTypes & import("@ui5/webcomponents-react-base").WithWebComponentPropTypes & import("react").RefAttributes<ToolbarItemDomRef>>;
export { ToolbarItem };
export type { ToolbarItemDomRef, ToolbarItemPropTypes };