email-organizer/offline-docs/alpinejs/directives/if.md

Alpine.js Documentation - Directives

Alpine directives are attributes that you can add to HTML elements to give them special behavior.

x-if

x-if is used for toggling elements on the page, similarly to x-show, however it completely adds and removes the element it's applied to rather than just changing its CSS display property to "none".

Because of this difference in behavior, x-if should not be applied directly to the element, but instead to a <template> tag that encloses the element. This way, Alpine can keep a record of the element once it's removed from the page.

<template x-if="open">


n<div>Contents...</div>


n</template>

Despite not being included in the above snippet, x-if cannot be used if no parent element has x-data defined. → Read more about x-data

Caveats

Unlike x-show, x-if, does NOT support transitioning toggles with x-transition.

<template> tags can only contain one root element.

Code highlighting provided by Torchlight