diff options
Diffstat (limited to 'alpinejs/packages/docs/src/en/directives/if.md')
-rw-r--r-- | alpinejs/packages/docs/src/en/directives/if.md | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/alpinejs/packages/docs/src/en/directives/if.md b/alpinejs/packages/docs/src/en/directives/if.md new file mode 100644 index 0000000..b8300f3 --- /dev/null +++ b/alpinejs/packages/docs/src/en/directives/if.md @@ -0,0 +1,20 @@ +--- +order: 16 +title: if +--- + +# 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. + +```alpine +<template x-if="open"> + <div>Contents...</div> +</template> +``` + +> Unlike `x-show`, `x-if`, does NOT support transitioning toggles with `x-transition`. + +> Remember: `<template>` tags can only contain one root level element. |