Responsive Components
A responsive component combines components into modular, responsive elements. You can use these as building blocks in your document, similar to how you would use components.
Available responsive components
The following table lists available responsive components in the alexa-layouts
package and indicates which viewport profiles in the alexa-viewport-profiles
package support the component.
Name | Description | Standard viewports | Widget viewports |
---|---|---|---|
Displays a video, image, or color behind your content. |
Yes |
Medium | |
Displays a button the user can select with touch or a controller. You can configure the text displayed on the button, the button appearance, and the command to run when the user selects the button. |
Yes |
No | |
Displays an atomic unit of content within a container. Use this component for a glanceable, digestible snapshot of information. You can configure the background, the metadata, and the command to run when the user selects the card. |
Yes |
No | |
Displays a check box the user can toggle on and off. You can control the check box size, colors, and commands to run when the user interacts with the check box. |
Yes |
No | |
Displays a horizontal or vertical divider to create visual separation between items. |
Yes |
No | |
Displays a hint at the bottom of a screen to suggest other utterances the user might try. |
Yes |
No | |
A variant of |
No |
Medium | |
Displays common header information such as a title, subtitle, and back button. |
Yes |
Medium | |
Displays a vector graphic as a button. The user can select the button with touch or a controller. You specify the graphic to display, the button style, and the command to run when the user selects the button. AlexaIconButton automatically handles different states, such as disabled, pressed, and focused. |
Yes |
No | |
Displays an image. You can display the image with standard aspect ratios (such as portrait or round) and effects such as rounded corners. |
Yes |
No | |
Displays an image along with text, formatted to display within a list. |
Yes |
No | |
Displays the number of a list item. Use this component to number list items in a component with multiple child components (such as a |
Yes |
No | |
Displays a current page number and total number of pages, such as "1 | 5" for page one out of five. You can use this to number pages in a Pager. |
Yes |
No | |
Displays a graphical representation of the current page and the total number of pages in a pager. The component can animate as the user changes the pages |
Yes |
Medium | |
Displays text to provide context for an image. |
Yes |
Medium | |
Displays an animated progress bar to indicate ongoing activity. |
Yes |
Medium | |
Displays a circular progress bar on small round hubs to indicate ongoing activity. |
Yes |
No | |
Displays animated dots to indicate an action is in progress. |
Yes |
No | |
Displays a radio button the user can toggle on and off. You can control the button size, colors, and commands to run when the user interacts with the radio button. |
Yes |
No | |
Displays a non-interactive rating for an item. You can use a default star image or provide your own custom assets for the graphic. |
Yes |
No | |
Displays an interactive progress bar. Users can drag the bar to scrub content or change settings. |
Yes |
No | |
Displays a circular, interactive progress bar. Users can drag the bar to scrub content or change settings. |
Yes |
No | |
Displays an item the user can swipe to perform an action. |
Yes |
No | |
Displays a switch the user can slide between on and off. You can control the switch size, colors, and commands to run when the user interacts with the switch. |
Yes |
No | |
Displays text, formatted to display within a list. |
Yes |
Medium | |
Displays a set of video player controls. You can customized the appearance of the buttons and define the commands to run when the user select the buttons. |
Yes |
Medium |
Viewport profiles and responsive components
Viewport profiles are available in the alexa-viewport-profiles
package.
Standard viewport profiles include the following:
- All hub round profiles
- All hub landscape profiles
- All hub portrait profiles
- All mobile profiles
- All TV profiles
Widget viewport profiles include the following:
- Widget Medium (
@hubWidgetMedium
)
For details about the viewport profiles, see Viewport Profiles.
Design guidance
For design guidance on how to use the responsive components in standard APL documents, see Alexa Design Guide: Responsive Components.
For design guidance on how to use the responsive components in widgets, see Alexa Design Guide: Widget Responsive Components.
Related topics
Last updated: Nov 28, 2023