` or a `` are rendered. Those custom elements have an `IntersectionObserver` attached that will send a signed global id to an ActionCable channel (`FuturismChannel`) which will then replace the placeholders with the actual resource partial. With that method, you could lazy load every class that has to_partial_path defined (ActiveModel has by default). You can pass the placeholder as a block: ```erb <%= futurize @posts, extends: :tr do %> <% end %> ``` ![aa601dec1930151f71dbf0d6b02b61c9](https://user-images.githubusercontent.com/4352208/87131629-f768a480-c294-11ea-89a9-ea0a76ee06ef.gif) ## API Currently there are two ways to call `futurize`, designed to wrap `render`'s behavior: ### Resource You can pass a single `ActiveRecord` or an `ActiveRecord::Relation` to `futurize`, just as you would call `render`: ```erb <%= futurize @posts, extends: :tr do %> <% end %> ``` #### Partial Path Remember that you can override the partial path in you models, like so: ```rb class Post < ApplicationRecord def to_partial_path "home/post" end end ``` That way you get maximal flexibility when just specifying a single resource. ### Explicit Partial Call `futurize` with a `partial` keyword: ```erb <%= futurize partial: "items/card", locals: {card: @card}, extends: :div do %>

<% end %> ``` You can also use the shorthand syntax: ```erb <%= futurize "items/card", card: @card, extends: :div do %>

<% end %> ``` #### Collections Collection rendering is also possible: ```erb <%= futurize partial: "items/card", collection: @cards, extends: :div do %>

<% end %> ``` ## Installation Add this line to your application's Gemfile: ```ruby gem 'futurism' ``` And then execute: ```bash $ bundle ``` To copy over the javascript files to your application, run ```bash $ bin/rails futurism:install ``` **! Note that the installer will run `yarn add @minthesize/futurism` for you !** ### Manual Installation After `bundle`, install the Javascript library: ```bash $ bin/yarn add @minthesize/futurism ``` In your `app/javascript/channels/index.js`, add the following ```js import * as Futurism import consumer from './consumer' Futurism.initializeElements() Futurism.createSubscription(consumer) ``` ## Contributing ## License The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

_{Julian Rubisch}
💻

_darkrubyist
💻 📖

_{Konnor Rogers}
💻

_{Andrew Mason}
🚧

_{Chris Oliver}
💻 👀

_leastbad
💻

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!