Skip to content
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"type": "patch",
"comment": "chore: Remove AvatarGroup unstable warnings.",
"packageName": "@fluentui/react-avatar",
"email": "[email protected]",
"dependentChangeType": "patch"
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"type": "minor",
"comment": "feat: Move AvatarGroup to stable.",
"packageName": "@fluentui/react-components",
"email": "[email protected]",
"dependentChangeType": "patch"
}
10 changes: 0 additions & 10 deletions packages/react-components/react-avatar/README-AvatarGroup.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,20 +4,10 @@

The AvatarGroup component represents a group of multiple people or entities by taking care of the arrangement of individual Avatars in a spread, stack, or pie layout.

## STATUS: WIP 🚧

These are not production-ready components and **should never be used in product**. This space is useful for testing new components whose APIs might change before final release.

## Usage

To import AvatarGroup, AvatarGroupItem, AvatarGroupPopover, and partitionAvatarGroupItems:

```js
import { AvatarGroup, AvatarGroupItem, AvatarGroupPopover, partitionAvatarGroupItems } from '@fluentui/react-avatar';
```

Once the AvatarGroup component graduates to a production release, the component will be available at:

```js
import {
AvatarGroup,
Expand Down
4 changes: 2 additions & 2 deletions packages/react-components/react-avatar/src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -40,9 +40,9 @@ export {
} from './AvatarGroupPopover';
export type { AvatarGroupPopoverProps, AvatarGroupPopoverSlots, AvatarGroupPopoverState } from './AvatarGroupPopover';
export {
AvatarGroupProvider,
useAvatarGroupContext_unstable,
AvatarContextProvider,
AvatarGroupProvider,
useAvatarContext,
useAvatarGroupContext_unstable,
} from './contexts/index';
export type { AvatarContextValue } from './contexts/index';
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const Active = () => (
<div style={{ display: 'flex', gap: '20px' }}>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const ActiveAppearance = () => (
<div style={{ display: 'flex', gap: '20px' }}>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const Badge = () => (
<>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const ColorBrand = () => <Avatar color="brand" initials="BR" name="brand color avatar" />;

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';
import { GuestRegular } from '@fluentui/react-icons';

export const ColorColorful = () => (
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const ColorPalette = () => (
<>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
import { ArgTypes } from '@storybook/api';
import * as React from 'react';
import { Avatar, AvatarProps } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';
import type { AvatarProps } from '@fluentui/react-components';

export const Default = (props: Partial<AvatarProps>) => <Avatar aria-label="Guest" {...props} />;

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import {
PersonCallRegular,
} from '@fluentui/react-icons';

import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const Icon = () => (
<>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const Image = () => (
<Avatar
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const Initials = () => <Avatar name="Cecil Robin Folk" initials="CRF" />;

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const Name = () => <Avatar name="Ashley McCarthy" />;

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';

export const Size = () => (
<>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';
import { PeopleTeamRegular } from '@fluentui/react-icons';

export const Square = () => <Avatar shape="square" aria-label="square avatar" icon={<PeopleTeamRegular />} />;
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import * as React from 'react';
import { Avatar } from '@fluentui/react-avatar';
import { Avatar } from '@fluentui/react-components';
import { Meta } from '@storybook/react';

export { Default } from './AvatarDefault.stories';
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
import * as React from 'react';
import { AvatarGroup, AvatarGroupItem, AvatarGroupPopover, partitionAvatarGroupItems } from '@fluentui/react-avatar';
import type { AvatarGroupProps } from '@fluentui/react-avatar';
import {
AvatarGroup,
AvatarGroupItem,
AvatarGroupPopover,
partitionAvatarGroupItems,
} from '@fluentui/react-components';
import type { AvatarGroupProps } from '@fluentui/react-components';

const names = [
'Johnie McConnell',
Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,2 @@
An AvatarGroup is a graphical representation of multiple people associated with a given entity. AvatarGroup leverages the Avatar component, with each Avatar representing a person and containing their image, initials, or an icon. An AvatarGroup can be represented
in a spread, stack, or pie layout.

<!-- Don't allow prettier to collapse code block into single line -->
<!-- prettier-ignore -->
> **⚠️ Preview components are considered unstable:**
>
> ```jsx
>
> import { AvatarGroup, AvatarGroupItem, AvatarGroupPopover } from '@fluentui/react-components/unstable';
>
> ```
>
> - Features and APIs may change before final release
> - Please contact us if you intend to use this in your product
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
import * as React from 'react';
import { AvatarGroup, AvatarGroupItem, AvatarGroupPopover, partitionAvatarGroupItems } from '@fluentui/react-avatar';
import { makeStyles } from '@fluentui/react-components';
import {
AvatarGroup,
AvatarGroupItem,
AvatarGroupPopover,
makeStyles,
partitionAvatarGroupItems,
} from '@fluentui/react-components';

const useStyles = makeStyles({
root: {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
import * as React from 'react';
import { AvatarGroup, AvatarGroupItem, AvatarGroupPopover, partitionAvatarGroupItems } from '@fluentui/react-avatar';
import { makeStyles } from '@fluentui/react-components';
import {
AvatarGroup,
AvatarGroupItem,
AvatarGroupPopover,
makeStyles,
partitionAvatarGroupItems,
} from '@fluentui/react-components';

const useStyles = makeStyles({
root: {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,12 @@
import * as React from 'react';
import { AvatarGroup, AvatarGroupItem, AvatarGroupPopover, partitionAvatarGroupItems } from '@fluentui/react-avatar';
import { makeStyles } from '@fluentui/react-components';
import type { AvatarSizes } from '@fluentui/react-avatar';
import {
AvatarGroup,
AvatarGroupItem,
AvatarGroupPopover,
makeStyles,
partitionAvatarGroupItems,
} from '@fluentui/react-components';
import type { AvatarSizes } from '@fluentui/react-components';

const useStyles = makeStyles({
root: {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,12 @@
import * as React from 'react';
import { AvatarGroup, AvatarGroupItem, AvatarGroupPopover, partitionAvatarGroupItems } from '@fluentui/react-avatar';
import { makeStyles } from '@fluentui/react-components';
import type { AvatarSizes } from '@fluentui/react-avatar';
import {
AvatarGroup,
AvatarGroupItem,
AvatarGroupPopover,
makeStyles,
partitionAvatarGroupItems,
} from '@fluentui/react-components';
import type { AvatarSizes } from '@fluentui/react-components';

const useStyles = makeStyles({
root: {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,12 @@
import * as React from 'react';
import { AvatarGroup, AvatarGroupItem, AvatarGroupPopover, partitionAvatarGroupItems } from '@fluentui/react-avatar';
import { makeStyles } from '@fluentui/react-components';
import type { AvatarSizes } from '@fluentui/react-avatar';
import {
AvatarGroup,
AvatarGroupItem,
AvatarGroupPopover,
makeStyles,
partitionAvatarGroupItems,
} from '@fluentui/react-components';
import type { AvatarSizes } from '@fluentui/react-components';

const useStyles = makeStyles({
root: {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
import { AvatarGroup } from '@fluentui/react-avatar';
import { AvatarGroup } from '@fluentui/react-components';

import bestPracticesMd from './AvatarGroupBestPractices.md';
import descriptionMd from './AvatarGroupDescription.md';
Expand All @@ -11,7 +11,7 @@ export { SizeStack } from './AvatarGroupSizeStack.stories';
export { SizePie } from './AvatarGroupSizePie.stories';

export default {
title: 'Preview Components/AvatarGroup',
title: 'Components/AvatarGroup',
component: AvatarGroup,
parameters: {
docs: {
Expand Down
Loading