UNPKG

@ui5/webcomponents-react

Version:

React Wrapper for UI5 Web Components and additional components

62 lines (61 loc) 2.45 kB
'use client'; import '@ui5/webcomponents/dist/AvatarGroup.js'; import { withWebComponent } from '../../internal/withWebComponent.js'; /** * Displays a group of avatars arranged horizontally. It is useful to visually * showcase a group of related avatars, such as, project team members or employees. * * The component allows you to display the avatars in different sizes, * depending on your use case. * * The `AvatarGroup` component has two group types: * * - `Group` type: The avatars are displayed as partially overlapped on * top of each other and the entire group has one click/tap area. * - `Individual` type: The avatars are displayed side-by-side and each * avatar has its own click/tap area. * * ### Usage * * Use the `AvatarGroup` if: * * - You want to display a group of avatars. * - You want to display several avatars which have something in common. * * Do not use the `AvatarGroup` if: * * - You want to display a single avatar. * - You want to display a gallery for simple images. * - You want to use it for other visual content than avatars. * * ### Responsive Behavior * * When the available space is less than the width required to display all avatars, * an overflow visualization appears as a button placed at the end with the same shape * and size as the avatars. The visualization displays the number of avatars that have overflowed * and are not currently visible. * * ### Keyboard Handling * The component provides advanced keyboard handling. * When focused, the user can use the following keyboard * shortcuts in order to perform a navigation: * * `type` Individual: * * - [Tab] - Move focus to the overflow button * - [Left] - Navigate one avatar to the left * - [Right] - Navigate one avatar to the right * - [Home] - Navigate to the first avatar * - [End] - Navigate to the last avatar * - [Space] / [Enter] or [Return] - Trigger `ui5-click` event * * `type` Group: * * - [Tab] - Move focus to the next interactive element after the component * - [Space] / [Enter] or [Return] - Trigger `ui5-click` event * * __Note__: This is a UI5 Web Component! [Repository](https://github.com/SAP/ui5-webcomponents) | [Documentation](https://sap.github.io/ui5-webcomponents/) */ const AvatarGroup = withWebComponent('ui5-avatar-group', ['accessibilityAttributes', 'type'], [], ['overflowButton'], ['click', 'overflow']); AvatarGroup.displayName = 'AvatarGroup'; export { AvatarGroup };