AUI 5 upgrade guides

Ask a question

You can find upgrade guide for the latest version here.

Upgrading from 5.8.x to 5.9

Inline dialog

Tag name

Inline dialog 1 is still deprecated but usable via the imperative AUI.InlineDialog() API. However, the Inline Dialog 2 custom element has been renamed to Inline Dialog.

​x
 
<!-- Old -->
<aui-inline-dialog2></aui-inline-dialog2>
​
<!-- New -->
<aui-inline-dialog></aui-inline-dialog>

persistent property / attribute

The persistent attribute is now a boolean attribute.

 
<!-- Old -->
<aui-inline-dialog2 persistent="true"></aui-inline-dialog2>
<aui-inline-dialog2 persistent="false"></aui-inline-dialog2>
​
<!-- New -->
<aui-inline-dialog persistent></aui-inline-dialog>
<aui-inline-dialog></aui-inline-dialog>

Boolean attributes

Now that persistent is a boolean attribute, this means that if you set persistent="false", it will be interpreted as true.

Events

Event listeners now do not contain the component prefix. They are only prefixed with aui-. This will be a convention for everything moving forward.

 
// Old
inlineDialog.addEventListener('aui-layer-hide', handler);
inlineDialog.addEventListener('aui-layer-show', handler);
​
// New
inlineDialog.addEventListener('aui-hide', handler);
inlineDialog.addEventListener('aui-show', handler);

Methods removed in favour of open property / attribute

The hide(), isVisible() and show() methods have all been removed in lieu of a single open property / attribute.

 
// Old
inlineDialog.hide();
var isVisible = inlineDialog.isVisible();
inlineDialog.show();
​
// New
inlineDialog.open = false;
var isVisible = inlineDialog.open;
inlineDialog.open = true;

Upgrading from 5.7.x to 5.8

Inline dialog

More details of the inline dialog upgrade can be found in the inline dialog component guide.