Capybara::BootstrapDatepicker
Helper for triggering date input with the bootstrap-datepicker JavaScript library.
This gem does something very simple: it allows you to trigger the Bootstrap date picker to select the date you want.
Supported versions
This gem has been tested with:
- Bootstrap 5.0.1 + bootstrap-datepicker 1.9.0 + jQuery 3.6.0
- Bootstrap 4.4.1 + bootstrap-datepicker 1.9.0 + jQuery 3.4.1
- Bootstrap 3.4.1 + bootstrap-datepicker 1.9.0 + jQuery 3.4.1
Installation
Add this line to your application's Gemfile:
gem 'capybara-bootstrap-datepicker', group: :test
Or, add it into your test group
group :test do
gem 'capybara-bootstrap-datepicker'
...
end
And then execute:
$ bundle
Or install it yourself as:
$ gem install capybara-bootstrap-datepicker
The gem automatically hooks itself into RSpec helper using RSpec.configure
.
Usage
Just use this method inside your Capybara test:
select_date(2.weeks.ago, from: "Label of the date input")
Or in a more advanced way:
select_date(2.weeks.ago, from: "Date", match: :prefer_exact)
select_date(Date.tomorrow, from: "Label of the date input", format: "%d/%m/%Y")
select_date("2013-05-24", xpath: "//path_to//your_date_input", datepicker: :bootstrap)
Available options are:
- from: the label of your date input
- xpath: the path to your date input
- format: the format used to fill your date input
- match:
-
datepicker: the way to fill your date input
-
:bootstrap
= by clicking the popover using bootstrap-datepicker -
:simple
= just fill the input date
-
- any extra args to find the input field
Test
Just run RSpec in your terminal:
$ rspec
Upgrading from 0.0.x
RSpec support has been split into a separate file. You'll need to change
spec_helper.rb
to require 'capybara-bootstrap-datepicker/rspec'
.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request