Katalyst::GOVUK::Formbuilder
Repacking of GOV.UK Frontend and GOV.UK form components for use in Katalyst projects.
Installation
Add this line to your application's Gemfile:
gem "katalyst-govuk-formbuilder"
And then execute:
$ bundle
Or install it yourself as:
$ gem install katalyst-govuk-formbuilder
Usage
Add the stylesheet to your default layout:
<%= stylesheet_link_tag "katalyst/govuk/formbuilder" %>
Some GOVUK components require javascript enhancements (see GOVUK docs).
You can use the provided helper to load the formbuilder esm from importmaps and enhance your form:
<%= form_with ... %>
<%= govuk_formbuilder_init %>
You'll need to include the helper to make this method available, which you can add to your ApplicationController
:
helper Katalyst::GOVUK::Formbuilder::Frontend
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/katalyst/govuk-formbuilder.
Release
Update the version number in lib/katalyst/govuk/formbuilder/version.rb
and run:
bundle exec rake release
License
The gem is available as open source under the terms of the MIT License.