unpoly-rails 0.60.2 → 0.62.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e81d8b9e7b4c364737eecb1091048a67453e9de955c3a7b64ea2bc2aea73fc69
-  data.tar.gz: fd5642ddc460de37bf3e1f3f30bafea666ed1a5b4da7905aed6f7ff2d0653029
+  metadata.gz: '079979a47b22899b849e8b53275d23c2f6bf8a4ac14bf1b6001ac00330518cc9'
+  data.tar.gz: 033c8335552505a36214999db839d7c54a7e22c93fd168d8d8b25b7ccb5e40aa
 SHA512:
-  metadata.gz: 0d045ec8b2dcbc5ded5a4829e0ad9f6ce68bdaa141fa7248580caa7f320b002a821c0b1796083f28dec463f8a4a4f021f84d49f5d28b9cf2af995474682a266d
-  data.tar.gz: 65579fb7e1e0b1d2b94e6102efac109d3679d499c5fd1a7596988da0111f3d50498627eceb4e813ecaf7afa0ef8bd3d15f64d0c2109a9c5941d115597e2a3564
+  metadata.gz: d7be2bf8bd27d709d479000a591320731ac8fdbe2c0f613883a41af4258d4125bf4e793ec1712f83f56083f27335c39d1a5136cc8a501440fe35403ebd536cff
+  data.tar.gz: d4493b591597cda5245c5d0cf5000d034922cde09316fc030776ceacaaf44330975199eb3b9bd1c5c3a61134c56e38a8f175f6b7e126c50c33c54377d3e31927

data/.ruby-version

@@ -1,2 +1 @@
-2.1.2
-
+2.3.8

data/CHANGELOG.md

@@ -6,6 +6,111 @@ Changes to this project will be documented in this file.
 You may browse a formatted and hyperlinked version of this file at <https://unpoly.com/changes>.
 
 
