up.Preview up.Preview.prototype.swapContent([element], newContent)

Instance method

Visually replaces the children of an element with new content for the duration of this preview.

The visual effect is achieved by hiding existing children and inserting a new element as the only visible child. When the preview ends all changes will be reverted.

Tip

To visually remove elements during a preview, prefer hiding over detaching. See Prefer additive changes.

Example

This preview visually replaces the children of the targeted fragment with a .spinner element:

up.preview('spinner', function(preview) {
  preview.swapContent('<span class="spinner">Please wait...</span>')
})

To swap the content of another element, pass it as a first reference argument:

up.preview('spinner', function(preview) {
  preview.swapContent('body', '<span class="spinner">Please wait...</span>')
})