Form builder du DSFR

Cette gem permet de créer des formulaires avec Ruby on Rails en utilisant le design system de l'Etat français (DSFR).

Usage

Ajoutez cette ligne à votre Gemfile :

gem 'dsfr-form_builder'

Spécifiez l’utilisation du builder dans votre formulaire :

<%= form_with model: @user, builder: Dsfr::FormBuilder do |f| %>
  <%= f.text_field :name %>
<% end %>

Vous pouvez également spécifier le builder par défaut dans votre fichier application.rb :

config.action_view.default_form_builder = Dsfr::FormBuilder

Contribution

Tests

Lancer les tests avec

make test

Documentation

Pour lancer le serveur de documentation en local :

make docs-live

Puis ouvrir http://localhost:9292

Déploiement

1. Créer une nouvelle branche
2. Mettre à jour la version dans lib/dsfr-form_builder.rb et dans lib/dsfr/components/version.rb
3. lancer bundle
4. Commit, push, puis merge PR
5. Lancer la commande : bundle exec rake release
6. Créez une release GH manuellement depuis https://github.com/betagouv/dsfr-form-builder/releases

Licence

Le code source et la gem sont distribués sous licence MIT.