@alpinejs/docs 3.9.0-revision.2 → 3.9.3-revision.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@alpinejs/docs",
-    "version": "3.9.0-revision.2",
+    "version": "3.9.3-revision.1",
     "description": "The documentation for Alpine",
     "author": "Caleb Porzio",
     "license": "MIT"

package/src/en/directives/modelable.md

@@ -5,9 +5,7 @@ title: modelable
 
 # x-modelable
 
-`x-modelable` allows you to expose any value by name as the target of the `x-model` directive.
-
-Typically this feature would be used in conjunction with a backend templating framework like Laravel Blade. It's useful for abstracting away Alpine components into backend templates and exposing state to the outside through `x-model` as if it were a native input.
+`x-modelable` allows you to expose any Alpine property as the target of the `x-model` directive.
 
 Here's a simple example of using `x-modelable` to expose a variable for binding with `x-model`.
 
@@ -17,7 +15,7 @@ Here's a simple example of using `x-modelable` to expose a variable for binding
         <button @click="count++">Increment</button>
     </div>
 
-    Some Number: <span x-text="number"></span>
+    Number: <span x-text="number"></span>
 </div>
 ```
 
@@ -35,3 +33,4 @@ Here's a simple example of using `x-modelable` to expose a variable for binding
 
 As you can see the outer scope property "number" is now bound to the inner scope property "count".
 
+Typically this feature would be used in conjunction with a backend templating framework like Laravel Blade. It's useful for abstracting away Alpine components into backend templates and exposing state to the outside through `x-model` as if it were a native input.

package/src/en/directives/teleport.md

@@ -56,7 +56,7 @@ Here's a contrived modal example:
 
     </div>
 
-    <div class="py-4">Some other content...</div>
+    <div class="py-4">Some other content placed AFTER the modal markup.</div>
 </div>
 <!-- END_VERBATIM -->
 

package/src/en/essentials/installation.md

@@ -33,7 +33,7 @@ This is by far the simplest way to get started with Alpine. Include the followin
 Notice the `@3.x.x` in the provided CDN link. This will pull the latest version of Alpine version 3. For stability in production, it's recommended that you hardcode the latest version in the CDN link.
 
 ```alpine
-<script defer src="https://unpkg.com/alpinejs@3.9.0/dist/cdn.min.js"></script>
+<script defer src="https://unpkg.com/alpinejs@3.9.3/dist/cdn.min.js"></script>
 ```
 
 That's it! Alpine is now available for use inside your page.

package/src/en/plugins/intersect.md

@@ -129,6 +129,23 @@ Useful for elements where it's important to show the whole element.
 <div x-intersect.full="shown = true">...</div> // when `0.99` of the element is in the viewport
 ```
 
+<a name="threshold"></a>
+### .threshold
+
+Allows you to control the `threshold` property of the underlying `IntersectionObserver`:
+
+This value should be a decimal in the range "0-1". A value of "0" means: trigger an "intersection" if ANY part of the element enters the viewport (the default behavior). While a value of "1" means: don't trigger an "intersection" unless the entire element has entered the viewport.
+
+Any value in between is a "ratio" of those two extremes.
+
+For example if you want to trigger an intersection after half of the element has entered the page, you can use `.threshold.50`:
+
+```alpine
+<div x-intersect.threshold.50="shown = true">...</div> // when 50% of the element is in the viewport
+```
+
+If you wanted to trigger only when 5% of the element has entered the viewport, you could use: `.threshold.05`, and so on and so forth.
+
 <a name="margin"></a>
 ### .margin