[up-dismiss]

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

The relaxed JSON value of the [up-dismiss] attribute becomes the overlay's dismissal value.

On a button

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

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

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

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

See Closing when a button is clicked.

On a hyperlink

When reusing a page within an overlay, the same link may need to close the overlay, but navigate somewhere else when the page is shown on the root layer.

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

<a href="/list" up-dismiss>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 dismissed.

See Closing when a link is followed.

On a form

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

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

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

See Closing when a form is submitted.