• Atom
  • CORE COMPONENT
  • Taxonomic name: A-BUTTON--APP
  • Added on: v5.11.0 (07/09/21)

Application and app store buttons

These buttons allow the ability to link to app stores for example Apple, Google Play, Adobe Acrobat whilst meeting Abeille Assurances' accessibility guidelines. None of these buttons can be altered as per the vendor brand and badge usage guidelines.


Design and usage

Accessibility and screen readers

  • Colour contrast WCAG AA compliant
  • Minimum height of 44px for small app store button variant
  • Visually hidden text must be used to aid assistive technology users comprehension of the buttons
  • Clear focus state, via a border applied around each vendor brand button to ensure accessibility compliance

Placement

  • Place the button in a subordinate position to the image or main message so that it isn't the dominant artwork

Use case and exception scenarios

  • Use one group of app store buttons, with one button per vendor, per layout or video
  • Place the app store button in a subordinate position to the image or main message so that it isn't the dominant artwork
  • App store buttons must be shown on a solid colored background or a simple background image that does not obscure the button

Small variant

  • For use in particularly restricted screen estate, or for reduced prominence, eg. footer

Design

  • Do not modify, angle, or animate the app store buttons
  • When app store buttons are placed in a group, the buttons must all be the same height

Note: These buttons are provided for use by the vendors themselves and are only available in English unless otherwise stated.

Examples

Apple App Store

The Apple app store buttons are suplied in both a dark and light variant, with the black variant being used by default. The alternative white variant is designed to give you greater versatility and can be used when the preferred black variant appears visually heavy in the layout. The white is suitable when only one button appears in the layout and when it complements the colors used in the layout. If app store buttons for other app platforms appear on the same page, the Apple app store button must be first in the lineup of buttons and the preferred black variant must be used, not the alternative white variant.

These buttons are available, hosted on the Abeille Assurances Icon Library, in a selection of alternative languages. See the development notes for further details.

Interactive example

Code example

<button class="a-button a-button--app [ Modifers ]"><img src="./v.2023.01/shared/assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/[ button image name ]" decoding="async" width="..." height="55" alt="" /><span class="u-hidden--visually">Download on the App Store</span></button>
<!-- or --->
<a class="a-button a-button--app [ Modifers ]" href="..." title="External site - apps.apple.com" rel="external"><img src="./v.2023.01/shared/assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/[ button image name ]" decoding="async" width="..." height="55"  alt="" /><span class="u-hidden--visually">Download on the App Store</span></a>

Google Play Store

For full usage rules see https://play.google.com/intl/en_us/badges/

These buttons are available, hosted on the Abeille Assurances Icon Library, in a selection of alternative languages. See the development notes for further details.

Interactive example

Code example

<button class="a-button a-button--app [ Modifers ]"><img src="./v.2023.01/shared/assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/[ button image name ]" decoding="async" width="..." height="55" alt="" /><span class="u-hidden--visually">Get it on Google Play</span></button>
<!-- or --->
<a class="a-button a-button--app [ Modifers ]" href="..." title="External site - play.google.com" rel="external"><img src="./v.2023.01/shared/assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/[ button image name ]" decoding="async" width="..." height="55"  alt="" /><span class="u-hidden--visually">Get it on Google Play</span></a>

Amazon Appstore

For full usage rules see https://developer.amazon.com/support/legal/tuabg

These buttons are available, hosted on the Abeille Assurances Icon Library, in a selection of alternative languages. See the development notes for further details.

Interactive example

Code example

<button class="a-button a-button--app [ Modifers ]"><img src="./v.2023.01/shared/assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/[ button image name ]" decoding="async" width="..." height="55" alt="" /><span class="u-hidden--visually">Available at Amazon Appstore</span></button>
<!-- or --->
<a class="a-button a-button--app [ Modifers ]" href="..." title="External site - www.amazon.com" rel="external"><img src="./v.2023.01/shared/assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/[ button image name ]" decoding="async" width="..." height="55"  alt="" /><span class="u-hidden--visually">Available at Amazon Appstore</span></a>

Adobe Acrobat Reader

For full usage rules see https://www.adobe.com/uk/legal/permissions/icons-web-logos.html

Interactive example

Code example

<button class="a-button a-button--app [ Modifers ]"><img src="./v.2023.01/shared/assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/[ button image name ]" decoding="async" width="..." height="55" alt="" /><span class="u-hidden--visually">Get Adobe Acrobat Reader</span></button>
<!-- or --->
<a class="a-button a-button--app [ Modifers ]" href="..." title="External site - get.adobe.com" rel="external"><img src="./v.2023.01/shared/assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/[ button image name ]" decoding="async" width="..." height="55"  alt="" /><span class="u-hidden--visually">Get Adobe Acrobat Reader</span></a>

