Platforms Impacted

• iOS
• visionOS
• macOS

Description of changes

Adding a new API for Avatar and AvatarGroup that optionally renders an outline around the Avatar instances with the Fluent background color.

This is the same color (and the same logic) that is used when drawing a ring around the Avatar. Useful for when the control is being rendered atop a dark or complicated background, such as a photo.

As an addendum, this change also brings formal deprecation to the isTransparent property of Avatar. This is from a very old version of the Fluent spec, and should not be used anymore. The default value has been changed to false, and will be fully removed in a future version of Fluent.

Binary change

Total increase: 31,000 bytes
Total decrease: 0 bytes

Verification

Verified enabling and disabling the value in both UIKit and SwiftUI.

Visual Verification

UIKit	SwiftUI

Pull request checklist

This PR has considered:

• Light and Dark appearances
• iOS supported versions (all major versions greater than or equal current target deployment version)
• VoiceOver and Keyboard Accessibility
• Internationalization and Right to Left layouts
• Different resolutions (1x, 2x, 3x)
• Size classes and window sizes (iPhone vs iPad, notched devices, multitasking, different window sizes, etc)
• iPad Pointer interaction
• SwiftUI consumption (validation or new demo scenarios needed)
• Objective-C exposure (provide it only if needed)

Microsoft Reviewers: Open in CodeFlow