What's New in APL 2024.2

(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) 2024.2 introduces new features and capabilities for APL.

Base component properties

All components now have the following new base component properties:

  • onLayout – This handler runs commands when the layout calculation for the component changes. For example, use onLayout to resize a Sequence to fit a specific number of child components of different sizes. For details, see the onLayout property.
  • pointerEvents – This property controls whether the component is the target of pointer events, such as touch, cursor events, gestures, and hover. You can use the pointerEvents property to turn off pointer events for a component that displays on top of another component, to allow pointer events to pass through to the next component. For details, see pointerEvents.

Component-specific properties

Text component

The Text component now has the onTextLayout property. This handler runs commands when the text layout calculation for the Text component occurs. This can be useful for setting properties such as the font size based on the size of the component.

For example, you can use SetValue to reduce the font size of a text item so that the text doesn't truncate. For details, see onTextLayout.

Video component

The Video component now has the screenLock property. This property controls the document lifecycle during video playback.

For details, see screenLock.

Event context properties

The event context for the Sequence, GridSequence, and ScrollView components has been updated to include two new Boolean properties:

  • allowForward – Reports true when there is room to scroll the component forward.
  • allowBackwards – Reports true when there is room to scroll the component backwards.

These properties are available when the component is the source or target of an event, and are reported in event.source or event.target.

APL versions and Amazon device support

For details about the APL versions available on Amazon devices, see APL versions and Amazon device support.

Work with APL versions

For details about how to check the APL version, see What's New in APL.

Was this page helpful?

Last updated: Sep 06, 2024