Animated images

Category: API Collection

Overview

Pause animations in animated images in your app when people turn off the Animated Images setting.

Details

Topics

• Animated images
• static var animatedImagesEnabled: Bool
• static var animatedImagesEnabledDidChangeNotification: Notification.Name

See Also

• Supporting vision accessibility features
• API ReferenceVoiceOver
• Flashing lights
• API ReferenceAudio graphs
• API ReferenceBraille displays
• API ReferenceHorizontal text

• WWDC21 Challenge: Large Text Challenge

• Accessibility

• Vision
• Animated images

Overview

People use the Animated Images setting to control whether to play animated images like GIFs on the web and in apps. By default, the setting is on, which allows animated images to play automatically. A person can turn off the setting to indicate that they want to pause animated images on their device.

In your app, handle changes to the Animated Images setting to create an enjoyable experience for people who choose to pause animated images. Register for the notification animatedImagesEnabledDidChangeNotification to respond to changes in this setting:

import Accessibility

NotificationCenter.default.addObserver(self,
    selector: #selector(animatedImagesChanged),
    name: NSNotification.Name.animatedImagesEnabledDidChangeNotification,
    object: nil)

When the Animated Images setting changes, perform changes to your UI to pause animated images:

@objc 
func animatedImagesChanged(_ notification: Notification) {
    if AccessibilitySettings.animatedImagesEnabled {
        // The setting is on. Animate images.
    } else {
        // The setting is off. Pause animations in animated images.
}

Check the value of the Animated Images setting at any time by using animatedImagesEnabled .

Topics (Grouped)

• varanimatedImagesEnabled:Bool — static; A Boolean value that indicates whether the system setting for playing animated images is on.
• varanimatedImagesEnabledDidChangeNotification:Notification.Name — static; A notification that posts when the system setting for playing animated images changes.

Supporting vision accessibility features

• VoiceOver — API Reference; A gesture-based screen reader that provides an auditory description of the content onscreen.
• Flashing lights — Article; Detect, mitigate, and inform people about flashing lights in media content.
• Audio graphs — API Reference; Define an accessible representation of your chart for VoiceOver to generate an audio graph.
• Braille displays — API Reference; Display a graphical representation of images, icons, data, and more on a two-dimensional braille display.
• Horizontal text — API Reference; Lay out vertical text horizontally in your app when people turn on the Prefer Horizontal Text setting.
• WWDC21 Challenge: Large Text Challenge — Sample Code; Design for large text sizes by modifying the user interface.

Code Examples

import Accessibility


NotificationCenter.default.addObserver(self,
    selector: #selector(animatedImagesChanged),
    name: NSNotification.Name.animatedImagesEnabledDidChangeNotification,
    object: nil)

@objc 
func animatedImagesChanged(_ notification: Notification) {
    if AccessibilitySettings.animatedImagesEnabled {
        // The setting is on. Animate images.
    } else {
        // The setting is off. Pause animations in animated images.
    }
}

---

Source: https://developer.apple.com/documentation/accessibility/animated-images