render_async 2.1.2 → 2.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b91f800c218048a1e608c413909a1f9e55ae5a7ec450937d645f49526ac478c
-  data.tar.gz: a0675247df2c42dba16036c548e13f5443234724326e09ca2aa619cfa807f3bf
+  metadata.gz: 80f65d684e925ba32249eef7d5dd817b268b72dfebd0ecd9525fbe544d16af57
+  data.tar.gz: 46b675280ceb449a68953e9a2833332ff74222d773a3aa66ec95036d25587273
 SHA512:
-  metadata.gz: e26aa8dda9a9e5cfb9b4617999bc7a6a80671bb11ee0cb3d7519f8ad3d03e6154370bf46f95c4cd9eefa3ae23b1643a99014d5501a2ea8008c8ad760b7e59801
-  data.tar.gz: c4f3aa9fe15e413df9ea442c8c7bd778aee560ef87a2af16973645eb3db2bedac4e2b3c944f06c737cf2371b07e35576a57823da4942db2687a04c064f33e4bb
+  metadata.gz: 3bdd39f73528d3b9a8035ab5c8629b9c5261186f1d3eae2d5b82b856942c0ae602d5c670d96e009a240744fe5e7d93a97136298f05ef55c010f7d6f7972b4f40
+  data.tar.gz: a73351396f72b02895c03a4ff20068f096ae71279adc7345518d31e26111f63ac46b5b76424a24e566a7a0268f1748d1c1c364489e17d030dea12a691cc227eb

data/.all-contributorsrc

@@ -11,7 +11,7 @@
       "login": "nikolalsvk",
       "name": "Nikola Đuza",
       "avatar_url": "https://avatars2.githubusercontent.com/u/3028124?v=4",
