offline docs

offline-docs/alpinejs/directives/show.md

@@ -0,0 +1,82 @@
+# Alpine.js Documentation - Directives
+
+Alpine directives are attributes that you can add to HTML elements to give them special behavior.
+
+## [x-show](/directives/show)
+
+`x-show` is one of the most useful and powerful directives in Alpine. It provides an expressive way to show and hide DOM elements.
+
+Here's an example of a simple dropdown component using `x-show`.
+
+```
+<div x-data="{ open: false }">
+
+
+n<button x-on:click="open = ! open">Toggle Dropdown</button>
+
+
+n<div x-show="open">
+
+
+nDropdown Contents...
+
+
+n</div>
+
+
+n</div>
+```
+
+When the "Toggle Dropdown" button is clicked, the dropdown will show and hide accordingly.
+
+> If the "default" state of an `x-show` on page load is "false", you may want to use `x-cloak` on the page to avoid "page flicker" (The effect that happens when the browser renders your content before Alpine is finished initializing and hiding it.) You can learn more about `x-cloak` in its documentation.
+
+### [With transitions](#with-transitions)
+
+If you want to apply smooth transitions to the `x-show` behavior, you can use it in conjunction with `x-transition`. You can learn more about that directive [here](/directives/transition), but here's a quick example of the same component as above, just with transitions applied.
+
+```
+<div x-data="{ open: false }">
+
+
+n<button x-on:click="open = ! open">Toggle Dropdown</button>
+
+
+n<div x-show="open" x-transition>
+
+
+nDropdown Contents...
+
+
+n</div>
+
+
+n</div>
+```
+
+### [Using the important modifier](#using-the-important-modifier)
+
+Sometimes you need to apply a little more force to actually hide an element. In cases where a CSS selector applies the `display` property with the `!important` flag, it will take precedence over the inline style set by Alpine.
+
+In these cases you may use the `.important` modifier to set the inline style to `display: none !important`.
+
+```
+<div x-data="{ open: false }">
+
+
+n<button x-on:click="open = ! open">Toggle Dropdown</button>
+
+
+n<div x-show.important="open">
+
+
+nDropdown Contents...
+
+
+n</div>
+
+
+n</div>
+```
+
+Code highlighting provided by [Torchlight](https://torchlight.dev/)