Pricing

AvatarGroup changelog

  • 2026-09-21: Unified the usage guide, source property table, and Site / AI reading entry points. Documentation only; component behavior is unchanged.

v1.8.7 (2026-09-02)

  • Expanded the per-property descriptions, default fallbacks, and usage boundaries to match the existing source. Runtime behavior is unchanged.

  • AvatarGroup-Docs.2026-05-25 Archived the historical changelog at the top of the source file. Subsequent changes go in this document’s changelog; the source header retains only responsibilities, current key architecture, and the documentation path.

v1.8.6 (2026-04-25)

Fixes

  • AG-Fix.10 Fixed broken hover styling with layout="stack". Stack positioning and masks moved from child Avatar inline styles to instance-level CSS rules owned by AvatarGroup, so Frame rewriting a child Avatar’s style on hover cannot erase parent geometry.

v1.8.5 (2026-02-13)

Fixes

  • AG-Fix.8 Fixed +N count avatars differing in size from ordinary avatars. .snowui-avatar-group now sets font-size: var(--text-16) so its size chain matches Avatar children using the same --size-* scale Tokens.

  • AG-Fix.9 Changed the +N size fallback from em to rem so parent font size no longer affects the no-size case.

v1.8.1 (2026-02-13)

Fixes

  • AG-Fix.6 Corrected an erroneous Token multiplier in sizeMap, fixing AvatarGroup size drift.

Breaking changes

  • AG-Breaking.1 Removed deprecated groupSize and avatarSize completely. size now drives both.

Fixes

  • AG-Fix.4 Alignment hardening: Absolutely positioned the counter in stack mode and corrected the container baseline, fixing offsets below 48px.

  • AG-Fix.5 Resource matching: Applies Math.round() when passing size to resource children so subpixel values such as 36.36px still load a matching image resolution.

New features

  • AG-Feat.3 Made size propagation more flexible. The system accepts computed dimensions at arbitrary precision; the child Avatar adapts its rem styling automatically.

v1.7.0 (2026-02-06)

New features

  • AG-Feat.2 Added a CSS Mask based “True Cutout” border effect.

  • AG-Style.5 Size logic refactor: Unified layout under the size Prop. In stack mode, size is the container size and Avatar proportions adapt automatically.

  • AG-Style.6 Corrected the fixed angle for max=3 in stack mode.

v1.6.0 (2026-02-05)

New features

  • AG-Feat.1 Added layout, groupSize, and avatarSize for linear and circular stacked layouts.

Architecture refactor

  • AG-Refactor.1 Stack mode fixes three Avatars plus +N, with avatarSize able to enlarge groupSize.

  • AG-Refactor.2 Without avatarSize, stack mode derives the default Avatar size from groupSize * 0.6.

  • AG-Refactor.4 Default Avatar size in stack mode changed to a tiered ratio based on max.

  • AG-Refactor.5 Stack positions, angles, and layer order are fixed along a 45° diagonal.

v1.5.7 (2026-02-05)

Style improvements

  • AG-Style.4 Capped overflow counter overflowText at +99.

  • AG-Style.3 Standardized the overflow-counter background to the specified gray (#EDEDED) and updated the CSS fallback.

v1.5.6 (2026-02-05)

Architecture refactor

  • Size Context: Moved size-context logic into Frame. AvatarGroup’s size now propagates automatically through Frame to all child components (Avatar, Icon, Badge).

v1.5.4 (2026-02-03)

Style improvements

  • AG-Style.1 Changed the stacked-border thickness baseline to var(--border-2) at size 32.

v1.5.3 (2026-02-03)

Fixes

  • AG-Fix.3 Completed explicit Frame capability-switch forwarding.

v1.5.2 (2026-02-03)

Fixes

  • AG-Fix.2 Aligned internal variable names with SnowUI conventions and removed unnecessary font-weight styling.

v1.5.1 (2026-02-03)

Fixes

  • AG-Fix.1 Standardized stacked-spacing calculations for overflow and ordinary Avatars.

v1.5.0 (2026-02-03)

New features

  • AG2.1 Added size to control default dimensions of in-group Avatars. Explicit child Avatar sizes take precedence.

v1.4.3 (2026-02-03)

Fixes

  • AG1.5 Synchronized selector syntax to prevent style parsing errors and cleaned up example asset references.

v1.4.2 (2026-02-03)

Fixes

  • AG1.4 Synchronized documentation with the actual child-element marking rules.

v1.4.1 (2026-02-03)

Style improvements

  • AG1.3 Added border cutout, spacing, and overflow-avatar color rules.

v1.4.0 (2026-02-03)

New features

  • AG1.1 Added max to show overflow counts as +N.

  • AG1.2 Applied stacking rules to every direct child with a border-cutout strategy.

v1.3.1 (2026-02-03)

  • Adapted to Avatar’s new API and removed alt / fallback examples.