+0.62.1
+------
+
+This is another maintenance release while we're finishing [the next major version of Unpoly](https://groups.google.com/forum/#!topic/unpoly/FDdVjxbjNLg).
+
+Community members were involved in every change of this release:
+
+- [`up.submit()`](/up.submit) has a new options `{ params }`. It may be used to pass extra form [parameters](/up.Params) that will be submitted in addition to the parameters from the form. (fix by @robinvdvleuten)
+- [`a[up-modal]`](/a-up-modal) will now honor an [`[up-cache]`](/a-up-target#up-cache) attribute on the same link. (fix by @adam12)
+- Prevent destructor function from being called twice if [`up.destroy()`](/up.destroy) is called twice with the same element (reported by @kratob)
+- On devices that don't show a vertical scrollbar, users can no longer scroll the underlying page while a [modal overlay](/up.modal) is open. (reported by @msurdi)
+
+
+0.62.0
+------
+
+This release backports a number of accessibility improvements from [the next major version of Unpoly](https://groups.google.com/forum/#!topic/unpoly/FDdVjxbjNLg).
+We encourage everyone to upgrade to this release in order to better support users with visual impairments.
+
+The following changes are included:
+
+- Links with an [`[up-instant]`](/a-up-instant) attribute can now be followed with the keyboard.
+- Fragments that are being [destroyed](/up.destroy) now get an [`[aria-hidden=true]`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-hidden_attribute)
+  attribute while its disappearance is being animated. When a fragment is being swapped with a new version, the old fragment version is also
+  given `[aria-hidden=true]` while it's disappearing.
+- [Modal dialogs](/up.modal) now get an [`[aria-modal=true]`](https://a11ysupport.io/tech/aria/aria-modal_attribute) attribute.
+
+The next major version of Unpoly will include additional accessibility improvements. In particular the
+new modal ("layer") implementation will implement all best practices for accessible dialogs.
+
+
+0.61.1
+------
+
+This is a maintenance release while we're getting ready for [the next major version of Unpoly](https://groups.google.com/forum/#!topic/unpoly/FDdVjxbjNLg).
+
+- Fix a bug where [`up.destroy()`](/up.destroy) wouldn't clean up the global jQuery cache. This is only relevant when using Unpoly together with jQuery.
+- Fields outside a <form> are now recognized when they have a matching [form] attribute (fixes #85)
+- [`up.form.fields()`](/up.form.fields) now accepts a jQuery collection as a first argument, as was already documented.
+
+
+0.61.0
+------
+
+This release makes it easier to migrate to a recent version of Unpoly when your app still depends on jQuery.
+Unpoly dropped its jQuery dependency with version 0.60.0, but retains optional jQuery support through functions like
+[`up.$compiler()`](/up.$compiler) and [`up.$on()`](/up.$on). All Unpoly functions that take a native element as an
+argument may also be called with a jQuery collection as an argument.
+
+The following changes to the optional jQuery support were implemented:
+
+- In an ES6 build pipeline, Unpoly's jQuery support no longer requires `window.jQuery` to be defined before
+  Unpoly is imported into the build. You still need to define `window.jQuery`, but you may do so at any time in your
+  scripts, regardless of load order.
+- jQuery support functions like [`up.$compiler()`](/up.$compiler) now fail with a helpful message if the developer
+  forgets to define `window.jQuery`.
+
+This release also exposes some convenience functions and selectors:
+
+- New experimental function [`up.event.halt()`](/up.event.halt). It prevents the event from bubbling up the DOM.
+  It also prevents other event handlers bound on the same element. It also prevents the event's default action.
+- New experimental function [`up.form.fields()`](/up.form.fields).  It returns a list of form fields within the given element.
+- The selector [`form[up-validate]`](/form-up-validate) is now supported. It performs
+  [server-side validation](/input-up-validate) when any fieldset within this form changes. Previously only the variant
+  [`input[up-validate]`](/input-up-validate) was supported.
+
+
+
+0.60.3
+------
+
+[`[up-validate]`](/up-validate) again recognizes the `[up-fieldset]` attribute to find the form fragment
+that should be replaced with validation results.
+
+In the example below, changing the `email` input would only validate the first fieldset:
+
+```html
+<form action="/users" id="registration">
+
+  <div up-fieldset>
+    Validation message
+    <input type="text" name="email" up-validate />
+  </div>
+
+  <div up-fieldset>
+    Validation message
+    <input type="password" name="password" up-validate />
+  </div>
+
+</form>
+```
+
+
+0.60.2
+------
+
+- When [submitting](/up-form) a form with a GET method, any query parameters in the form's `[action]` URL are now discarded.
+  This matches the standard browser behavior when submitting a form without Unpoly.
+- When [submitting](/up-form) a form with a POST method, any query parameters in the form's `[action]` URL are now kept in the
+  URL, instead of being merged into the form's data payload.
+  This matches the standard browser behavior when submitting a form without Unpoly.
+- New experimental function [`up.Params.stripURL(url)`](/up.Params.stripURL).
+  It returns the given URL without its [query string](https://en.wikipedia.org/wiki/Query_string).
+
+
 0.60.1
 ------
 

data/Rakefile

@@ -42,7 +42,10 @@ end
 
 namespace :publish do
   task :confirm do
-    puts "Are you ready to publish a new Unpoly version to all release channels? [y/N] "
+    puts "Before publishing new Unpoly version:"
+    puts "- Bump the version in version.rb"
+    puts "- Update the CHANGELOG"
+    puts "Ready to publish to all release channels? [y/N] "
     reply = STDIN.gets.strip.downcase
     unless reply == 'y'
       puts "Aborted"
@@ -105,6 +108,7 @@ namespace :publish do
     puts "Now remember to:"
     puts "- update unpoly.com so user see the updated CHANGELOG and CDN link"
     puts "- send a message to the e-mail group announcing the new release"
+    puts "- tweet a link to the CHANGELOG as @unpolyjs"
   end
 
   desc 'Build artifacts, push to git and release to package managers'

data/dist/unpoly.js

@@ -5,7 +5,7 @@
 
 (function() {
   window.up = {
-    version: "0.60.2"
+    version: "0.62.1"
   };
 
 }).call(this);
@@ -595,7 +595,7 @@ to not include another library in your asset bundle.
     @stable
      */
     isJQuery = function(object) {
-      return up.browser.canJQuery() && (object instanceof jQuery);
+      return !!(object != null ? object.jquery : void 0);
     };
 
     /***
@@ -1898,8 +1898,10 @@ Internet Explorer 10 or lower
  */
 
 (function() {
+  var slice = [].slice;
+
   up.browser = (function() {
-    var canAnimationFrame, canConsole, canControlScrollRestoration, canCssTransition, canCustomElements, canDOMParser, canFormData, canInputEvent, canInspectFormData, canJQuery, canPromise, canPushState, isIE10OrWorse, isIE11, isSupported, navigate, popCookie, submitForm, u, url, whenConfirmed;
+    var callJQuery, canAnimationFrame, canConsole, canControlScrollRestoration, canCssTransition, canCustomElements, canDOMParser, canFormData, canInputEvent, canInspectFormData, canJQuery, canPromise, canPushState, isIE10OrWorse, isIE11, isSupported, navigate, popCookie, submitForm, u, url, whenConfirmed;
     u = up.util;
 
     /***
@@ -2038,15 +2040,15 @@ Internet Explorer 10 or lower
     canCustomElements = u.memoize(function() {
       return !!window.customElements;
     });
-    canJQuery = u.memoize(function() {
-      return !!window.jQuery;
-    });
     canAnimationFrame = u.memoize(function() {
       return 'requestAnimationFrame' in window;
     });
     canControlScrollRestoration = u.memoize(function() {
       return 'scrollRestoration' in history;
     });
+    canJQuery = function() {
+      return !!window.jQuery;
+    };
     popCookie = function(name) {
       var ref, value;
       value = (ref = document.cookie.match(new RegExp(name + "=(\\w+)"))) != null ? ref[1] : void 0;
@@ -2086,6 +2088,12 @@ Internet Explorer 10 or lower
     isSupported = function() {
       return !isIE10OrWorse() && canConsole() && canDOMParser() && canFormData() && canCssTransition() && canInputEvent() && canPromise() && canAnimationFrame();
     };
+    callJQuery = function() {
+      var args;
+      args = 1 <= arguments.length ? slice.call(arguments, 0) : [];
+      canJQuery() || up.fail("jQuery must be published as window.jQuery");
+      return jQuery.apply(null, args);
+    };
     return {
       url: url,
       navigate: navigate,
@@ -2094,11 +2102,12 @@ Internet Explorer 10 or lower
       canFormData: canFormData,
       canInspectFormData: canInspectFormData,
       canCustomElements: canCustomElements,
-      canJQuery: canJQuery,
       canControlScrollRestoration: canControlScrollRestoration,
+      canJQuery: canJQuery,
       whenConfirmed: whenConfirmed,
       isSupported: isSupported,
       popCookie: popCookie,
+      jQuery: callJQuery,
       isIE11: isIE11
     };
   })();
@@ -2346,7 +2355,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     @function up.element.closest
     @param {Element} element
       The element on which to start the search.
-    @param {string}
+    @param {string} selector
       The CSS selector to match.
     @return {Element|null|undefined} element
       The matching element.
@@ -2762,11 +2771,11 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
         element.className // returns 'klass'
     
     @function up.element.affix
-    @params {Element} parent
+    @param {Element} parent
       The parent to which to attach the created element.
-    @params {string} selector
+    @param {string} selector
       The CSS selector from which to create an element.
-    @params {Object} attrs
+    @param {Object} attrs
       An object of attributes to set on the created element.
     @param {Object} attrs.text
       The [text content](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) of the created element.
@@ -3419,32 +3428,32 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     }
 
     BodyShifter.prototype.shift = function() {
-      var anchor, body, bodyRightPadding, bodyRightShift, elementRight, elementRightShift, i, len, overflowElement, ref, results, scrollbarWidth;
-      if (!up.viewport.rootHasVerticalScrollbar()) {
-        return;
-      }
-      body = document.body;
+      var anchor, body, bodyRightPadding, bodyRightShift, elementRight, elementRightShift, i, len, overflowElement, ref, results, rootHadVerticalScrollbar, scrollbarWidth;
+      rootHadVerticalScrollbar = up.viewport.rootHasVerticalScrollbar();
       overflowElement = up.viewport.rootOverflowElement();
-      scrollbarWidth = up.viewport.scrollbarWidth();
-      bodyRightPadding = e.styleNumber(body, 'paddingRight');
-      bodyRightShift = scrollbarWidth + bodyRightPadding;
-      this.unshiftFns.push(e.setTemporaryStyle(body, {
-        paddingRight: bodyRightShift
-      }));
       this.unshiftFns.push(e.setTemporaryStyle(overflowElement, {
         overflowY: 'hidden'
       }));
-      ref = up.viewport.anchoredRight();
-      results = [];
-      for (i = 0, len = ref.length; i < len; i++) {
-        anchor = ref[i];
-        elementRight = e.styleNumber(anchor, 'right');
-        elementRightShift = scrollbarWidth + elementRight;
-        results.push(this.unshiftFns.push(e.setTemporaryStyle(anchor, {
-          right: elementRightShift
-        })));
+      if (rootHadVerticalScrollbar) {
+        body = document.body;
+        scrollbarWidth = up.viewport.scrollbarWidth();
+        bodyRightPadding = e.styleNumber(body, 'paddingRight');
+        bodyRightShift = scrollbarWidth + bodyRightPadding;
+        this.unshiftFns.push(e.setTemporaryStyle(body, {
+          paddingRight: bodyRightShift
+        }));
+        ref = up.viewport.anchoredRight();
+        results = [];
+        for (i = 0, len = ref.length; i < len; i++) {
+          anchor = ref[i];
+          elementRight = e.styleNumber(anchor, 'right');
+          elementRightShift = scrollbarWidth + elementRight;
+          results.push(this.unshiftFns.push(e.setTemporaryStyle(anchor, {
+            right: elementRightShift
+          })));
+        }
+        return results;
       }
-      return results;
     };
 
     BodyShifter.prototype.unshift = function() {
@@ -3774,7 +3783,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 
     CompilePass.prototype.compileOneElement = function(compiler, element) {
       var compileArgs, data, destructorOrDestructors, elementArg, result;
-      elementArg = compiler.jQuery ? jQuery(element) : element;
+      elementArg = compiler.jQuery ? up.browser.jQuery(element) : element;
       compileArgs = [elementArg];
       if (compiler.length !== 1) {
         data = up.syntax.data(element);
@@ -3788,7 +3797,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 
     CompilePass.prototype.compileBatch = function(compiler, elements) {
       var compileArgs, dataList, elementsArgs, result;
-      elementsArgs = compiler.jQuery ? jQuery(elements) : elements;
+      elementsArgs = compiler.jQuery ? up.browser.jQuery(elements) : elements;
       compileArgs = [elementsArgs];
       if (compiler.length !== 1) {
         dataList = u.map(elements, up.syntax.data);
@@ -4126,7 +4135,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
         element = e.closest(element, this.selector);
       }
       if (element) {
-        elementArg = this.jQuery ? jQuery(element) : element;
+        elementArg = this.jQuery ? up.browser.jQuery(element) : element;
         args = [event, elementArg];
         expectedArgCount = this.callback.length;
         if (!(expectedArgCount === 1 || expectedArgCount === 2)) {
@@ -4683,8 +4692,9 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 
     FollowVariant.prototype.onClick = function(event, link) {
       if (up.link.shouldProcessEvent(event, link)) {
-        if (e.matches(link, '[up-instant]')) {
-          return up.event.halt(event);
+        if (e.matches(link, '[up-instant]') && link.upInstantSupported) {
+          up.event.halt(event);
+          link.upInstantSupported = false;
         } else {
           up.event.consumeAction(event);
           return this.followLink(link);
@@ -4696,6 +4706,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 
     FollowVariant.prototype.onMousedown = function(event, link) {
       if (up.link.shouldProcessEvent(event, link)) {
+        link.upInstantSupported = true;
         up.event.consumeAction(event);
         return this.followLink(link);
       }
@@ -5347,18 +5358,19 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
       if (u.isMissing(raw)) {
 
       } else if (raw instanceof this.constructor) {
-        return (ref = this.entries).push.apply(ref, raw.entries);
+        (ref = this.entries).push.apply(ref, raw.entries);
       } else if (u.isArray(raw)) {
-        return (ref1 = this.entries).push.apply(ref1, raw);
+        (ref1 = this.entries).push.apply(ref1, raw);
       } else if (u.isString(raw)) {
-        return this.addAllFromQuery(raw);
+        this.addAllFromQuery(raw);
       } else if (u.isFormData(raw)) {
-        return this.addAllFromFormData(raw);
+        this.addAllFromFormData(raw);
       } else if (u.isObject(raw)) {
-        return this.addAllFromObject(raw);
+        this.addAllFromObject(raw);
       } else {
-        return up.fail("Unsupport params type: %o", raw);
+        up.fail("Unsupport params type: %o", raw);
       }
+      return this;
     };
 
     Params.prototype.addAllFromObject = function(object) {
@@ -5708,7 +5720,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     };
 
 
-    /**
+    /***
     Returns the given URL without its [query string](https://en.wikipedia.org/wiki/Query_string).
     
     \#\#\# Example
@@ -6951,7 +6963,7 @@ There are some advantages to using `up.on()`:
     for [event delegation](https://davidwalsh.name/event-delegate):
     
         var form = document.querySelector('form')
-        document.addEventListener(form, 'click', 'a', function(event, link) {
+        up.on(form, 'click', 'a', function(event, link) {
           console.log("Click on a link %o within %o", link, form)
         })
     
@@ -7263,14 +7275,22 @@ There are some advantages to using `up.on()`:
     };
 
     /***
-    Stops the given event from propagating and prevents the default action.
+    Prevents the event from bubbling up the DOM.
+    Also prevents other event handlers bound on the same element.
+    Also prevents the event's default action.
+    
+    \#\#\# Example
+    
+        up.on('click', 'link.disabled', function(event) {
+          up.event.halt(event)
+        })
     
     @function up.event.halt
-    @internal
+    @param {Event} event
+    @experimental
      */
     halt = function(event) {
       event.stopImmediatePropagation();
-      event.stopPropagation();
       return event.preventDefault();
     };
 
@@ -7579,7 +7599,7 @@ an existing cookie should be deleted.
       The parameter name can be configured as a string or as function that returns the parameter name.
       If no name is set, no token will be sent.
     
-      Defaults to the `content` attribute of a `<meta>` tag named `csrf-token`:
+      Defaults to the `content` attribute of a `<meta>` tag named `csrf-param`:
     
           <meta name="csrf-param" content="authenticity_token" />
     
@@ -8234,7 +8254,7 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     /***
     Registers a [compiler](/up.compiler) that is run before all other compilers.
     
-    Use `up.macro()` to register a compiler that sets multiply Unpoly attributes.
+    Use `up.macro()` to register a compiler that sets multiple Unpoly attributes.
     
     \#\#\# Example
     
@@ -8413,15 +8433,14 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
       var cleanables;
       cleanables = e.subtree(fragment, '.up-can-clean');
       return u.each(cleanables, function(cleanable) {
-        var destructor, destructors, i, len, results;
-        if (destructors = cleanable.upDestructors) {
-          results = [];
+        var destructor, destructors, i, len;
+        if (destructors = u.pluckKey(cleanable, 'upDestructors')) {
           for (i = 0, len = destructors.length; i < len; i++) {
             destructor = destructors[i];
-            results.push(destructor());
+            destructor();
           }
-          return results;
         }
+        return cleanable.classList.remove('up-can-clean');
       });
     };
 
@@ -9380,13 +9399,37 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
     
     The scroll positions will be associated with the current URL.
     They can later be restored by calling [`up.viewport.restoreScroll()`](/up.viewport.restoreScroll)
-    at the same URL.
+    at the same URL, or by following a link with an [`[up-restore-scroll]`](/a-up-follow#up-restore-scroll)
+    attribute.
+    
+    Unpoly automatically saves scroll positions before a [fragment update](/up.replace)
+    you will rarely need to call this function yourself.
+    
+    \#\#\# Examples
+    
+    Should you need to save the current scroll positions outside of a [fragment update](/up.replace),
+    you may call:
     
-    Unpoly automatically saves scroll positions whenever a fragment was updated on the page.
+        up.viewport.saveScroll()
+    
+    Instead of saving the current scroll positions for the current URL, you may also pass another
+    url or vertical scroll positionsfor each viewport:
+    
+        up.viewport.saveScroll({
+          url: '/inbox',
+          tops: {
+            'body': 0,
+            '.sidebar', 100,
+            '.main', 320
+          }
+        })
     
     @function up.viewport.saveScroll
     @param {string} [options.url]
+      The URL for which to save scroll positions.
+      If omitted, the current browser location is used.
     @param {Object<string, number>} [options.tops]
+      An object mapping viewport selectors to vertical scroll positions in pixels.
     @experimental
      */
     saveScroll = function(options) {
@@ -9767,7 +9810,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     
     \#\#\# Example
     
-    Let's say your curent HTML looks like this:
+    Let's say your current HTML looks like this:
     
         <div class="one">old one</div>
         <div class="two">old two</div>
@@ -10018,7 +10061,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     
     \#\#\# Example
     
-    Let's say your curent HTML looks like this:
+    Let's say your current HTML looks like this:
     
         <div class="one">old one</div>
         <div class="two">old two</div>
@@ -10568,7 +10611,11 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
         var parent;
         parent = element.parentNode;
         up.syntax.clean(element);
-        e.remove(element);
+        if (up.browser.canJQuery()) {
+          jQuery(element).remove();
+        } else {
+          e.remove(element);
+        }
         return emitFragmentDestroyed(element, {
           parent: parent,
           log: options.log
@@ -10593,7 +10640,8 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     @stable
      */
     markElementAsDestroying = function(element) {
-      return element.classList.add('up-destroying');
+      element.classList.add('up-destroying');
+      return element.setAttribute('aria-hidden', 'true');
     };
 
     /***
@@ -10789,7 +10837,7 @@ You can define custom animations using [`up.transition()`](/up.transition) and
     
     You can pass additional options:
     
-        up.animate('warning', '.fade-in', {
+        up.animate('.warning', 'fade-in', {
           delay: 1000,
           duration: 250,
           easing: 'linear'
@@ -12107,7 +12155,7 @@ This makes for an unfriendly experience:
 - State changes caused by AJAX updates get lost during the page transition.
 - Unsaved form changes get lost during the page transition.
 - The JavaScript VM is reset during the page transition.
-- If the page layout is composed from multiple srollable containers
+- If the page layout is composed from multiple scrollable containers
   (e.g. a pane view), the scroll positions get lost during the page transition.
 - The user sees a "flash" as the browser loads and renders the new page,
   even if large portions of the old and new page are the same (navigation, layout, etc.).
@@ -12831,7 +12879,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     @stable
      */
     config = new up.Config({
-      validateTargets: ['fieldset:has(&)', 'label:has(&)', 'form:has(&)'],
+      validateTargets: ['[up-fieldset]:has(&)', 'fieldset:has(&)', 'label:has(&)', 'form:has(&)'],
       fields: ['select', 'input:not([type=submit]):not([type=image])', 'button[type]:not([type=submit])', 'textarea'],
       submitButtons: ['input[type=submit]', 'input[type=image]', 'button[type=submit]', 'button:not([type])'],
       observeDelay: 0
@@ -12844,16 +12892,42 @@ open dialogs with sub-forms, etc. all without losing form state.
     @function up.form.fieldSelector
     @internal
      */
-    fieldSelector = function() {
-      return config.fields.join(',');
+    fieldSelector = function(suffix) {
+      if (suffix == null) {
+        suffix = '';
+      }
+      return config.fields.map(function(field) {
+        return field + suffix;
+      }).join(',');
     };
 
     /***
+    Returns a list of form fields within the given element.
+    
+    You can configure what Unpoly considers a form field by adding CSS selectors to the
+    [`up.form.config.fields`](/up.form.config#config.fields) array.
+    
+    If the given element is itself a form field, a list of that given element is returned.
+    
     @function up.form.fields
-    @internal
+    @param {Element|jQuery} root
+      The element to scan for contained form fields.
+    
+      If the element is itself a form field, a list of that element is returned.
+    @return {NodeList<Element>|Array<Element>}
+    @experimental
      */
     findFields = function(root) {
-      return e.subtree(root, fieldSelector());
+      var fields, outsideFieldSelector, outsideFields;
+      root = e.get(root);
+      fields = e.subtree(root, fieldSelector());
+      if (e.matches(root, 'form[id]')) {
+        outsideFieldSelector = fieldSelector(e.attributeSelector('form', root.id));
+        outsideFields = e.all(outsideFieldSelector);
+        fields.push.apply(fields, outsideFields);
+        fields = u.uniq(fields);
+      }
+      return fields;
     };
 
     /****
@@ -12980,6 +13054,9 @@ open dialogs with sub-forms, etc. all without losing form state.
       If set to `'auto'` (default), Unpoly will try to find a match in the form's layer.
     @param {string} [options.failLayer='auto']
       The name of the layer that ought to be updated if the server sends a non-200 status code.
+    @param {Object|FormData|string|Array|up.Params} [options.params]
+      Extra form [parameters](/up.Params) that will be submitted in addition to
+      the parameters from the form.
     @return {Promise}
       A promise for the successful form submission.
     @stable
@@ -13029,7 +13106,7 @@ open dialogs with sub-forms, etc. all without losing form state.
       if (options.failLayer == null) {
         options.failLayer = form.getAttribute('up-fail-layer');
       }
-      options.params = up.Params.fromForm(form);
+      options.params = up.Params.fromForm(form).addAll(options.params);
       options = u.merge(options, up.motion.animateOptions(options, form));
       if (options.validate) {
         options.headers || (options.headers = {});
@@ -13379,7 +13456,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     
     \#\#\# Redirects
     
-    Unpoly requires an additional response headers to detect redirects,
+    Unpoly requires an additional response header to detect redirects,
     which are otherwise undetectable for an AJAX client.
     
     After the form's action performs a redirect, the next response should echo
@@ -13614,7 +13691,19 @@ open dialogs with sub-forms, etc. all without losing form state.
       This defaults to a fieldset or form group around the validating field.
     @stable
      */
-    up.on('change', '[up-validate]', function(event, field) {
+
+    /***
+    Performs [server-side validation](/input-up-validate) when any fieldset within this form changes.
+    
+    You can configure what Unpoly considers a fieldset by adding CSS selectors to the
+    [`up.form.config.validateTargets`](/up.form.config#config.validateTargets) array.
+    
+    @selector form[up-validate]
+    @stable
+     */
+    up.on('change', '[up-validate]', function(event) {
+      var field;
+      field = findFields(event.target)[0];
       return u.muteRejection(validate(field));
     });
 
@@ -13732,18 +13821,16 @@ open dialogs with sub-forms, etc. all without losing form state.
     
     The programmatic variant of this is the [`up.observe()`](/up.observe) function.
     
-    \#\#\# Examples
+    \#\#\# Example
     
     The following would run a global `showSuggestions(value)` function
     whenever the `<input>` changes:
     
-        <form>
-          <input name="query" up-observe="showSuggestions(value)">
-        </form>
+        <input name="query" up-observe="showSuggestions(value)">
     
     \#\#\# Callback context
     
-    The script given to `up-observe` runs with the following context:
+    The script given to `[up-observe]` runs with the following context:
     
     | Name     | Type      | Description                           |
     | -------- | --------- | ------------------------------------- |
@@ -13751,6 +13838,20 @@ open dialogs with sub-forms, etc. all without losing form state.
     | `this`   | `Element` | The form field                        |
     | `$field` | `jQuery`  | The form field as a jQuery collection |
     
+    \#\#\# Observing radio buttons
+    
+    Multiple radio buttons with the same `[name]` (a radio button group)
+    produce a single value for the form.
+    
+    To observe radio buttons group, use the `[up-observe]` attribute on an
+    element that contains all radio button elements with a given name:
+    
+        <div up-observe="formatSelected(value)">
+          <input type="radio" name="format" value="html"> HTML format
+          <input type="radio" name="format" value="pdf"> PDF format
+          <input type="radio" name="format" value="txt"> Text format
+        </div>
+    
     @selector input[up-observe]
     @param {string} up-observe
       The code to run when the field's value changes.
@@ -13799,7 +13900,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     });
 
     /***
-    [Observes](/up.observe) this form field and submits the form when its value changes.
+    Submits this field's form when this field changes its values.
     
     Both the form and the changed field will be assigned a CSS class [`up-active`](/form-up-active)
     while the autosubmitted form is loading.
@@ -13815,6 +13916,20 @@ open dialogs with sub-forms, etc. all without losing form state.
           <input type="checkbox" name="archive"> Include archive
         </form>
     
+    \#\#\# Auto-submitting radio buttons
+    
+    Multiple radio buttons with the same `[name]` (a radio button group)
+    produce a single value for the form.
+    
+    To auto-submit radio buttons group, use the `[up-submit]` attribute on an
+    element that contains all radio button elements with a given name:
+    
+        <div up-autosubmit>
+          <input type="radio" name="format" value="html"> HTML format
+          <input type="radio" name="format" value="pdf"> PDF format
+          <input type="radio" name="format" value="txt"> Text format
+        </div>
+    
     @selector input[up-autosubmit]
     @param {string} up-delay
       The number of miliseconds to wait after a change before the form is submitted.
@@ -13822,7 +13937,7 @@ open dialogs with sub-forms, etc. all without losing form state.
      */
 
     /***
-    [Observes](/up.observe) this form and submits the form when *any* field changes.
+    Submits the form when *any* field changes.
     
     Both the form and the field will be assigned a CSS class [`up-active`](/form-up-active)
     while the autosubmitted form is loading.
@@ -14698,6 +14813,7 @@ or function.
       var closeElement, contentElement, dialogStyles, html, modalElement;
       html = templateHtml();
       state.modalElement = modalElement = e.createFromHtml(html);
+      modalElement.setAttribute('aria-modal', 'true');
       modalElement.setAttribute('up-flavor', state.flavor);
       if (u.isPresent(state.position)) {
         modalElement.setAttribute('up-position', state.position);
@@ -14736,7 +14852,7 @@ or function.
         var link = document.querySelector('a')
         up.modal.follow(link)
     
-    Any option attributes for [`a[up-modal]`](/a.up-modal) will be honored.
+    Any option attributes for [`a[up-modal]`](/a-up-modal) will be honored.
     
     Emits events [`up:modal:open`](/up:modal:open) and [`up:modal:opened`](/up:modal:opened).
     
@@ -14919,6 +15035,9 @@ or function.
       if (options.failLayer == null) {
         options.failLayer = (ref12 = link.getAttribute('up-fail-layer')) != null ? ref12 : 'auto';
       }
+      if (options.cache == null) {
+        options.cache = e.booleanAttr(link, 'up-cache');
+      }
       animateOptions = up.motion.animateOptions(options, link, {
         duration: flavorDefault('openDuration', options.flavor),
         easing: flavorDefault('openEasing', options.flavor)
@@ -15175,7 +15294,7 @@ or function.
     
     Clicking would request the path `/blog` and select `.blog-list` from
     the HTML response. Unpoly will dim the page
-    and place the matching `.blog-list` tag will be placed in
+    and place the matching `.blog-list` tag in
     a modal dialog.
     
     @selector a[up-modal]