up.layer [up-accept]

HTML selector

Accepts the current layer when this element is clicked or submitted.

Closing overlays

On a button

To accept the current layer when a button is clicked, use an [up-accept] attribute:

<button up-accept>Close overlay</button>

This button will accept the overlay with the value { id: 5 }:

<button up-accept="{ id: 5 }">Choose user #5</button>

See Closing when a button is clicked.

On a hyperlink

When reusing a page within an overlay it can be useful to have a button that closes the overlay, but navigates somewhere else on the root layer.

In this case you can use a hyperlink (<a>) with a fallback URL in its [href] attribute:

<a href="/list" up-accept>Finish</a>

Unpoly will only navigate to /list when this link is clicked in the root layer. In an overlay the click event is prevented and the overlay is accepted.

See Closing when a link is followed.

On a form

To accept an overlay when a form is submitted, set an [up-accept] attribute on the <form> element. This will immediately accept the overlay on submission, without making a network request:

<form up-accept> <!-- mark: up-accept -->
  ...
</form>

The form's field values will become the acceptance value of the closed overlay, as an up.Params value.

See Closing when a form is submitted.