unpoly-rails 2.5.0 → 2.5.1

data/assets/unpoly/unpoly.js

@@ -8,7 +8,7 @@
 @module up
 */
 window.up = {
-    version: '2.5.0'
+    version: '2.5.1'
 };
 
 
@@ -6903,12 +6903,13 @@ up.Layer.Overlay = class Overlay extends up.Layer {
         }
     }
     registerClickCloser(attribute, closeFn) {
+        let selector = `[${attribute}]`;
         // Allow the fallbacks to be both vanilla links and Unpoly [up-target] links
-        this.on('up:click', `[${attribute}]`, function (event) {
+        this.on('up:click', selector, function (event) {
             // Since we're defining this handler on up.Overlay, we will not prevent
             // a link from being followed on the root layer.
             up.event.halt(event);
-            const origin = event.target;
+            const origin = event.target.closest(selector);
             const value = e.jsonAttr(origin, attribute);
             const closeOptions = { origin };
             const parser = new up.OptionsParser(closeOptions, origin);
@@ -19531,10 +19532,13 @@ up.link = (function () {
     })
     ```
   
-    ### Cancelation is forwarded
+    ### Cancelation
   
-    If the user cancels an `up:click` event using `event.preventDefault()`,
-    the underlying `click` or `mousedown` event will also be canceled.
+    You may cancel an `up:click` event using `event.preventDefault()`.
+  
+    Canceling `up:click` on a hyperlink will prevent any Unpoly from [following](/a-up-follow) that link.
+  
+    The underlying `click` or `mousedown` event will also be canceled.
   
     ### Accessibility
   
@@ -19553,6 +19557,8 @@ up.link = (function () {
       The clicked element.
     @param {Event} event.originalEvent
       The underlying `click` or `mousedown` event.
+    @param event.preventDefault()
+      Prevents this event and also the original `click` or `mousedown` event.
     @stable
     */
     /*-
@@ -19608,6 +19614,14 @@ up.link = (function () {
   
     See [Handling all links and forms](/handling-everything).
   
+    ### Preventing Unpoly from following links
+  
+    To prevent Unpoly from following an `a[up-follow]` link, use one of the following options:
+  
+    - Prevent the `up:link:follow` event on the link element
+    - Prevent the `up:click` event on the link element
+    - Set an `[up-follow=false]` attribute on the link element
+  
     @selector a[up-follow]
   
     @param [up-navigate='true']
@@ -20956,6 +20970,9 @@ up.form = (function () {
     /*-
     Show or hide elements when a form field is set to a given value.
   
+    When the controlling form field gets an `up-switch` attribute, and that form field is nested inside a `<form>`
+    parent, the targets elements must also be inside that same `<form>` parent.
+  
     ### Example: Select options
   
     The controlling form field gets an `up-switch` attribute with a selector for the elements to show or hide:
@@ -21034,6 +21051,26 @@ up.form = (function () {
     </div>
     ```
   
+    ### Example: Radio button
+  
+    ```html
+    <input type="radio" name="advancedness" value="basic" up-switch=".target">
+    <input type="radio" name="advancedness" value="advanced" up-switch=".target">
+    <input type="radio" name="advancedness" value="very-advanced" up-switch=".target">
+  
+    <div class="target" up-show-for="basic">
+      only shown for advancedness = basic
+    </div>
+  
+    <div class="target" up-hide-for="basic">
+      hidden for advancedness = basic
+    </div>
+  
+    <div class="target" up-show-for="advanced very-advanced">
+      shown for advancedness = advanced or very-advanced
+    </div>
+    ```
+  
     @selector input[up-switch]
     @param up-switch
       A CSS selector for elements whose visibility depends on this field's value.