Development and test

Notes for developers

Accessible labels

All the application and app store buttons are static image meaning that to maintaining accessibility visually hidden text is required. This hidden text must begin with the text included on the button eg. "Download on the App Store", and if required where there is more than one unique link to the same app store follow this text with additional deciption to inform the user what specific app this button is associated with.

Links to external websites

If a link is taking the user to an external website, ensure that it is clear that it will do so by making the title attribute descriptive of what it will do and where it will go, for example:

<a href="https://www.google.com" title="External site - www.google.com" rel="external">Google</a>

Notes for testers

  • Ensure that buttons can be accessed via the mouse as well as via tabbing using the keyboard.
  • Use a screen reader to confirm that the buttons are understandable as to where they will be going when listed out of context of the page.
  • Ensure that when a button has focus, the style changes noticeably.
  • Ensure that text within buttons is descriptive of what or where the button is going. Additional text descriptive text can be hidden visually from the user to aid to help make the button understandable, especially if there area number of links / buttons such as "Find out more" on the page which go to different locations.

Classes overview

The following table gives you a quick overview of the CSS classes that can be applied.

Class Outcome Required Applied to Comments
.a-button Base button style Yes button, a  
.a-button--app Modifer to support specific styling for the application and app store buttons Yes .a-button  
.a-button--small Modifier to change button height from 55px to 44px   .a-button--app  

Available image options

The following table gives you a quick overview of the application and app buttons available.

Variant Button image URL Dimensions (W x H ) Example
Apple App Store (Black, English) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-black.svg 165 x 55
Apple App Store (Black, Chinese) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-black-cn.svg 150 x 55
Apple App Store (Black, French) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-black-fr.svg 174 x 55
Apple App Store (Black, Taiwanese) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-black-hktw.svg 150 x 55
Apple App Store (Black, Hindi) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-black-in.svg 150 x 55
Apple App Store (Black, Italian) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-black-it.svg 165 x 55
Apple App Store (Black, Lithuanian) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-black-lt.svg 165 x 55
Apple App Store (Black, Polish) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-black-pl.svg 165 x 55
Apple App Store (White, English) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-white.svg 165 x 55
Apple App Store (White, Chinese) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-white-cn.svg 150 x 55
Apple App Store (White, French) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-white-fr.svg 174 x 55
Apple App Store (White, Taiwanese) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-white-hktw.svg 150 x 55
Apple App Store (White, Hindi) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-white-in.svg 150 x 55
Apple App Store (White, Italian) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-white-it.svg 165 x 55
Apple App Store (White, Lithuanian) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-white-lt.svg 165 x 55
Apple App Store (White, Polish) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/apple-white-pl.svg 165 x 55
Google Play Store (English) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/google-play.svg 186 x 55
Google Play Store (Chinese) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/google-play-cn.svg 186 x 55
Google Play Store (French) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/google-play-fr.svg 186 x 55
Google Play Store (Taiwanese) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/google-play-hktw.svg 186 x 55
Google Play Store (Hindi) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/google-play-in.svg 186 x 55
Google Play Store (Italian) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/google-play-it.svg 186 x 55
Google Play Store (Lithuanian) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/google-play-lt.svg 186 x 55
Google Play Store (Polish) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/google-play-pl.svg 186 x 55
Amazon Appstore (Black, English) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/amazon-black.svg 189 x 55
Amazon Appstore (Black, French) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/amazon-black-fr.svg 189 x 55
Amazon Appstore (Black, Italian) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/amazon-black-it.svg 189 x 55
Amazon Appstore (White, English) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/amazon-white.svg 189 x 55
Amazon Appstore (White, French) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/amazon-white-fr.svg 189 x 55
Amazon Appstore (White, Italian) /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/amazon-white-it.svg 189 x 55
Adobe Acrobat Reader /assets/themes-icons/v2/[ organisation ]/[ theme name ]/functional/app-store/acrobat-reader.svg 218 x 55

An example of the full image path would be /assets/themes-icons/v2/aviva/default/functional/app-store/google-play.svg.


Keyboard operations

TAB

Tabbing to an anchor should make the button clearly visually different so that the focus point on the page is obvious to the user.

SPACE or ENTER

With focus on a button, pressing SPACE or ENTER will open the link if a link or perform the form action. If the link is internal to the page it will scroll the page otherwise it will load the new page.

Component releases

  • Added on: v5.11.0 (07/09/21)

Latest update:

  • Component added to offer consistency across Abeille Assurances websites for application and app store buttons and their associated accessible states.

Full version history

A full history of changes and enhancements detailing all minor and major updates to the component.

View full version history

Want something new in Framework, or to chat about an issue you're having with it?

Contact the team