-      "profile": "http://nikoladjuza.me/",
+      "profile": "https://nikolalsvk.github.io",
       "contributions": [
         "question",
         "code",
@@ -168,6 +168,43 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "fffx",
+      "name": "fangxing",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/11586335?v=4",
+      "profile": "https://github.com/fffx",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "lipsumar",
+      "name": "Emmanuel Pire",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1191418?v=4",
+      "profile": "http://blog.lipsumarium.com",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "maximgeerinck",
+      "name": "Maxim Geerinck",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/615509?v=4",
+      "profile": "https://github.com/maximgeerinck",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "vanboom",
+      "name": "Don",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/251706?v=4",
+      "profile": "https://github.com/vanboom",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "repoType": "github"

data/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: nikolalsvk
+tidelift: rubygems/render_async
+custom: "https://www.paypal.me/nikolalsvk/10"

data/CHANGELOG.md

@@ -1,8 +1,42 @@
-### 2.1.1 (2019/8/17)
+### 2.1.7 (2020/8/1)
+
+* [#125](https://github.com/renderedtext/render_async/pull/125): Implement retry after some time feature - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#124](https://github.com/renderedtext/render_async/pull/124): Add more info on how to control polling - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#123](https://github.com/renderedtext/render_async/pull/123): Simplify calling of start and stop event when interval is defined - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#119](https://github.com/renderedtext/render_async/pull/119): Add polling control start/stop events - [@vanboom](https://github.com/vanboom).
+* [#120](https://github.com/renderedtext/render_async/pull/120): Fine tune custom content_for feature - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#117](https://github.com/renderedtext/render_async/pull/117): Allow a custom content_for name - [@vanboom](https://github.com/vanboom).
+
+### 2.1.6 (2020/5/9)
+
+* [#114](https://github.com/renderedtext/render_async/pull/114): Call render_async logic if document state is ready or interactive - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#113](https://github.com/renderedtext/render_async/pull/113): Remove interval after Turbolinks visit event - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#112](https://github.com/renderedtext/render_async/pull/112): Add X-Requested-With header in Vanilla JS - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#110](https://github.com/renderedtext/render_async/pull/110): Remove preventDefault, and load toggle in stream - [@vanboom](https://github.com/vanboom).
+
+### 2.1.5 (2020/3/22)
+
+* [#105](https://github.com/renderedtext/render_async/pull/105): Load toggle listeners after page loads - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#104](https://github.com/renderedtext/render_async/pull/104): Attach container to dispatched events - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#103](https://github.com/renderedtext/render_async/pull/103): Add generic "load" and "error" events - [@lipsumar](https://github.com/lipsumar).
+* [#98](https://github.com/renderedtext/render_async/pull/98): Bump nonce pattern in the README to follow Rails CSP standard - [@colinxfleming](https://github.com/colinxfleming).
+
+### 2.1.4 (2019/11/11)
+
+* [#96](https://github.com/renderedtext/render_async/pull/96): Add once option to remove event once it's triggered #94 - [@fffx](https://github.com/fffx).
+
+### 2.1.3 (2019/9/24)
+
+* [#95](https://github.com/renderedtext/render_async/pull/95): Use double quotes for displaying error message - [@nikolalsvk](https://github.com/nikolalsvk).
+* [#93](https://github.com/renderedtext/render_async/pull/93): Fix: "Uncaught ReferenceError: \_interval" #92 - [@fffx](https://github.com/fffx).
+
+### 2.1.2 (2019/8/17)
+
 * [#89](https://github.com/renderedtext/render_async/pull/89): Bump version to 2.1.2 - [@nikolalsvk](https://github.com/nikolalsvk).
 * [#82](https://github.com/renderedtext/render_async/pull/88): When toggle true, do not fire `_renderAsyncFunc` on `turbolinks:load` - [@ThanhKhoaIT](https://github.com/ThanhKhoaIT).
 
 ### 2.1.1 (2019/8/17)
+
 * [#85](https://github.com/renderedtext/render_async/pull/85): Rename main JS function and support toggle feature with other features - [@nikolalsvk](https://github.com/nikolalsvk).
 * [#82](https://github.com/renderedtext/render_async/pull/82): Add toggle selector and event to render - [@ThanhKhoaIT](https://github.com/ThanhKhoaIT).
 * DEPRECATION WARNING - html_options is now a hash that you pass to render_async instead of an argument. If you passed for example a nonce: '21312aas...', you will need to pass

data/README.md

@@ -1,31 +1,70 @@
-[![Build Status](https://semaphoreci.com/api/v1/renderedtext/render_async/branches/master/shields_badge.svg)](https://semaphoreci.com/renderedtext/render_async)
-[![All Contributors](https://img.shields.io/badge/all_contributors-17-orange.svg?style=flat-square)](#contributors)
-[![Gem Version](https://badge.fury.io/rb/render_async.svg)](https://badge.fury.io/rb/render_async)
-[![Code Climate](https://codeclimate.com/github/renderedtext/render_async/badges/gpa.svg)](https://codeclimate.com/github/renderedtext/render_async)
-[![Test Coverage](https://codeclimate.com/github/renderedtext/render_async/badges/coverage.svg)](https://codeclimate.com/github/renderedtext/render_async/coverage)
-[![Help Contribute to Open Source](https://www.codetriage.com/renderedtext/render_async/badges/users.svg)](https://www.codetriage.com/renderedtext/render_async)
-
-![render_async](http://s2blog.wpengine.com/wp-content/uploads/assets/images/2017-06-08/speed-up-rendering-rails-pages-with-render-async.png)
-
-# render_async
-
-Speed up rendering Rails pages with this gem.
-
-`render_async` renders partials to your views **asynchronously**. This is done
-through adding JavaScript code that does AJAX request to your controller which
-then renders your partial into a Rails view.
-
-Workflow:
-
-1. user visits a Rails page
-2. AJAX request on the controller action
+<p align="center">
+  <img src='http://s2blog.wpengine.com/wp-content/uploads/assets/images/2017-06-08/speed-up-rendering-rails-pages-with-render-async.png' alt='render_async' />
+
+  <h1 align="center">👋 Welcome to render_async</h1>
+
+  <h3 align="center">Let's make your Rails pages fast again :racehorse:</h3>
+
+  <br />
+
+  <p align="center">
+    <a href="https://www.paypal.me/nikolalsvk/10" target="_blank">
+     <img src="https://img.shields.io/badge/$-support-green.svg" alt="Donate" />
+    </a>
+    <a href="https://rubygems.org/gems/render_async" target="_blank">
+      <img src="https://img.shields.io/gem/dt/render_async" alt="Downloads" />
+    </a>
+    <a href="#contributors" target="_blank">
+     <img src="https://img.shields.io/github/all-contributors/renderedtext/render_async" alt="All contributors" />
+    </a>
+    <a href="https://badge.fury.io/rb/render_async" target="_blank">
+     <img src="https://badge.fury.io/rb/render_async.svg" alt="Gem Version" />
+    </a>
+    <br />
+    <a href="https://discord.gg/SPfbeRm" target="_blank">
+      <img src="https://img.shields.io/discord/738783603214909521" alt="Discord Server" />
+    </a>
+    <a href="https://semaphoreci.com/renderedtext/render_async" target="_blank">
+     <img src="https://semaphoreci.com/api/v1/renderedtext/render_async/branches/master/shields_badge.svg" alt="Build Status" />
+    </a>
+    <a href="https://codeclimate.com/github/renderedtext/render_async" target="_blank">
+     <img src="https://img.shields.io/codeclimate/maintainability/renderedtext/render_async" alt="Code Climate Maintainablity" />
+    </a>
+    <a href="https://codeclimate.com/github/renderedtext/render_async/coverage" target="_blank">
+     <img src="https://img.shields.io/codeclimate/coverage/renderedtext/render_async" alt="Test Coverage" />
+    </a>
+    <a href="https://github.com/renderedtext/render_async/blob/master/LICENSE" target="_blank">
+      <img src="https://img.shields.io/github/license/renderedtext/render_async" alt="License" />
+    </a>
+    <a href="https://www.codetriage.com/renderedtext/render_async" target="_blank">
+     <img src="https://www.codetriage.com/renderedtext/render_async/badges/users.svg" alt="Help Contribute to Open Source" />
+    </a>
+  </p>
+</p>
+
+### `render_async` is here to make your pages show faster to users.
+
+Pages become faster seamlessly by rendering partials to your views.
+
+Partials render **asynchronously** and let users see your page **faster**
+than using regular rendering.
+
+It works with Rails and its tools out of the box.
+
+:sparkles:  A quick overview of how `render_async` does its magic:
+
+1. user visits a page
+2. `render_async` makes an AJAX request on the controller action
 3. controller renders a partial
-4. partials renders in the place where you put `render_async` helper
+4. partial renders in the place where you put `render_async` view helper
 
-JavaScript is injected into `<%= content_for :render_async %>` so you choose
+JavaScript is injected straight into `<%= content_for :render_async %>` so you choose
 where to put it.
 
-## Installation
+:mega:  P.S. Join our [Discord channel](https://discord.gg/SPfbeRm) for help and discussion, and let's make `render_async` even better!
+
+## :package: Installation
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -36,7 +75,7 @@ And then execute:
 
     $ bundle install
 
-## Usage
+## :hammer: Usage
 
 1. Include `render_async` view helper somewhere in your views (e.g. `app/views/comments/show.html.erb`):
     ```erb
@@ -69,7 +108,7 @@ And then execute:
     <%= content_for :render_async %>
     ```
 
-## Advanced usage
+## :hammer_and_wrench: Advanced usage
 
 Advanced usage includes information on different options, such as:
 
@@ -79,15 +118,20 @@ Advanced usage includes information on different options, such as:
   - [Passing in an HTML element name](#passing-in-an-html-element-name)
   - [Passing in a placeholder](#passing-in-a-placeholder)
   - [Passing in an event name](#passing-in-an-event-name)
+  - [Using default events](#using-default-events)
   - [Retry on failure](#retry-on-failure)
+    - [Retry after some time](#retry-after-some-time)
   - [Toggle event](#toggle-event)
+    - [Control polling with a toggle](#control-polling-with-a-toggle)
   - [Polling](#polling)
+  - [Controlled polling](#controlled-polling)
   - [Handling errors](#handling-errors)
   - [Caching](#caching)
   - [Doing non-GET requests](#doing-non-get-requests)
   - [Using with Turbolinks](#using-with-turbolinks)
   - [Using with respond_to and JS format](#using-with-respond_to-and-js-format)
   - [Nested Async Renders](#nested-async-renders)
+  - [Customizing the content_for name](#customizing-the-content_for-name)
   - [Configuration](#configuration)
 
 ### Passing in a container ID
@@ -133,21 +177,23 @@ Rendered code in the view:
 `html_options` is an optional hash that gets passed to a Rails'
 `javascript_tag`, to drop HTML tags into the `script` element.
 
-Example of utilizing `html_options` with a `nonce`:
+Example of utilizing `html_options` with a [nonce](https://edgeguides.rubyonrails.org/security.html#content-security-policy):
 ```erb
-<%= render_async users_path, html_options: { nonce: 'lWaaV6eYicpt+oyOfcShYINsz0b70iR+Q1mohZqNaag=' } %>
+<%= render_async users_path, html_options: { nonce: true } %>
 ```
 
 Rendered code in the view:
 ```html
-<div id="render_async_18b8a6cd161499117471">
-</div>
-
-<script nonce="lWaaV6eYicpt+oyOfcShYINsz0b70iR+Q1mohZqNaag=">
+<script nonce="2x012CYGxKgM8qAApxRHxA==">
 //<![CDATA[
   ...
 //]]>
 </script>
+
+...
+
+<div id="render_async_18b8a6cd161499117471" class="">
+</div>
 ```
 
 ### Passing in an HTML element name
@@ -207,6 +253,9 @@ event after it's done with fetching and rendering request content to HTML.
 This can be useful to have if you want to add some JavaScript functionality
 after your partial is loaded through `render_async`.
 
+You can also access the associated container (DOM node) in the event object
+that gets emitted.
+
 Example of passing it to `render_async`:
 ```erb
 <%= render_async users_path, event_name: "users-loaded" %>
@@ -226,15 +275,47 @@ Rendered code in view:
 </script>
 ```
 
-Then, in your JS, you could do something like this:
+Then, in your JavaScript code, you could do something like this:
 ```javascript
-document.addEventListener("users-loaded", function() {
-  console.log("Users have loaded!");
+document.addEventListener("users-loaded", function(event) {
+  console.log("Users have loaded!", event.container); // Access the container which loaded the users
 });
 ```
 
-NOTE: Dispatching events is also supported for older browsers that don't
-support Event constructor.
+> :bulb: Dispatching events is also supported for older browsers that don't support Event constructor.
+
+### Using default events
+
+`render_async` will fire the event `render_async_load` when an async partial
+has loaded and rendered on page.
+
+In case there is an error, the event `render_async_error` will fire instead.
+
+This event will fire for all `render_async` partials on the page. For every
+event, the associated container (DOM node) will be passed along.
+
+This can be useful to apply JavaScript to content loaded after the page is
+ready.
+
+Example of using events:
+
+```js
+// Vanilla javascript
+document.addEventListener('render_async_load', function(event) {
+  console.log('Async partial loaded in this container:', event.container);
+});
+document.addEventListener('render_async_error', function(event) {
+  console.log('Async partial could not load in this container:', event.container);
+});
+
+// with jQuery
+$(document).on('render_async_load', function(event) {
+  console.log('Async partial loaded in this container:', event.container);
+});
+$(document).on('render_async_error', function(event) {
+  console.log('Async partial could not load in this container:', event.container);
+});
+```
 
 ### Retry on failure
 
@@ -246,13 +327,46 @@ this:
 <%= render_async users_path, retry_count: 5, error_message: "Couldn't fetch it" %>
 ```
 
-Now render_async will retry `users_path` for 5 times. If it succedes in
+Now render_async will retry `users_path` for 5 times. If it succeeds in
 between, it will stop with dispatching requests. If it fails after 5 times,
 it will show an [error message](#handling-errors) which you need to specify.
 
 This can show useful when you know your requests often fail, and you don't want
 to refresh the whole page just to retry them.
 
+#### Retry after some time
+
+If you want to retry requests but with some delay in between the calls, you can
+pass a `retry_delay` option together with `retry_count` like so:
+
+```erb
+<%= render_async users_path,
+                 retry_count: 5,
+                 retry_delay: 2000 %>
+```
+
+This will make `render_async` wait for 2 seconds before retrying after each
+failure. In the end, if the request is still failing after 5th time, it will
+dispatch a [default error event](#using-default-events).
+
+> :candy:  If you are catching an event after an error, you can get `retryCount` from
+the event. `retryCount` will have number of retries it took before the event was dispatched.
+
+Here is an example on how to get `retryCount`:
+
+```erb
+<%= render_async users_path,
+                 retry_count: 5,
+                 retry_delay: 2000,
+                 error_event_name: 'it-failed-badly' %>
+
+<script>
+  document.addEventListener('it-failed-badly', function(event) {
+    console.log("Request failed after " + event.retryCount + " tries!")
+  });
+</script>
+```
+
 ### Toggle event
 
 You can trigger `render_async` loading by clicking or doing another event to a
@@ -262,29 +376,33 @@ default event that will trigger `render_async` will be 'click' event. You can
 do this by doing the following:
 
 ```erb
-<a href='#' id='detail-button'>Detail</a>
-<%= render_async comments_path, toggle: { selector: '#detail-button', event: :click } %>
+<a href='#' id='comments-button'>Load comments</a>
+<%= render_async comments_path, toggle: { selector: '#comments-button', event: :click } %>
 ```
 
-This will trigger `render_async` to load the `comments_path` when you click the `#details-button` element.
+This will trigger `render_async` to load the `comments_path` when you click the `#comments-button` element.
+If you want to remove event once it's triggered, you can pass `once: true` in the toggle options.
+The `once` option is false by default.
 
 You can also pass in a placeholder before the `render_async` is triggered. That
 way, the element that started `render_async` logic will be removed after the
 request has been completed. You can achieve this behaviour with something like this:
 
 ```erb
-<%= render_async comments_path, toggle: { selector: '#detail-button', event: :click } do %>
-  <a href='#' id='detail-button'>Detail</a>
+<%= render_async comments_path, toggle: { selector: '#comments-button', event: :click } do %>
+  <a href='#' id='comments-button'>Load comments</a>
 <% end %>
 ```
 
+#### Control polling with a toggle
+
 Also, you can mix interval and toggle features. This way, you can turn polling
-on, and off by clicking the "Detail" button. In order to do this, you need to
+on, and off by clicking the "Load comments" button. In order to do this, you need to
 pass `toggle` and `interval` arguments to `render_async` call like this:
 
 ```erb
-<a href='#' id='detail-button'>Detail</a>
-<%= render_async comments_path, toggle: { selector: '#detail-button', event: :click }, interval: 2000 %>
+<a href='#' id='comments-button'>Load comments</a>
+<%= render_async comments_path, toggle: { selector: '#comments-button', event: :click }, interval: 2000 %>
 ```
 
 ### Polling
@@ -300,11 +418,61 @@ You are telling `render_async` to fetch comments_path every 5 seconds.
 
 This can be handy if you want to enable polling for a specific URL.
 
-NOTE: By passing interval to `render_async`, initial container element
-will remain in HTML tree, it will not be replaced with request response.
-You can handle how that container element is rendered and its style by
-[passing in an HTML element name](#passing-in-an-html-element-name) and
-[HTML element class](#passing-in-a-container-class-name).
+> :warning:  By passing interval to `render_async`, initial container element
+> will remain in HTML tree, it will not be replaced with request response.
+> You can handle how that container element is rendered and its style by
+> [passing in an HTML element name](#passing-in-an-html-element-name) and
+> [HTML element class](#passing-in-a-container-class-name).
+
+### Controlled polling
+
+You can controller `render_async` [polling](#polling) in 2 manners.
+First one is pretty simple, and it involves using the [toggle](#toggle-event)
+feature. To do this, you can follow instructions in the
+[control polling with a toggle section](#control-polling-with-a-toggle).
+
+Second option is more advanced and it involves emitting events to the `render_async`'s
+container element. From your code, you can emit following events:
+  - 'async-stop' - this will stop polling
+  - 'async-start' - this will start polling.
+
+> :bulb:  Please note that events need to be dispatched to a render_async container.
+
+An example of how you can do this looks like this:
+
+```erb
+<%= render_async wave_render_async_path,
+                 container_id: 'controllable-interval', # set container_id so we can get it later easily
+                 interval: 3000 %>
+
+<button id='stop-polling'>Stop polling</button>
+<button id='start-polling'>Start polling</button>
+
+<script>
+  var container = document.getElementById('controllable-interval')
+  var stopPolling = document.getElementById('stop-polling')
+  var startPolling = document.getElementById('start-polling')
+
+  var triggerEventOnContainer = function(eventName) {
+    var event = new Event(eventName);
+
+    container.dispatchEvent(event)
+  }
+
+  stopPolling.addEventListener('click', function() {
+    container.innerHTML = '<p>Polling stopped</p>'
+    triggerEventOnContainer('async-stop')
+  })
+  startPolling.addEventListener('click', function() {
+    triggerEventOnContainer('async-start')
+  })
+</script>
+```
+
+We are rendering two buttons - "Stop polling" and "Start polling". Then, we
+attach event listener to catch any clicking on the buttons. When the buttons
+are clicked, we either stop the polling, or start the polling, depending which
+button a user clicks.
 
 ### Handling errors
 
@@ -354,10 +522,10 @@ Then, in the partial (e.g. `app/views/comments/_comment_stats.html.erb`):
 <% end %>
 ```
 
-* The first time the page renders, it will make the AJAX call.
-* Any other times (until the cache expires), it will render from cache
+- The first time the page renders, it will make the AJAX call.
+- Any other times (until the cache expires), it will render from cache
   instantly, without making the AJAX call.
-* You can expire cache simply by passing `:expires_in` in your view where
+- You can expire cache simply by passing `:expires_in` in your view where
   you cache the partial
 
 ### Doing non-GET requests
@@ -386,7 +554,7 @@ away from, and then back to, a page with a `render_async` call on it. This will
 likely show up as an empty div.
 
 If you're using Turbolinks 5 or higher, you can resolve this by setting Turbolinks
-configurtion of `render_async` to true:
+configuration of `render_async` to true:
 
 ```rb
 RenderAsync.configure do |config|
@@ -406,7 +574,7 @@ If you want, you can tell Turbolinks to reload your `render_async` call as follo
 
 This will reload the whole page with Turbolinks.
 
-Make sure to put `<%= content_for :render_async %>` in your base view file in
+> :bulb:  Make sure to put `<%= content_for :render_async %>` in your base view file in
 the `<head>` and not the `<body>`.
 
 ### Using with respond_to and JS format
@@ -464,6 +632,19 @@ For example:
 <%= content_for :render_async %>
 ```
 
+### Customizing the content_for name
+
+The `content_for` name may be customized by passing the `content_for_name`
+option to `render_async`. This option is especially useful when doing [nested async
+renders](#nested-async-renders) to better control the location of the injected JavaScript.
+
+For example:
+```erb
+<%= render_async comment_stats_path, content_for_name: :render_async_comment_stats %>
+
+<%= content_for :render_async_comment_stats %>
+```
+
 ### Configuration
 
 `render_async` renders Vanilla JS (regular JavaScript, non-jQuery code)
@@ -487,17 +668,28 @@ Also, you can do it like this:
 RenderAsync.configuration.jquery = true
 ```
 
-## Development
+## :hammer_and_pick: Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run
 `rake spec` to run the tests. You can also run `bin/console` for an interactive
-prompt that will allow you to experiment.
+prompt that will allow you to experiment. To run integration tests, use
+`bin/integration-tests`.
+
+Got any questions or comments about development (or anything else)?
+Join [render_async's Discord channel](https://discord.gg/SPfbeRm)
+and let's make `render_async` even better!
+
+## :pray: Contributing
 
-## Contributing
+Thank you for considering or deciding to contribute, this is much appreciated!
+Any kind of bug reports and pull requests are encouraged and welcome on GitHub at
+https://github.com/renderedtext/render_async.
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/renderedtext/render_async.
+Got any issues or difficulties?
+Join [render_async's Discord channel](https://discord.gg/SPfbeRm)
+and let's make `render_async` even better!
 
-## License
+## :memo: License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
 
@@ -507,10 +699,10 @@ Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds
 
 <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
 <!-- prettier-ignore -->
-| [<img src="https://avatars2.githubusercontent.com/u/3028124?v=4" width="100px;"/><br /><sub><b>Nikola Đuza</b></sub>](http://nikoladjuza.me/)<br />[💬](#question-nikolalsvk "Answering Questions") [💻](https://github.com/renderedtext/render_async/commits?author=nikolalsvk "Code") [📖](https://github.com/renderedtext/render_async/commits?author=nikolalsvk "Documentation") [👀](#review-nikolalsvk "Reviewed Pull Requests") | [<img src="https://avatars0.githubusercontent.com/u/3866868?v=4" width="100px;"/><br /><sub><b>Colin</b></sub>](http://www.colinxfleming.com)<br />[💻](https://github.com/renderedtext/render_async/commits?author=colinxfleming "Code") [📖](https://github.com/renderedtext/render_async/commits?author=colinxfleming "Documentation") [💡](#example-colinxfleming "Examples") | [<img src="https://avatars2.githubusercontent.com/u/334273?v=4" width="100px;"/><br /><sub><b>Kasper Grubbe</b></sub>](http://kaspergrubbe.com)<br />[💻](https://github.com/renderedtext/render_async/commits?author=kaspergrubbe "Code") | [<img src="https://avatars2.githubusercontent.com/u/163584?v=4" width="100px;"/><br /><sub><b>Sai Ram Kunala</b></sub>](https://sairam.xyz/)<br />[📖](https://github.com/renderedtext/render_async/commits?author=sairam "Documentation") | [<img src="https://avatars2.githubusercontent.com/u/3065882?v=4" width="100px;"/><br /><sub><b>Josh Arnold</b></sub>](https://github.com/nightsurge)<br />[💻](https://github.com/renderedtext/render_async/commits?author=nightsurge "Code") [📖](https://github.com/renderedtext/render_async/commits?author=nightsurge "Documentation") | [<img src="https://avatars3.githubusercontent.com/u/107798?v=4" width="100px;"/><br /><sub><b>Elad Shahar</b></sub>](https://eladshahar.com)<br />[💻](https://github.com/renderedtext/render_async/commits?author=SaladFork "Code") [💡](#example-SaladFork "Examples") | [<img src="https://avatars3.githubusercontent.com/u/232392?v=4" width="100px;"/><br /><sub><b>Sasha</b></sub>](http://www.revzin.co.il)<br />[💻](https://github.com/renderedtext/render_async/commits?author=sasharevzin "Code") [📖](https://github.com/renderedtext/render_async/commits?author=sasharevzin "Documentation") |
+| [<img src="https://avatars2.githubusercontent.com/u/3028124?v=4" width="100px;"/><br /><sub><b>Nikola Đuza</b></sub>](https://nikolalsvk.github.io)<br />[💬](#question-nikolalsvk "Answering Questions") [💻](https://github.com/renderedtext/render_async/commits?author=nikolalsvk "Code") [📖](https://github.com/renderedtext/render_async/commits?author=nikolalsvk "Documentation") [👀](#review-nikolalsvk "Reviewed Pull Requests") | [<img src="https://avatars0.githubusercontent.com/u/3866868?v=4" width="100px;"/><br /><sub><b>Colin</b></sub>](http://www.colinxfleming.com)<br />[💻](https://github.com/renderedtext/render_async/commits?author=colinxfleming "Code") [📖](https://github.com/renderedtext/render_async/commits?author=colinxfleming "Documentation") [💡](#example-colinxfleming "Examples") | [<img src="https://avatars2.githubusercontent.com/u/334273?v=4" width="100px;"/><br /><sub><b>Kasper Grubbe</b></sub>](http://kaspergrubbe.com)<br />[💻](https://github.com/renderedtext/render_async/commits?author=kaspergrubbe "Code") | [<img src="https://avatars2.githubusercontent.com/u/163584?v=4" width="100px;"/><br /><sub><b>Sai Ram Kunala</b></sub>](https://sairam.xyz/)<br />[📖](https://github.com/renderedtext/render_async/commits?author=sairam "Documentation") | [<img src="https://avatars2.githubusercontent.com/u/3065882?v=4" width="100px;"/><br /><sub><b>Josh Arnold</b></sub>](https://github.com/nightsurge)<br />[💻](https://github.com/renderedtext/render_async/commits?author=nightsurge "Code") [📖](https://github.com/renderedtext/render_async/commits?author=nightsurge "Documentation") | [<img src="https://avatars3.githubusercontent.com/u/107798?v=4" width="100px;"/><br /><sub><b>Elad Shahar</b></sub>](https://eladshahar.com)<br />[💻](https://github.com/renderedtext/render_async/commits?author=SaladFork "Code") [💡](#example-SaladFork "Examples") | [<img src="https://avatars3.githubusercontent.com/u/232392?v=4" width="100px;"/><br /><sub><b>Sasha</b></sub>](http://www.revzin.co.il)<br />[💻](https://github.com/renderedtext/render_async/commits?author=sasharevzin "Code") [📖](https://github.com/renderedtext/render_async/commits?author=sasharevzin "Documentation") |
 | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
 | [<img src="https://avatars3.githubusercontent.com/u/50223?v=4" width="100px;"/><br /><sub><b>Ernest Surudo</b></sub>](http://elsurudo.com)<br />[💻](https://github.com/renderedtext/render_async/commits?author=elsurudo "Code") | [<img src="https://avatars1.githubusercontent.com/u/334809?v=4" width="100px;"/><br /><sub><b>Kurtis Rainbolt-Greene</b></sub>](https://kurtis.rainbolt-greene.online)<br />[💻](https://github.com/renderedtext/render_async/commits?author=krainboltgreene "Code") | [<img src="https://avatars2.githubusercontent.com/u/59744?v=4" width="100px;"/><br /><sub><b>Richard Schneeman</b></sub>](https://www.schneems.com)<br />[📖](https://github.com/renderedtext/render_async/commits?author=schneems "Documentation") | [<img src="https://avatars1.githubusercontent.com/u/75705?v=4" width="100px;"/><br /><sub><b>Richard Venneman</b></sub>](https://www.cityspotters.com)<br />[📖](https://github.com/renderedtext/render_async/commits?author=richardvenneman "Documentation") | [<img src="https://avatars3.githubusercontent.com/u/381395?v=4" width="100px;"/><br /><sub><b>Filipe W. Lima</b></sub>](https://github.com/filipewl)<br />[📖](https://github.com/renderedtext/render_async/commits?author=filipewl "Documentation") | [<img src="https://avatars0.githubusercontent.com/u/3135638?v=4" width="100px;"/><br /><sub><b>Jesús Eduardo Clemens Chong</b></sub>](https://github.com/eclemens)<br />[💻](https://github.com/renderedtext/render_async/commits?author=eclemens "Code") | [<img src="https://avatars3.githubusercontent.com/u/1935686?v=4" width="100px;"/><br /><sub><b>René Klačan</b></sub>](https://github.com/reneklacan)<br />[💻](https://github.com/renderedtext/render_async/commits?author=reneklacan "Code") |
-| [<img src="https://avatars1.githubusercontent.com/u/1313442?v=4" width="100px;"/><br /><sub><b>Gil Gomes</b></sub>](http://gilgomes.com.br)<br />[📖](https://github.com/renderedtext/render_async/commits?author=gil27 "Documentation") | [<img src="https://avatars0.githubusercontent.com/u/6081795?v=4" width="100px;"/><br /><sub><b>Khoa Nguyen</b></sub>](https://github.com/ThanhKhoaIT)<br />[💻](https://github.com/renderedtext/render_async/commits?author=ThanhKhoaIT "Code") [📖](https://github.com/renderedtext/render_async/commits?author=ThanhKhoaIT "Documentation") | [<img src="https://avatars2.githubusercontent.com/u/8645918?v=4" width="100px;"/><br /><sub><b>Preet Sethi</b></sub>](https://www.linkedin.com/in/preetsethila/)<br />[💻](https://github.com/renderedtext/render_async/commits?author=preetsethi "Code") |
+| [<img src="https://avatars1.githubusercontent.com/u/1313442?v=4" width="100px;"/><br /><sub><b>Gil Gomes</b></sub>](http://gilgomes.com.br)<br />[📖](https://github.com/renderedtext/render_async/commits?author=gil27 "Documentation") | [<img src="https://avatars0.githubusercontent.com/u/6081795?v=4" width="100px;"/><br /><sub><b>Khoa Nguyen</b></sub>](https://github.com/ThanhKhoaIT)<br />[💻](https://github.com/renderedtext/render_async/commits?author=ThanhKhoaIT "Code") [📖](https://github.com/renderedtext/render_async/commits?author=ThanhKhoaIT "Documentation") | [<img src="https://avatars2.githubusercontent.com/u/8645918?v=4" width="100px;"/><br /><sub><b>Preet Sethi</b></sub>](https://www.linkedin.com/in/preetsethila/)<br />[💻](https://github.com/renderedtext/render_async/commits?author=preetsethi "Code") | [<img src="https://avatars3.githubusercontent.com/u/11586335?v=4" width="100px;"/><br /><sub><b>fangxing</b></sub>](https://github.com/fffx)<br />[💻](https://github.com/renderedtext/render_async/commits?author=fffx "Code") | [<img src="https://avatars3.githubusercontent.com/u/1191418?v=4" width="100px;"/><br /><sub><b>Emmanuel Pire</b></sub>](http://blog.lipsumarium.com)<br />[💻](https://github.com/renderedtext/render_async/commits?author=lipsumar "Code") [📖](https://github.com/renderedtext/render_async/commits?author=lipsumar "Documentation") | [<img src="https://avatars1.githubusercontent.com/u/615509?v=4" width="100px;"/><br /><sub><b>Maxim Geerinck</b></sub>](https://github.com/maximgeerinck)<br />[💻](https://github.com/renderedtext/render_async/commits?author=maximgeerinck "Code") | [<img src="https://avatars1.githubusercontent.com/u/251706?v=4" width="100px;"/><br /><sub><b>Don</b></sub>](https://github.com/vanboom)<br />[💻](https://github.com/renderedtext/render_async/commits?author=vanboom "Code") |
 <!-- ALL-CONTRIBUTORS-LIST:END -->
 
 This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind welcome!

data/app/views/render_async/_render_async.html.erb

@@ -5,38 +5,30 @@
   <%= placeholder %>
 </<%= html_element_name %>>
 
-<% content_for :render_async do %>
+<% content_for content_for_name do %>
   <%= javascript_tag html_options do %>
+    <% locals = { container_id: container_id,
+                  path: path,
+                  method: method,
+                  data: data,
+                  event_name: event_name,
+                  toggle: toggle,
+                  headers: headers,
+                  error_message: error_message,
+                  error_event_name: error_event_name,
+                  retry_count: retry_count,
+                  retry_delay: retry_delay,
+                  interval: interval,
+                  turbolinks: RenderAsync.configuration.turbolinks } %>
+
     <% if RenderAsync.configuration.jquery %>
       <%= render partial: 'render_async/request_jquery',
                  formats: [:js],
-                 locals:  { container_id: container_id,
-                            path: path,
-                            method: method,
-                            data: data,
-                            event_name: event_name,
-                            toggle: toggle,
-                            headers: headers,
-                            error_message: error_message,
-                            error_event_name: error_event_name,
-                            retry_count: retry_count,
-                            interval: interval,
-                            turbolinks: RenderAsync.configuration.turbolinks } %>
+                 locals:  locals  %>
     <% else %>
       <%= render partial: 'render_async/request_vanilla',
                  formats: [:js],
-                 locals:  { container_id: container_id,
-                            path: path,
-                            method: method,
-                            data: data,
-                            event_name: event_name,
-                            toggle: toggle,
-                            headers: headers,
-                            error_message: error_message,
-                            error_event_name: error_event_name,
-                            retry_count: retry_count,
-                            interval: interval,
-                            turbolinks: RenderAsync.configuration.turbolinks } %>
+                 locals:  locals %>
     <% end %>
   <% end %>
 <% end %>

data/app/views/render_async/_request_jquery.js.erb

@@ -5,8 +5,32 @@ if (window.jQuery) {
       return;
     }
     <% end %>
+    function createEvent(name, container) {
+      var event = undefined;
+      if (typeof(Event) === 'function') {
+        event = new Event(name);
+      } else {
+        event = document.createEvent('Event');
+        event.initEvent(name, true, true);
+      }
+      event.container = container
+      return event;
+    }
+
+    function _runAfterDocumentLoaded(callback) {
+      if (document.readyState === 'complete' || document.readyState === 'interactive') {
+        // Handle a case where nested partials get loaded after the document loads
+        callback();
+      } else {
+        <% if turbolinks %>
+        $(document).one('turbolinks:load', callback);
+        <% else %>
+        $(document).ready(callback);
+        <% end %>
+      }
+    }
 
-    var _makeRequest = function(currentRetryCount) {
+    function _makeRequest(currentRetryCount) {
       var headers = <%= headers.to_json.html_safe %>;
       var csrfTokenElement = document.querySelector('meta[name="csrf-token"]')
       if (csrfTokenElement)
@@ -18,21 +42,19 @@ if (window.jQuery) {
         data: "<%= escape_javascript(data.to_s.html_safe) %>",
         headers: headers
       }).done(function(response) {
+        var container = $("#<%= container_id %>");
         <% if interval %>
-          $("#<%= container_id %>").empty();
-          $("#<%= container_id %>").append(response);
+          container.empty();
+          container.append(response);
         <% else %>
-          $("#<%= container_id %>").replaceWith(response);
+          container.replaceWith(response);
         <% end %>
 
+        var loadEvent = createEvent('render_async_load', container);
+        document.dispatchEvent(loadEvent);
+
         <% if event_name.present? %>
-          var event = undefined;
-          if (typeof(Event) === 'function') {
-            event = new Event("<%= event_name %>");
-          } else {
-            event = document.createEvent('Event');
-            event.initEvent('<%= event_name %>', true, true);
-          }
+          var event = createEvent("<%= event_name %>", container)
           document.dispatchEvent(event);
         <% end %>
       }).fail(function(response) {
@@ -43,64 +65,93 @@ if (window.jQuery) {
 
         if (skipErrorMessage) return;
 
-        $("#<%= container_id %>").replaceWith('<%= error_message.try(:html_safe) %>');
+        var container = $("#<%= container_id %>");
+        container.replaceWith("<%= error_message.try(:html_safe) %>");
 
-        <% if error_event_name.present? %>
-          var event = undefined;
-          if (typeof(Event) === 'function') {
-            event = new Event("<%= error_event_name %>");
-          } else {
-            event = document.createEvent('Event');
-            event.initEvent('<%= error_event_name %>', true, true);
-          }
-          document.dispatchEvent(event);
-        <% end %>
+        var errorEvent = createEvent(
+          "<%= error_event_name || 'render_async_error' %>",
+          container
+        )
+        errorEvent.retryCount = currentRetryCount
+
+        document.dispatchEvent(errorEvent);
       });
     };
 
     <% if retry_count > 0 %>
-    var retry = function(currentRetryCount) {
+    var _retryMakeRequest = _makeRequest
+
+    <% if retry_delay %>
+    _retryMakeRequest = function(currentRetryCount) {
+      setTimeout(function() {
+        _makeRequest(currentRetryCount)
+      }, <%= retry_delay %>)
+    }
+    <% end %>
+
+    function retry(currentRetryCount) {
       if (typeof(currentRetryCount) === 'number') {
         if (currentRetryCount >= <%= retry_count %>)
           return false;
 
-        _makeRequest(currentRetryCount + 1);
+        _retryMakeRequest(currentRetryCount + 1);
         return true;
       }
 
-      _makeRequest(1);
+      _retryMakeRequest(1);
       return true;
     }
     <% end %>
 
     var _renderAsyncFunction = _makeRequest;
 
-    <% if interval %>
     var _interval;
+    <% if interval %>
     var _renderAsyncFunction = function() {
+      // If interval is already set, return
+      if (typeof(_interval) === 'number') return
+
       _makeRequest();
       _interval = setInterval(_makeRequest, <%= interval %>);
     }
-    <% end %>
 
-    <% if toggle %>
-    $(document).on('<%= toggle[:event] || 'click' %>', '<%= toggle[:selector] %>', function(event) {
-      event.preventDefault();
-      if (_interval) {
-        clearInterval(_interval);
+    var _clearRenderAsyncInterval = function() {
+      if (typeof(_interval) === 'number'){
+        clearInterval(_interval)
         _interval = undefined;
-      } else {
-        _renderAsyncFunction();
       }
-    });
+    }
+
+    var container = $("#<%= container_id %>");
+
+    // Register a stop polling event on the container
+    $(container).on('async-stop', _clearRenderAsyncInterval)
+
+    // Register a start polling event on the container
+    $(container).on('async-start', _renderAsyncFunction)
+
+    <% if turbolinks %>
+    $(document).one('turbolinks:visit', _clearRenderAsyncInterval);
+    <% end %>
     <% end %>
 
-    <% if turbolinks && !toggle %>
-    $(document).one('turbolinks:load', _renderAsyncFunction);
+    <% if toggle %>
+    function _setUpToggle() {
+      $(document).<%= toggle[:once] ? 'one' : 'on' %>('<%= toggle[:event] || 'click' %>', '<%= toggle[:selector] %>', function(event) {
+        if (typeof(_interval) === 'number') {
+          clearInterval(_interval);
+          _interval = undefined;
+        } else {
+          _renderAsyncFunction();
+        }
+      });
+    }
+
+    _runAfterDocumentLoaded(_setUpToggle);
     <% elsif !toggle %>
-    $(document).ready(_renderAsyncFunction);
+    _runAfterDocumentLoaded(_renderAsyncFunction)
     <% end %>
   }(jQuery));
 } else {
-  console.warn("Looks like you've enabled jQuery for render_async, but jQuery is not defined");
+  console.warn("Looks like you've enabled jQuery for render_async, but jQuery is not defined on the window object");
 };

data/app/views/render_async/_request_vanilla.js.erb

@@ -4,8 +4,30 @@
     return;
   }
   <% end %>
+  function createEvent(name, container) {
+    var event = undefined;
+    if (typeof(Event) === 'function') {
+      event = new Event(name);
+    } else {
+      event = document.createEvent('Event');
+      event.initEvent(name, true, true);
+    }
+    event.container = container
+    return event;
+  }
+
+  function _runAfterDocumentLoaded(callback) {
+    <% if turbolinks %>
+    document.addEventListener("turbolinks:load", function(e) {
+      e.target.removeEventListener(e.type, arguments.callee);
+      callback();
+    });
+    <% else %>
+    document.addEventListener("DOMContentLoaded", callback);
+    <% end %>
+  }
 
-  var _makeRequest = function(currentRetryCount) {
+  function _makeRequest(currentRetryCount) {
     var request = new XMLHttpRequest();
     var asyncRequest = true;
     var SUCCESS = 200;
@@ -22,6 +44,8 @@
       request.setRequestHeader(key, headers[key]);
     });
 
+    request.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
+
     request.onreadystatechange = function() {
       if (request.readyState === 4) {
         if (request.status >= SUCCESS && request.status < ERROR) {
@@ -32,14 +56,11 @@
           container.outerHTML = request.response;
           <% end %>
 
+          var loadEvent = createEvent('render_async_load', container);
+          document.dispatchEvent(loadEvent);
+
           <% if event_name.present? %>
-            var event = undefined;
-            if (typeof(Event) === 'function') {
-              event = new Event("<%= event_name %>");
-            } else {
-              event = document.createEvent('Event');
-              event.initEvent('<%= event_name %>', true, true);
-            }
+            var event = createEvent('<%= event_name %>', container);
             document.dispatchEvent(event);
           <% end %>
         } else {
@@ -53,16 +74,13 @@
           var container = document.getElementById('<%= container_id %>');
           container.outerHTML = '<%= error_message.try(:html_safe) %>';
 
-          <% if error_event_name.present? %>
-            var event = undefined;
-            if (typeof(Event) === 'function') {
-              event = new Event("<%= error_event_name %>");
-            } else {
-              event = document.createEvent('Event');
-              event.initEvent('<%= error_event_name %>', true, true);
-            }
-            document.dispatchEvent(event);
-          <% end %>
+          var errorEvent = createEvent(
+            "<%= error_event_name || 'render_async_error' %>",
+            container
+          );
+          errorEvent.retryCount = currentRetryCount
+
+          document.dispatchEvent(errorEvent);
         }
       }
     };
@@ -72,52 +90,83 @@
   };
 
   <% if retry_count > 0 %>
-  var retry = function(currentRetryCount) {
+
+  <% if retry_delay %>
+  _retryMakeRequest = function(currentRetryCount) {
+    setTimeout(function() {
+      _makeRequest(currentRetryCount)
+    }, <%= retry_delay %>)
+  }
+  <% end %>
+
+  function retry(currentRetryCount) {
     if (typeof(currentRetryCount) === 'number') {
       if (currentRetryCount >= <%= retry_count %>)
         return false;
 
-      _makeRequest(currentRetryCount + 1);
+      _retryMakeRequest(currentRetryCount + 1);
       return true;
     }
 
-    _makeRequest(1);
+    _retryMakeRequest(1);
     return true;
   }
   <% end %>
 
   var _renderAsyncFunction = _makeRequest;
 
-  <% if interval %>
   var _interval;
+  <% if interval %>
   var _renderAsyncFunction = function() {
+    // If interval is already set, return
+    if (typeof(_interval) === 'number') return
+
     _makeRequest();
     _interval = setInterval(_makeRequest, <%= interval %>);
   }
+
+  var _clearRenderAsyncInterval = function() {
+    if (typeof(_interval) === 'number'){
+      clearInterval(_interval)
+      _interval = undefined;
+    }
+  }
+
+  var container = document.getElementById('<%= container_id %>');
+
+  // Register a polling stop event on the container
+  container.addEventListener("async-stop", _clearRenderAsyncInterval)
+
+  // Register a start polling event on the container
+  container.addEventListener("async-start", _renderAsyncFunction)
+
+  <% if turbolinks %>
+  document.addEventListener("turbolinks:visit", _clearRenderAsyncInterval)
+  <% end %>
   <% end %>
 
   <% if toggle %>
-  var selectors = document.querySelectorAll('<%= toggle[:selector] %>');
-
-  [...selectors].forEach(function(selector) {
-    selector.addEventListener('<%= toggle[:event] || 'click' %>', function(event) {
-      event.preventDefault();
-      if (_interval) {
+  function _setUpToggle() {
+    var selectors = document.querySelectorAll('<%= toggle[:selector] %>');
+    var handler = function(event) {
+      if (typeof(_interval) === 'number') {
         clearInterval(_interval);
         _interval = undefined;
       } else {
         _renderAsyncFunction();
       }
-    })
-  });
-  <% end %>
+      <% if toggle[:once] %>
+      this.removeEventListener(event.type, handler);
+      <% end %>
+    };
+
+    for (var i = 0; i < selectors.length; ++i) {
+      selectors[i].addEventListener('<%= toggle[:event] || 'click' %>', handler)
+    }
+  }
 
-  <% if turbolinks && !toggle %>
-  document.addEventListener("turbolinks:load", function (e) {
-    e.target.removeEventListener(e.type, arguments.callee);
-    _renderAsyncFunction();
-  });
+  _runAfterDocumentLoaded(_setUpToggle);
   <% elsif !toggle %>
-  document.addEventListener("DOMContentLoaded", _renderAsyncFunction);
+  _runAfterDocumentLoaded(_renderAsyncFunction);
   <% end %>
 })();

data/lib/render_async/version.rb

@@ -1,3 +1,3 @@
 module RenderAsync
-  VERSION = "2.1.2".freeze
+  VERSION = "2.1.7".freeze
 end

data/lib/render_async/view_helper.rb

@@ -20,7 +20,6 @@ module RenderAsync
     def render_async(path, options = {}, &placeholder)
       event_name = options.delete(:event_name)
       placeholder = capture(&placeholder) if block_given?
-      retry_count = options.delete(:retry_count) || 0
       html_options = options.delete(:html_options) || {}
 
       render 'render_async/render_async', **container_element_options(options),
@@ -30,8 +29,9 @@ module RenderAsync
                                           placeholder: placeholder,
                                           **request_options(options),
                                           **error_handling_options(options),
-                                          retry_count: retry_count,
-                                          **polling_options(options)
+                                          **retry_options(options),
+                                          **polling_options(options),
+                                          **content_for_options(options)
     end
 
     private
@@ -53,11 +53,24 @@ module RenderAsync
         error_event_name: options[:error_event_name] }
     end
 
+    def retry_options(options)
+      {
+        retry_count: options.delete(:retry_count) || 0,
+        retry_delay: options.delete(:retry_delay)
+      }
+    end
+
     def polling_options(options)
       { interval: options[:interval],
         toggle: options[:toggle] }
     end
 
+    def content_for_options(options)
+      {
+        content_for_name: options[:content_for_name] || :render_async
+      }
+    end
+
     private
 
     def generate_container_id

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: render_async
 version: !ruby/object:Gem::Version
-  version: 2.1.2
+  version: 2.1.7
 platform: ruby
 authors:
 - Kasper Grubbe
 - nikolalsvk
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-08-30 00:00:00.000000000 Z
+date: 2020-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -61,6 +61,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".all-contributorsrc"
+- ".github/FUNDING.yml"
 - ".gitignore"
 - ".gitmodules"
 - ".rspec"
@@ -85,7 +86,7 @@ homepage: https://github.com/renderedtext/render_async
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -100,9 +101,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: Render parts of the page asynchronously with AJAX
 test_files: []