WithPopup

WithPopup makes it easy to open and manage a popup window in your rails application, and which is NOT controlled by popup blocker.

• rails ~> 4.0
• jquery-rails >= 3.0, < 5.0

Add this in your Gemfile, and run the bundle install command.

gem 'with_popup'

Add this in your app/assets/javascripts/application.js below jquery.

//= require jquery
//= require jquery_ujs
//= require with_popup
//= require_tree .

WithPopup provides some helper methods managing a popup window in view and controller contexts, which are wrapping form helper methods that create clickable DOM (like link_to, submit_tag) with *_with_popup naming.

Typical usage is like this.

# In your erb file
<%= form_for @post do |f| %>
  ...
  # Submit while opening a popup window
  <%= f.submit_with_popup %>
<% end %>

# In your controller
def create
  @post = Post.new(params[:post].permit(...))
  if @post.save
    # Show print preview in the popup window you've opened
    reload_popup print_post_path(@post)
    redirect_to @post
  else
    # Close the popup window
    close_popup
    render :new
  end
end

These *_with_popup methods never interrupt the original click actions, just open popup windows simultaneously.

All helper methods are defined to deledate the processing to the original methods they are wrapping, so you can invoke them as you do with the original methods.

You can give a particular option for the javascript window.open function.

# In your erb file
<%= submit_with_popup_tag 'Create and Print',
      with_popup: { src: '/loading', features: 'width=300,height=200' } %>

Its popup window will be opened like this

window.open('', '/loading', 'width=300,height=200');

WithPopup provides some test helper methods.

# In your rails_helper.rb

require 'with_popup/test_helpers'

...

RSpec.configure do |config|
...
  config.include WithPopup::TestHelpers::Controller, type: :controller
...
end

Then, you can invoke the methods below in controller test context.

it { expect(with_popup_reloading_path).to match '/reload/path' }
it { expect(with_popup_is_closing?).to be_truthy }

• Fork the master branch, and clone it.
• Run the bundle install command to start developing.
• Test it with the bundle exec rspec command.
• Shoot a pull-request, thank you.

MIT

itmammoth