This gem is out of date
If you're working on an older project where upgrading to the GOV.UK Design System isn't a viable option, don't worry. This gem will continue to receive bug fixes and accessibility improvements.
This gem serves a form builder and other various helper methods to produces the markup required to leverage presentation and interaction without having to recreate the markup yourself.
Guidance and documentation for how to use this library can be found here.
Any updates to the guidance should be submitted as pull requests to this github repository.
Add these lines to your application's Gemfile, form builder is the last gem in list:
gem 'govuk_frontend_toolkit', '~> 6.0.0' gem 'govuk_elements_rails', '~> 3.0.0' gem 'govuk_elements_form_builder', '~>0.0.0'
gem 'govuk_frontend_toolkit', '~> 6.0.0' gem 'govuk_elements_rails', '~> 3.0.0' gem 'govuk_elements_form_builder', '~>1.0.0'
And then execute:
In your application's
config/application.rb file, configure the form builder
to be the default like this:
class Application < Rails::Application # ... ActionView::Base.default_form_builder = GovukElementsFormBuilder::FormBuilder end
Versions - Which version should you used?
We encourage developers to use the latest version but understand that sometimes it is not possible to do so. Seeing as there was quite a significant change to the markup needed with the release of GOVUK Elements 3.0. We have decided to create two supporting versions of the form builder for those services that use the older GOVUK Elements and Frontend toolkit or who would like to use the latest GOVUK assets.
Since version 1, GOVUK Elements and Frontend versions have now become a dependency to help ensure that developers use the correct GOVUK Form builder version.
For the time being the only differences between the two versions is the markup that this gem produces. We will try and keep the methods identical between versions but if you decide to upgrade to version 1 you should check any pages that use Radio buttons or Checkboxes and any js/css that rely on the markup these two elements use. Another thing you should check is if you rely on the css class name used for errors as this has also been renamed.
After checking out the repo, run
bundle install to install dependencies.
bundle exec rspec to run the tests.
To install this gem onto your local machine, run
bundle exec rake install.
To release a new version, update the version number in
version.rb, and then
bundle exec rake release, which will create a git tag for the version,
push git commits and tags, and push the
.gem file to
Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/govuk_elements_form_builder. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
The gem is available as open source under the terms of the MIT License.