bootstrap_form

Adds Rails 7.1.1+ to the test matrix, and upgrades the demo/test app to Rails 7.1.1. Miscellaneous fixes.

What's Changed

New features

• Rails 7.1. No changes in functionality, but added Rails 7.1 to the test matrix and upgraded the demo/test app (#708).

Bugfixes

• Do not alias rich text area if it is not defined (#709).
• Fix joins not to make strings unsafe (#704).

Performance

Documentation

Development

• Changes to the experimental Docker development environment. (#712, #710).

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.3.2...v5.4.0

Closed issues

New Contributors

• @BenMorganMY made their first contribution in #709.

Bugfixes

• Allow array values for the label_col and control_col options. https://github.com/bootstrap-ruby/bootstrap_form/issues/703

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.3.1...v5.3.2

Closed issues

Bugfix release

• Allow settings conditional presence validators using symbols.

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.3.0...v5.3.1

Closed issues

What's Changed

New features

• Check conditions for presence validators to see if an attribute is required by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/693
• Improve checkbox layout by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/686
• Rename layout :default to :vertical by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/694
• allow for data- attributes to pass through for radio button collections by @johrstrom in https://github.com/bootstrap-ruby/bootstrap_form/pull/665
• Add bootstrap_fields_for and bootstrap_fields form helpers. by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/699

Bugfixes

• Fixed Calling << to an ActiveModel::Errors deprecation warning by @dannytip in https://github.com/bootstrap-ruby/bootstrap_form/pull/690
• Remove aria-required attribute from semantic element input by @jdufresne in https://github.com/bootstrap-ruby/bootstrap_form/pull/695
• Omit the multiple attribute for checkbox collection hidden field. by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/698

Performance

Documentation

• Correct several typos by @jdufresne in https://github.com/bootstrap-ruby/bootstrap_form/pull/700
• Fix broken section links in README.md [ci skip] by @minimabot in https://github.com/bootstrap-ruby/bootstrap_form/pull/701

Development

• Stop support for Rails 6.0 since it is EOL. by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/696

Closed issues

Closed issues

New Contributors

• @dannytip made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/690
• @johrstrom made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/665
• @jdufresne made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/695
• @minimabot made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/701

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.2.3...v5.3.0

Bugfixes

• Correct "mr-sm-2" to "me-sm-2" for inline labels

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.2.2...v5.2.3
Closed issues

What's Changed

• Don't set required and aria-required for attributes with conditional presence validators by @AndersGM in https://github.com/bootstrap-ruby/bootstrap_form/pull/685

New Contributors

• @AndersGM made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/685

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.2.1...v5.2.2
Closed issues

What's Changed

• Allow ActiveModel object as form objects. by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/684

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.2.0...v5.2.1
Closed issues

What's Changed

• Support current rubies: 3.0, 3.1, and 3.2 (https://www.ruby-lang.org/en/downloads/branches/)
• Support current Rails versions: 6.0, 6.1, 7.0 (https://guides.rubyonrails.org/maintenance_policy.html)
• Support current Bootstrap versions: 5.0, 5.1, and 5.2, and aspire to support Bootstrap 5.3.

New features

• Automatically pick up presence validators for default belongs_to association by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/654
• Set required and aria-required on the input when the input is required by @CharlieWinkwaves in https://github.com/bootstrap-ruby/bootstrap_form/pull/664

Bugfixes

• CVE fix breaks serialization of symbols -- fix test by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/649
• Change concat to << since the buffer no longer supports the former by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/652
• Eliminate Warnings from net-http by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/650
• Don't use concat when not necessary by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/660

Development

• More portable docker-compose.yml and better documentation by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/647
• Document exposing ports for docker-compose by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/648
• This allows running tests on the root of the project freshly checked out by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/651
• Add Puma and Debuggers to common.gemfile by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/657
• Lint on oldest Rails version by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/658
• Fix the bogus Rubocop Autocorrect by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/659
• Use the minitest test runner by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/666
• Update gemspec by @siegy22 in https://github.com/bootstrap-ruby/bootstrap_form/pull/667
• Test extra arguments by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/668
• CI Updates by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/669
• Test wrapper_class and wrapper: { class: specified by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/671
• Remove tests for versions before Rails 5.2 by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/672
• 674 html tests by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/676
• Fix assets in the demo app by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/678
• Update ruby requirement to >=3.0 by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/679
• Preparing v5.2.0 by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/681

New Contributors

• @siegy22 made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/667

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.1.0...v5.2.0
Closed issues

What's Changed

New features

• Enable include hidden by @a5-stable in https://github.com/bootstrap-ruby/bootstrap_form/pull/627
• Consider human attribute name for labels by @koenpunt in https://github.com/bootstrap-ruby/bootstrap_form/pull/565
• Add support for Ransack::Search object to the first argument of bootrap_form_for by @harada4atsushi in https://github.com/bootstrap-ruby/bootstrap_form/pull/549
• Add support for append and prepend on collection_select (fixes #428) by @judylovesruby in https://github.com/bootstrap-ruby/bootstrap_form/pull/641

Bugfixes

• Update hide_class from sr-only to visually-hidden by @aki77 in https://github.com/bootstrap-ruby/bootstrap_form/pull/615
• Allow overriding the wrapper class by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/618
• Add generate_validation_failed method to not override help text by @antpaw in
• Add margin below check boxes in the vertical layout by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/638
• Fix text alignment in alert message when there is no error summary by @isaac in https://github.com/bootstrap-ruby/bootstrap_form/pull/634
• Update the inline form layout by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/639

Documentation

• Typo in Contributing Doc by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/620
• Demo 7.0 by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/624
  https://github.com/bootstrap-ruby/bootstrap_form/pull/300
• Add example images to README.md by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/635
• Add generated HTML for the examples in README.md by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/636
• Update the generated HTML for the trix editor example by @donv in https://github.com/bootstrap-ruby/bootstrap_form/pull/640
• Need 7.0.2 for file upload test by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/643
• Use docker-compose by @lcreid in https://github.com/bootstrap-ruby/bootstrap_form/pull/644

New Contributors

• @aki77 made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/615
• @a5-stable made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/627
• @isaac made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/634
• @harada4atsushi made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/549
• @judylovesruby made their first contribution in https://github.com/bootstrap-ruby/bootstrap_form/pull/641

Full Changelog: https://github.com/bootstrap-ruby/bootstrap_form/compare/v5.0.0...v5.1.0
Closed issues: 2021-11-12...2022-06-25

Breaking changes

• Generates markup for Bootstrap 5.

New features

• #572: Simplify the formatting of the file upload control to follow the new Bootstrap 5 styles
• #573: Add support for Bootstrap 5's floating labels

Bugfixes

• #582: Fix tests in bootstrap-5 branch, removes Rubocop offenses, and adds testing with Rails 6.1.

New features

• #562: Allow to configure default form attributes - @sharshenov.

New features

• #557: Allow prepending and appending multiple items to an input by passing an array to prepend and append options - @donv.
• #550: Add default_layout so we can use it for all forms - @duleorlovic.

Bugfixes

• Your contribution here!

New features

• [#503] Support Rails 6.0.0.
• Small documentation changes.

New features

• [#508] Support rich_text_area AKA the Trix editor on Rails 6+.
• [#518] Move all inputs to separate, more maintainable files.
• #514: Add support for BS 4.2 switches - @simmerz

Bugfixes

• #522: Clean up rubocop offences - @simmerz
• #524: Fix non-inline layout rendering without help text - @simmerz

New features

• [#259] Allow to render input without wrapper [@yevhene].

Bugfixes

• [#496] Ensure required attribute is passed through to input tag.

🚨 This release adds support for Bootstrap v4 and drops support for Bootstrap v3. 🚨

If your app uses Bootstrap v3, you should continue using bootstrap_form 2.7.x instead.

Bootstrap v3 and v4 are very different, and thus bootstrap_form now produces different markup in order to target v4. The changes are too many to list here; you can refer to Bootstrap's Migrating to v4 page for a detailed explanation.

In addition to these necessary markup changes, the bootstrap_form API itself has the following important changes in this release.

Breaking changes

• See Migrating to v4.

New features

• [#476] Give a way to pass classes to the div.form-check wrapper for check boxes and radio buttons - @lcreid.
• 461: default form-inline class applied to parent content div on date select helpers. Can override with a :skip_inline option on the field helper - @lancecarlson.
• The button, submit, and primary helpers can now receive an additional option, extra_class. This option allows us to specify additional CSS classes to be added to the corresponding button/input, while maintaining the original default ones. E.g., a primary button with an extra_class 'test-button' will have its final CSS classes declaration as 'btn btn-primary test-button'.

Bugfixes

• #347 Fix wrapper_class and wrapper options for helpers that have html_options.
• #472 Use id option value as for attribute of label for custom checkboxes and radio buttons.
• #478 Fix offset for form group without label when multiple label widths are specified.

🚨 This release adds support for Bootstrap v4 and drops support for Bootstrap v3. 🚨

If your app uses Bootstrap v3, you should continue using bootstrap_form 2.7.x instead.

Bootstrap v3 and v4 are very different, and thus bootstrap_form now produces different markup in order to target v4. The changes are too many to list here; you can refer to Bootstrap's Migrating to v4 page for a detailed explanation.

In addition to these necessary markup changes, the bootstrap_form API itself has the following important changes in this release.

Breaking changes

• Rails 4.x is no longer supported
• Ruby 2.2 or newer is required
• Built-in support for the nested_form gem has been completely removed
• The icon option is no longer supported (Bootstrap v4 does not include icons)
• The deprecated Rails methods check_boxes_collection and radio_buttons_collection have been removed
• hide_label: true and skip_label: true on individual check boxes and radio buttons apply Bootstrap 4 markup. This means the appearance of a page may change if you're upgrading from the Bootstrap 3 version of bootstrap_form, and you used check_box or radio_button with either of those options
• static_control will no longer properly show error messages. This is the result of bootstrap changes.
• static_control will also no longer accept a block, use the value option instead.
• form_group with a block that produces arbitrary text needs to be modified to produce validation error messages (see the UPGRADE-4.0 document). @lcreid.
• form_group with a block that contains more than one check_box or radio_button needs to be modified to produce validation error messages (see the UPGRADE-4.0 document). @lcreid.
• #456: Fix label for attribute when passing non-english characters using collection_check_boxes - @ug0.
• #449: Bootstrap 4 no longer mixes in .row in .form-group. bootstrap_form adds .row to div.form-group when layout is horizontal.

New features

• Support for Rails 5.1 form_with - @lcreid.
• Support Bootstrap v4's Custom Checkboxes and Radios with a new custom: true option
• Allow HTML in help translations by using the _html suffix on the key - @unikitty37
• #408: Add option[:id] on static control #245 - @duleorlovic.
• #455: Support for i18n :html subkeys in help text - @jsaraiva.
• Adds support for label_as_placeholder option, which will set the label text as an input fields placeholder (and hiding the label for sr_only).
• #449: Passing .form-row overrides default .form-group.row in horizontal layouts.
• Added an option to the submit (and primary, by transitivity) form tag helper, render_as_button, which when truthy makes the submit button render as a button instead of an input. This allows you to easily provide further styling to your form submission buttons, without requiring you to reinvent the wheel and use the button helper (and having to manually insert the typical Bootstrap classes). - @jsaraiva.
• Add :error_message option to check_box and radio_button, so they can output validation error messages if needed. @lcreid.

Bugfixes

• #357 if provided,
  use html option id to specify for attribute on label
  @duleorlovic

Features:

• #325: Support :prepend and :append for the select helper - @donv.

Bugfixes:

• None

Features:

• Add a FormBuilder#custom_control helper #289

There are no user-facing changes with this release. Behind the scenes, the tests have been greatly improved. The project is now tested against and compatible with the following Rails versions 4.0, 4.1, 4.2 and 5.0 (#278).