What's New in APL 1.6
(This is not the most recent version of the APL change log. Use the Other Versions option to see the documentation for the most recent version of the APL change log)
Alexa Presentation Language (APL) 1.6 introduces new features and capabilities for APL.
Authoring tool updates
The APL authoring tool has been updated with several improvements.
- When creating a new document, the authoring tool offers improved sample templates to use as a starting point. These templates use the responsive components and templates and follow best practices for responsive design, so they look good on different devices. For details, see Create and Edit an APL Document.
- You can now convert animations in Lottie format into Alexa Vector Graphics (AVG) format and use them within your APL documents. Lottie is a JSON animation format that you can export from Adobe After Effects. For details, see Import a Lottie Animation.
- The authoring tool includes three new viewport profiles for previewing on tablet devices: Mobile Small, Mobile Medium, and Mobile Large. These correspond to new viewport profiles in the
alexa-viewport-profilespackage. Use these profiles in your conditional logic to create documents that look good on tablet devices.
- For details about previewing a document in the authoring tool with different viewport profiles, see Preview a visual response.
- For details about using the
alexa-viewport-profilespackage in your document, see Viewport Profiles.
APL responsive components and templates
APL 1.6 includes some updates to the responsive components and templates:
alexa-stylespackage has been updated to 1.2.0. The package has been updated with some stylistic changes to the existing styles. For details about the styles, see Styles and Resources
viewport-profiles-packagehas been updated to 1.2.0. The package now includes the new
mobileLargeprofiles. For details about the viewport profiles package, see Viewport Profiles.
alexa-layoutspackage has been updated to 1.3.0. Although there are no new components or templates, some existing items have new properties. The following table shows the new properties available to the components and templates in the
|Property||Description||Available on components|
When true, displays a drop-shadow behind the image.
When true, displays a drop-shadow behind the image thumbnail.
For an overview of the components and templates, see Responsive Components and Templates.
Support for tablets that can resize the screen
APL supports devices that can change their characteristics during the skill session. For example, the user can turn a tablet to switch between portrait and landscape. You can create APL documents that automatically resize to fit the new screen. You can also use the new
Reinflate command to change the layout when the screen size changes.
See the following topics:
- Support Tablets and Other Devices that Can Change Size
onConfigChangehandler in Document
preservebase component property
Custom transitions for Pagers
Pager component, you can now create custom animated page transitions that replace the default page transition. Provide an array of page move handlers in the new
handlePageMove property on the
For details and examples, see
Better support for Japanese text
Textcomponent now supports a
<nobr>tag that prevents text from automatically wrapping across multiple lines.
- The new
lineBreakProcessortransformer automatically adds
<nobr>tags to Japanese text.
Token-based lazy loading
New data source types, directives, and requests to support token-based lazy loading. This lets you progressively load items in large lists as the user scrolls through the content. Token-based lazy loading is useful when your back-end uses a token-based API for the data. See the following topics:
Component and layout properties
- All components now support a
paddingproperty. You can set the padding for the top, left, bottom, and right sides with a single array. For details, see
- All components now support the
preserveproperty to indicate properties to save when reinflating the document. For details, see
preserveand Support Tablets and Other Devices that Can Change Size.
GridSequencecomponents support the
snapproperty. When the user scrolls through the content and then stops scrolling, the component can shift the child items to "snap" to the start, center, or end of the container. For details, see
- Several component properties are now dynamic. You can change the values of dynamic properties with the
- Several component properties are now styled. You can set the value of a styled property with a style. For a full list of all styled properties, see APL Styled Properties.
- Layouts now support the
bindproperty, similar to the
bindproperty for components. For details, see the
New function calls
Math object in the data-binding context provides 2 new functions:
Converts x into a floating-point number. A trailing '%' character specifies a percentage.
Convert x into an integer. b is the optional base to use for string conversion, where 0 auto-detects or 2-36 define the base.
For details, see Math functions
Skill response size limit increased
The total size of a skill response can now be up to 120 kilobytes. The APL document and data sources can take full advantage of the larger response size. Previously, the APL document and data sources were limited to 24 kilobytes.
Work with APL versions
For details about how to check the APL version, see What's New in APL.
Last updated: Feb 07, 2023