unpoly-rails 0.32.0 → 0.33.0

data/lib/assets/javascripts/unpoly/{form.js.coffee → form.coffee}

@@ -17,7 +17,7 @@ up.form = (($) ->
 
   @property up.form.config
   @param {Number} [config.observeDelay=0]
-    The number of miliseconds to wait before [`up.observe`](/up.observe) runs the callback
+    The number of miliseconds to wait before [`up.observe()`](/up.observe) runs the callback
     after the input value changes. Use this to limit how often the callback
     will be invoked for a fast typist.
   @param {Array} [config.validateTargets=['[up-fieldset]:has(&)', 'fieldset:has(&)', 'label:has(&)', 'form:has(&)']]
@@ -67,11 +67,14 @@ up.form = (($) ->
     if none of these attributes are given.
   @param {String} [options.target]
     The selector to update when the form submission succeeds (server responds with status 200).
-    Defaults to the form's `up-target` attribute, or to `'body'`.
+    Defaults to the form's `up-target` attribute.
   @param {String} [options.failTarget]
     The selector to update when the form submission fails (server responds with non-200 status).
     Defaults to the form's `up-fail-target` attribute, or to an auto-generated
     selector that matches the form itself.
+  @param {String} [options.fallback]
+    The selector to update when the original target was not found in the page.
+    Defaults to the form's `up-fallback` attribute.
   @param {Boolean|String} [options.history=true]
     Successful form submissions will add a history entry and change the browser's
     location bar if the form either uses the `GET` method or the response redirected
@@ -85,11 +88,11 @@ up.form = (($) ->
     The transition to use when a failed form submission updates the `options.failTarget` selector.
     Defaults to the form's `up-fail-transition` attribute, or to `options.transition`, or to `'none'`.
   @param {Number} [options.duration]
-    The duration of the transition. See [`up.morph`](/up.morph).
+    The duration of the transition. See [`up.morph()`](/up.morph).
   @param {Number} [options.delay]
-    The delay before the transition starts. See [`up.morph`](/up.morph).
+    The delay before the transition starts. See [`up.morph()`](/up.morph).
   @param {String} [options.easing]
-    The timing function that controls the transition's acceleration. [`up.morph`](/up.morph).
+    The timing function that controls the transition's acceleration. [`up.morph()`](/up.morph).
   @param {Element|jQuery|String} [options.reveal]
     Whether to reveal the target element within its viewport.
   @param {Boolean} [options.restoreScroll]
@@ -117,6 +120,7 @@ up.form = (($) ->
     target = u.option(options.target, $form.attr('up-target'), 'body')
     url = u.option(options.url, $form.attr('action'), up.browser.url())
     options.failTarget = u.option(options.failTarget, $form.attr('up-fail-target')) || u.selectorForElement($form)
+    options.fallback = u.option(options.fallback, $form.attr('up-fallback'))
     options.history = u.option(options.history, u.castedAttr($form, 'up-history'), true)
     options.transition = u.option(options.transition, u.castedAttr($form, 'up-transition'), 'none')
     options.failTransition = u.option(options.failTransition, u.castedAttr($form, 'up-fail-transition'), 'none')
@@ -144,7 +148,7 @@ up.form = (($) ->
       unless canAjaxSubmit
         return u.unresolvablePromise()
 
-    up.navigation.start($form)
+    up.feedback.start($form)
 
     # If we can't submit this form via AJAX or if we wouldn't be able to change
     # the location URL as the result, fall back to a vanilla form submission.
@@ -153,7 +157,7 @@ up.form = (($) ->
       return u.unresolvablePromise()
 
     promise = up.replace(target, url, options)
-    promise.always -> up.navigation.stop($form)
+    promise.always -> up.feedback.stop($form)
     return promise
 
   ###*
@@ -179,10 +183,10 @@ up.form = (($) ->
 
   Making network requests whenever a form field changes can cause
   [concurrency issues](https://makandracards.com/makandra/961-concurrency-issues-with-find-as-you-type-boxes).
-  Since `up.observe` can trigger many requests in a short period of time,
+  Since `up.observe()` can trigger many requests in a short period of time,
   the responses might not arrive in the same order.
 
-  To mitigate this, `up.observe` will try to never run a callback
+  To mitigate this, `up.observe()` will try to never run a callback
   before the previous callback has completed.
   For this your callback code must return a promise that resolves
   when your request completes.
@@ -195,8 +199,8 @@ up.form = (($) ->
         return submitDone;
       });
   
-  Note that many Unpoly functions like [`up.submit`](/up.submit) or
-  [`up.replace`](/up.replace) return promises.
+  Note that many Unpoly functions like [`up.submit()`](/up.submit) or
+  [`up.replace()`](/up.replace) return promises.
 
   \#\#\# Debouncing
 
@@ -242,6 +246,8 @@ up.form = (($) ->
     callback = null
     rawCallback = u.option(callbackArg, u.presentAttr($fields, 'up-observe'))
     if u.isString(rawCallback)
+      console.debug("**** RAW CALLBACK IS %o", rawCallback)
+      # rawCallback = 'true'
       callback = (value, $field) -> eval(rawCallback)
     else
       callback = rawCallback or up.fail('up.observe: No change callback given')
@@ -305,7 +311,7 @@ up.form = (($) ->
   @param {String|Element|jQuery} selectorOrElement
     The field or form to observe.
   @param {Object} [options]
-    See options for [`up.observe`](/up.observe)
+    See options for [`up.observe()`](/up.observe)
   @return {Function}
     A destructor function that removes the observe watch when called.
   @stable
@@ -313,14 +319,14 @@ up.form = (($) ->
   autosubmit = (selectorOrElement, options) ->
     observe(selectorOrElement, options, (value, $field) ->
       $form = $field.closest('form')
-      up.navigation.start $field, -> submit($form)
+      up.feedback.start $field, -> submit($form)
     )
 
   resolveValidateTarget = ($field, options) ->
     target = u.option(options.target, $field.attr('up-validate'))
     if u.isBlank(target)
       target ||= u.detect(config.validateTargets, (defaultTarget) ->
-        resolvedDefault = up.flow.resolveSelector(defaultTarget, options.origin)
+        resolvedDefault = up.dom.resolveSelector(defaultTarget, options.origin)
         $field.closest(resolvedDefault).length
       )
     if u.isBlank(target)
@@ -333,7 +339,7 @@ up.form = (($) ->
   Performs a server-side validation of a form and update the form
   with validation messages.
 
-  `up.validate` submits the given field's form with an additional `X-Up-Validate`
+  `up.validate()` submits the given field's form with an additional `X-Up-Validate`
   HTTP header. Upon seeing this header, the server is expected to validate (but not save)
   the form submission and render a new copy of the form with validation errors.
 
@@ -465,7 +471,7 @@ up.form = (($) ->
   The server response is searched for the selector given in `up-target`.
   The selector content is then [replaced](/up.replace) in the current page.
 
-  The programmatic variant of this is the [`up.submit`](/up.submit) function.
+  The programmatic variant of this is the [`up.submit()`](/up.submit) function.
 
   \#\#\# Failed submission
 
@@ -528,6 +534,8 @@ up.form = (($) ->
     The selector to [replace](/up.replace) if the form submission is not successful (non-200 status code).
     If omitted, Unpoly will replace the `<form>` tag itself, assuming that the
     server has echoed the form with validation errors.
+  @param [up-fallback]
+    The selector to replace if the server responds with a non-200 status code.
   @param {String} [up-transition]
     The animation to use when the form is replaced after a successful submission.
   @param {String} [up-fail-transition]
@@ -563,11 +571,14 @@ up.form = (($) ->
     submit($form)
 
   ###*
-  When a form field with this attribute is changed,
-  the form is validated on the server and is updated with
-  validation messages.
+  When a form field with this attribute is changed, the form is validated on the server
+  and is updated with validation messages.
+
+  To validate the form, Unpoly will submit the form with an additional `X-Up-Validate` HTTP header.
+  When seeing this header, the server is expected to validate (but not save)
+  the form submission and render a new copy of the form with validation errors.
 
-  The programmatic variant of this is the [`up.validate`](/up.validate) function.
+  The programmatic variant of this is the [`up.validate()`](/up.validate) function.
 
   \#\#\# Example
 
@@ -608,7 +619,7 @@ up.form = (($) ->
 
   Whenever a field with `up-validate` changes, the form is POSTed to
   `/users` with an additional `X-Up-Validate` HTTP header.
-  Upon seeing this header, the server is expected to validate (but not save)
+  When seeing this header, the server is expected to validate (but not save)
   the form submission and render a new copy of the form with validation errors.
 
   In Ruby on Rails the processing action should behave like this:
@@ -663,7 +674,7 @@ up.form = (($) ->
   With the Bootstrap bindings, Unpoly will also look
   for a container with the `form-group` class.
 
-  You can change this default behavior by setting `up.config.validateTargets`:
+  You can change this default behavior by setting [`up.form.config.validateTargets`](/up.form.config#validateTargets):
 
       // Always update the entire form containing the current field ("&")
       up.form.config.validateTargets = ['form &']
@@ -788,7 +799,7 @@ up.form = (($) ->
 
   This is useful for observing text fields while the user is typing.
 
-  The programmatic variant of this is the [`up.observe`](/up.observe) function.
+  The programmatic variant of this is the [`up.observe()`](/up.observe) function.
 
   \#\#\# Example
 
@@ -824,7 +835,7 @@ up.form = (($) ->
   The form field will be assigned a CSS class [`up-active`](/up-active)
   while the autosubmitted form is processing.
 
-  The programmatic variant of this is the [`up.autosubmit`](/up.autosubmit) function.
+  The programmatic variant of this is the [`up.autosubmit()`](/up.autosubmit) function.
 
   \#\#\# Example
 

data/lib/assets/javascripts/unpoly/{history.js.coffee → history.coffee}

@@ -34,8 +34,8 @@ up.history = (($) ->
   Returns the previous URL in the browser history.
 
   Note that this will only work reliably for history changes that
-  were applied by [`up.history.push`](/up.history.replace) or
-  [`up.history.replace`](/up.history.replace).
+  were applied by [`up.history.push()`](/up.history.replace) or
+  [`up.history.replace()`](/up.history.replace).
 
   @function up.history.previousUrl
   @internal
@@ -77,8 +77,8 @@ up.history = (($) ->
   Unpoly will [`replace`](/up.replace) the document body with
   the body from that URL.
 
-  Note that functions like [`up.replace`](/up.replace) or
-  [`up.submit`](/up.submit) will automatically update the
+  Note that functions like [`up.replace()`](/up.replace) or
+  [`up.submit()`](/up.submit) will automatically update the
   browser's location bar for you.
 
   @function up.history.replace
@@ -96,8 +96,8 @@ up.history = (($) ->
   Unpoly will [`replace`](/up.replace) the document body with
   the body from that URL.
 
-  Note that functions like [`up.replace`](/up.replace) or
-  [`up.submit`](/up.submit) will automatically update the
+  Note that functions like [`up.replace()`](/up.replace) or
+  [`up.submit()`](/up.submit) will automatically update the
   browser's location bar for you.
 
   Emits events [`up:history:push`](/up:history:push) and [`up:history:pushed`](/up:history:pushed).
@@ -151,11 +151,11 @@ up.history = (($) ->
       up.log.group "Restoring URL %s", url, ->
         popSelector = config.popTargets.join(', ')
         up.replace popSelector, url,
-          history: false,
-          title: true,
+          history: false,     # don't push a new state
+          title: true,        # do extract the title from the response
           reveal: false,
           transition: 'none',
-          saveScroll: false # since the URL was already changed by the browser, don't save scroll state
+          saveScroll: false   # since the URL was already changed by the browser, don't save scroll state
           restoreScroll: config.restoreScroll
     else
       up.puts 'Ignoring a state not pushed by Unpoly (%o)', state
@@ -227,7 +227,6 @@ up.history = (($) ->
   up.on 'up:framework:reset', reset
 
   config: config
-  defaults: -> up.fail('up.history.defaults(...) no longer exists. Set values on he up.history.config property instead.')
   push: push
   replace: replace
   url: currentUrl

data/lib/assets/javascripts/unpoly/{layout.js.coffee → layout.coffee}

@@ -32,12 +32,15 @@ up.layout = (($) ->
   @param {Array} [config.fixedTop]
     An array of CSS selectors that find elements fixed to the
     top edge of the screen (using `position: fixed`).
+    See [`[up-fixed="top"]`](/up-fixed-top) for details.
   @param {Array} [config.fixedBottom]
     An array of CSS selectors that find elements fixed to the
     bottom edge of the screen (using `position: fixed`).
+    See [`[up-fixed="bottom"]`](/up-fixed-bottom) for details.
   @param {Array} [config.anchoredRight]
     An array of CSS selectors that find elements anchored to the
-    right edge of the screen (using `position: fixed` or `position: absolute`).
+    right edge of the screen (using `right:0` with `position: fixed` or `position: absolute`).
+    See [`[up-anchored="right"]`](/up-anchored-right) for details.
   @param {Number} [config.duration=0]
     The duration of the scrolling animation in milliseconds.
     Setting this to `0` will disable scrolling animations.
@@ -93,7 +96,7 @@ up.layout = (($) ->
         duration: 250
       });
 
-  If the given viewport is already in a scroll animation when `up.scroll`
+  If the given viewport is already in a scroll animation when `up.scroll()`
   is called a second time, the previous animation will instantly jump to the
   last frame before the next animation is started.
 
@@ -170,11 +173,11 @@ up.layout = (($) ->
       anchorPosition = $obstructor.css(cssAttr)
       unless u.isPresent(anchorPosition)
         up.fail("Fixed element %o must have a CSS attribute %s", $obstructor.get(0), cssAttr)
-      parseInt(anchorPosition) + $obstructor.height()
+      parseFloat(anchorPosition) + $obstructor.height()
 
     fixedTopBottoms = for obstructor in $(config.fixedTop.join(', '))
       measurePosition(obstructor, 'top')
-
+  
     fixedBottomTops = for obstructor in $(config.fixedBottom.join(', '))
       measurePosition(obstructor, 'bottom')
 
@@ -186,7 +189,7 @@ up.layout = (($) ->
   element are visible for the user.
 
   By default Unpoly will always reveal an element before
-  updating it with JavaScript functions like [`up.replace`](/up.replace)
+  updating it with JavaScript functions like [`up.replace()`](/up.replace)
   or UJS behavior like [`[up-target]`](/a-up-target).
 
   \#\#\# How Unpoly finds the viewport
@@ -204,9 +207,9 @@ up.layout = (($) ->
   Many applications have a navigation bar fixed to the top or bottom,
   obstructing the view on an element.
 
-  You can make `up.reveal` aware of these fixed elements
+  You can make `up.reveal()` aware of these fixed elements
   so it can scroll the viewport far enough so the revealed element is fully visible.
-  To make `up.reveal` aware fixed elements you can either:
+  To make `up.reveal()` aware fixed elements you can either:
 
   - give the element an attribute [`up-fixed="top"`](/up-fixed-top) or [`up-fixed="bottom"`](up-fixed-bottom)
   - [configure default options](/up.layout.config) for `fixedTop` or `fixedBottom`
@@ -258,7 +261,7 @@ up.layout = (($) ->
     predictFirstVisibleRow = -> newScrollPos + obstruction.top
     predictLastVisibleRow = -> newScrollPos + viewportHeight - obstruction.bottom - 1
 
-    elementDims = u.measure($element, relative: $viewport)
+    elementDims = u.measure($element, relative: $viewport, includeMargin: true)
     firstElementRow = elementDims.top + offsetShift
     lastElementRow = firstElementRow + Math.min(elementDims.height, config.substance) - 1
 
@@ -445,7 +448,7 @@ up.layout = (($) ->
   instead of scrolling `<body>`. As an alternative you can also push a selector
   matching your custom viewport to the [`up.layout.config.viewports`](/up.layout.config) array.
 
-  [`up.reveal`](/up.reveal) will always try to scroll the viewport closest
+  [`up.reveal()`](/up.reveal) will always try to scroll the viewport closest
   to the element that is being revealed. By default this is the `<body>` element.
 
   \#\#\# Example
@@ -492,11 +495,16 @@ up.layout = (($) ->
   ###
 
   ###*
-  Marks this element as a navigation fixed to the top edge of the screen
+  Marks this element as being fixed to the top edge of the screen
   using `position: fixed`.
 
-  [`up.reveal`](/up.reveal) is aware of fixed elements and will scroll
-  the viewport far enough so the revealed element is fully visible.
+  When [following a fragment link](/a-up-target), the viewport is scrolled
+  so the targeted element becomes visible. By using this attribute you can make
+  Unpoly aware of fixed elements that are obstructing the viewport contents.
+  Unpoly will then scroll the viewport far enough that the revealed element is fully visible.
+
+  Instead of using this attribute,
+  you can also configure a selector in [`up.layout.config.fixedTop`](/up.layout.config#fixedTop).
 
   \#\#\# Example
 
@@ -507,11 +515,16 @@ up.layout = (($) ->
   ###
 
   ###*
-  Marks this element as a navigation fixed to the bottom edge of the screen
+  Marks this element as being fixed to the bottom edge of the screen
   using `position: fixed`.
 
-  [`up.reveal`](/up.reveal) is aware of fixed elements and will scroll
-  the viewport far enough so the revealed element is fully visible.
+  When [following a fragment link](/a-up-target), the viewport is scrolled
+  so the targeted element becomes visible. By using this attribute you can make
+  Unpoly aware of fixed elements that are obstructing the viewport contents.
+  Unpoly will then scroll the viewport far enough that the revealed element is fully visible.
+
+  Instead of using this attribute,
+  you can also configure a selector in [`up.layout.config.fixedBottom`](/up.layout.config#fixedBottom).
 
   \#\#\# Example
 
@@ -523,15 +536,35 @@ up.layout = (($) ->
 
 
   ###*
-  Marks this element as a navigation anchored to the right edge of the screen
-  using `position: fixed` or `position:absolute`.
+  Marks this element as being anchored to the right edge of the screen,
+  typically fixed navigation bars.
+
+  Since [modal dialogs](/up.modal) hide the document scroll bar,
+  elements anchored to the right appear to jump when the dialog opens or
+  closes. Applying this attribute to anchored elements will make Unpoly
+  aware of the issue and adjust the `right` property accordingly.
+
+  You should give this attribute to layout elements
+  with a CSS of `right: 0` with `position: fixed` or `position:absolute`.
 
-  [`up.modal`](/up.modal) will move anchored elements to the left so they
-  don't appear to move when a modal dialog is opened or closed.
+  Instead of giving this attribute to any affected element,
+  you can also configure a selector in [`up.layout.config.anchoredRight`](/up.layout.config#anchoredRight).
 
   \#\#\# Example
 
-      <div class="bottom-nav" up-fixed="bottom">...</div>
+  Here is the CSS for a navigation bar that is anchored to the top edge of the screen:
+
+      .top-nav {
+         position: fixed;
+         top: 0;
+         left: 0;
+         right: 0;
+       }
+
+  By adding an `up-anchored="right"` attribute to the element, we can prevent the
+  `right` edge from jumping when a [modal dialog](/up.modal) opens or closes:
+
+      <div class="top-nav" up-anchored="right">...</div>
 
   @selector [up-anchored=right]
   @stable
@@ -544,7 +577,6 @@ up.layout = (($) ->
   scroll: scroll
   finishScrolling: finishScrolling
   config: config
-  defaults: -> up.fail('up.layout.defaults(...) no longer exists. Set values on he up.layout.config property instead.')
   viewportOf: viewportOf
   viewportsWithin: viewportsWithin
   viewports: viewports

data/lib/assets/javascripts/unpoly/{link.js.coffee → link.coffee}

@@ -1,8 +1,13 @@
 ###*
-Linking to page fragments
-=========================
+Linking to fragments
+====================
 
-Standard HTML links are a poor fit for modern applications:
+In a traditional web application, the entire page is destroyed and re-created when the
+user follows a link:
+
+![Traditional page flow](/images/tutorial/fragment_flow_vanilla.svg){:width="620px" class="picture has_border is_sepia has_padding"}
+
+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.
@@ -12,27 +17,21 @@ Standard HTML links are a poor fit for modern applications:
 - 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.).
 
-Unpoly fixes this by letting you annotate  links with an [`up-target`](/a-up-target)
+Unpoly fixes this by letting you annotate links with an [`up-target`](/a-up-target)
 attribute. The value of this attribute is a CSS selector that indicates which page
-fragment to update. The rest of the page will remain unchanged.
+fragment to update. The server **still renders full HTML pages**, but we only use
+the targeted ragments and discard the rest:
 
+![Unpoly page flow](/images/tutorial/fragment_flow_unpoly.svg){:width="620px" class="picture has_border is_sepia has_padding"}
 
-\#\#\# Example
+With this model, following links feel smooth. All transient DOM changes outside the updated fragment are preserved.
+Pages also load much faster since the DOM, CSS and Javascript environments do not need to be
+destroyed and recreated for every request.
 
-Let's say we are rendering three pages with a tabbed navigation to switch between screens:
 
+## Example
 
-```
-  /pages/a                /pages/b                /pages/c
-
-+---+---+---+           +---+---+---+           +---+---+---+
-| A | B | C |           | A | B | C |           | A | B | C |
-|   +--------  (click)  +---+   +----  (click)  +---+---+   |
-|           |  ======>  |           |  ======>  |           |
-|  Page A   |           |  Page B   |           |  Page C   |
-|           |           |           |           |           |
-+-----------|           +-----------|           +-----------|
-```
+Let's say we are rendering three pages with a tabbed navigation to switch between screens:
 
 Your HTML could look like this:
 
@@ -65,18 +64,6 @@ With these [`up-target`](/a-up-target) annotations Unpoly only updates the targe
 The JavaScript environment will persist and the user will not see a white flash while the
 new page is loading.
 
-
-\#\#\# Read on
-
-- You can [animate page transitions](/up.motion) by definining animations for fragments as they enter or leave the screen.
-- The `up-target` mechanism also works with [forms](/up.form).
-- As you switch through pages, Unpoly will [update your browser's location bar and history](/up.history)
-- You can [open fragments in popups or modal dialogs](/up.modal).
-- You can give users [immediate feedback](/up.navigation) when a link is clicked or becomes current, without waiting for the server.
-- [Controlling Unpoly pragmatically through JavaScript](/up.flow)
-- [Defining custom tags](/up.syntax)
-
-  
 @class up.link
 ###
 
@@ -99,7 +86,7 @@ up.link = (($) ->
   @param {String} [options.target='body']
     The selector to replace.
   @param {Object} [options]
-    See options for [`up.replace`](/up.replace)
+    See options for [`up.replace()`](/up.replace)
   @stable
   ###
   visit = (url, options) ->
@@ -132,6 +119,8 @@ up.link = (($) ->
   @param {String} [options.failTarget]
     The selector to replace if the server responds with a non-200 status code.
     Defaults to the `up-fail-target` attribute on `link`, or to `body` if such an attribute does not exist.
+  @param {String} [options.fallback]
+    The selector to update when the original target was not found in the page.
   @param {String} [options.method='get']
     The HTTP method to use for the request.
   @param {String} [options.confirm]
@@ -139,12 +128,14 @@ up.link = (($) ->
     before the link is followed.
   @param {Function|String} [options.transition]
     A transition function or name.
+  @param {Function|String} [options.failTransition]
+    The transition to use if the server responds with a non-200 status code.
   @param {Number} [options.duration]
-    The duration of the transition. See [`up.morph`](/up.morph).
+    The duration of the transition. See [`up.morph()`](/up.morph).
   @param {Number} [options.delay]
-    The delay before the transition starts. See [`up.morph`](/up.morph).
+    The delay before the transition starts. See [`up.morph()`](/up.morph).
   @param {String} [options.easing]
-    The timing function that controls the transition's acceleration. [`up.morph`](/up.morph).
+    The timing function that controls the transition's acceleration. [`up.morph()`](/up.morph).
   @param {Element|jQuery|String} [options.reveal]
     Whether to reveal the target  element within its viewport before updating.
   @param {Boolean} [options.restoreScroll]
@@ -157,6 +148,8 @@ up.link = (($) ->
   @param {Object} [options.headers={}]
     An object of additional header key/value pairs to send along
     with the request.
+  @param {Object} [options.timeout={}]
+    A timeout in milliseconds for the request.
   @param {String} [options.layer='auto']
     The name of the layer that ought to be updated. Valid values are
     `auto`, `page`, `modal` and `popup`.
@@ -175,8 +168,9 @@ up.link = (($) ->
     options = u.options(options)
 
     url = u.option($link.attr('up-href'), $link.attr('href'))
-    target = u.option(options.target, $link.attr('up-target'), 'body')
-    options.failTarget = u.option(options.failTarget, $link.attr('up-fail-target'), 'body')
+    target = u.option(options.target, $link.attr('up-target'))
+    options.failTarget = u.option(options.failTarget, $link.attr('up-fail-target'))
+    options.fallback = u.option(options.fallback, $link.attr('up-fallback'))
     options.transition = u.option(options.transition, u.castedAttr($link, 'up-transition'), 'none')
     options.failTransition = u.option(options.failTransition, u.castedAttr($link, 'up-fail-transition'), 'none')
     options.history = u.option(options.history, u.castedAttr($link, 'up-history'))
@@ -234,7 +228,7 @@ up.link = (($) ->
   onAction = (selector, handler) ->
     followVariantSelectors.push(selector)
     handlerWithActiveMark = ($link) ->
-      up.navigation.start $link, -> handler($link)
+      up.feedback.start $link, -> handler($link)
     up.on 'click', "a#{selector}, [up-href]#{selector}", (event, $link) ->
       if shouldProcessLinkEvent(event, $link)
         if $link.is('[up-instant]')
@@ -298,7 +292,7 @@ up.link = (($) ->
 
       <a href="/posts/5" up-target=".main, .unread-count">Read post</a>
 
-  \#\#\# Appending or prepending instead of replacing
+  \#\#\# Appending or prepending content
 
   By default Unpoly will replace the given selector with the same
   selector from a freshly fetched page. Instead of replacing you
@@ -342,6 +336,8 @@ up.link = (($) ->
   @param {String} [up-fail-transition='none']
     The [transition](/up.motion) to use for morphing between the old and new elements
     when the server responds with a non-200 status code.
+  @param {String} [up-fallback]
+    The selector to update when the original target was not found in the page.
   @param {String} [up-href]
     The destination URL to follow.
     If omitted, the the link's `href` attribute will be used.
@@ -421,10 +417,12 @@ up.link = (($) ->
 
   @param {String} [up-method='get']
     The HTTP method to use for the request.
-  @param {String} [up-transition='none']
-    The [transition](/up.motion) to use for morphing between the old and new elements.
   @param [up-fail-target='body']
     The selector to replace if the server responds with a non-200 status code.
+  @param {String} [up-fallback]
+    The selector to update when the original target was not found in the page.
+  @param {String} [up-transition='none']
+    The [transition](/up.motion) to use for morphing between the old and new elements.
   @param {String} [up-fail-transition='none']
     The [transition](/up.motion) to use for morphing between the old and new elements
     when the server responds with a non-200 status code.
@@ -512,6 +510,14 @@ up.link = (($) ->
         <a class="close" href="/records">Close</a>
       </div>
 
+  \#\#\# Limitations
+
+  Users will not be able to use the expanded area to open a context menu by right clicking,
+  or to open the link in a new tab.
+  To enable this, make the entire clickable area an actual `<a>` tag.
+  [It's OK to put block elements inside an anchor tag](https://makandracards.com/makandra/43549-it-s-ok-to-put-block-elements-inside-an-a-tag).
+
+
   @selector [up-expand]
   @param {String} [up-expand]
     A CSS selector that defines which containing link should be expanded.

data/lib/assets/javascripts/unpoly/{log.js.coffee → log.coffee}

@@ -53,7 +53,7 @@ up.log = (($) ->
   ###*
   Prints a debugging message to the browser console.
 
-  @function up.debug
+  @function up.log.debug
   @param {String} message
   @param {Array} args...
   @internal
@@ -79,7 +79,7 @@ up.log = (($) ->
   @internal
   ###
   warn = (message, args...) ->
-    if config.enabled && message
+    if message
       b.puts('warn', prefix(message), args...)
 
   ###*