Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-05-20 UTC.
[null,null,["Last updated 2025-05-20 UTC."],[],[],null,["# Images\n\nWatch Face Format version Version 4 Version 3 Version 2 Version 1\n\n*** ** * ** ***\n\nA container for a set of related image resources. Each time the defined trigger\noccurs, a new image appears.\n\nIntroduced in Wear OS 4.\n\nSyntax\n------\n\n```xml\n\u003cImages change=\"TAP | ON_VISIBLE | ON_NEXT_SECOND | ON_NEXT_MINUTE | ON_NEXT_HOUR\"\u003e\n \u003c!-- One or more image elements appear here. --\u003e\n \u003cImage ... /\u003e\n\u003c/Images\u003e\n```\n\nAttributes\n----------\n\n`change`\n\n: This attribute defines what must occur in order for a new image (from the set\n of images) to appear on the watch face:\n\n - `TAP` (default): The change occurs when the user taps on the element.\n - `ON_VISIBLE`: The change occurs when the element next becomes visible.\n - `ON_NEXT_SECOND`: The change occurs when the next second begins.\n - `ON_NEXT_MINUTE`: The change occurs when the next minute begins.\n - `ON_NEXT_HOUR`: The change occurs when the next hour begins.\n\nInner elements\n--------------\n\nThe `Images` element contains one or more instances of [`Image`](/training/wearables/wff/group/part/image) as inner\nelements.\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Images](/training/wearables/wff/v2/group/part/image/images)\n- [AnimatedImages](/training/wearables/wff/group/part/animated-image/animated-images)\n- [AnimationController](/training/wearables/wff/group/part/animated-image/animation-controller)"]]