Cette gem fournit des composants pour le Design Système de l'État (DSFR) en s'appuyant sur le framework ViewComponent.

C'est un fork de govuk-components qui propose l'équivalent pour le GOV.UK Design System.

Un guide complet est disponible. Il contient des instructions pour l'installation et l'usage de cette gem. Les exemples présents éxecutent le code et seront donc toujours à jour.

Pour utiliser cette gem dans votre application Rails, il faut ajouter cette ligne dans config/application.rb:

require "dsfr/components"

Cette gem a pour but de supporter tous les composants proposés par le Design Système de l'État hormis ceux concernant les formulaires. Ceux-ci seront fournis dans une gem indépendante dans le futur.

11/36 composants sont disponibles :

• Accordéon - Accordion
• Alertes - Alert
• Badge
• Bandeau d'information importante
• Barre de recherche - Search bar
• Boutons - Buttons
• Groupe de bouton
• Bouton FranceConnect
• Cartes - Cards
• Citation - Quote
• Contenu médias - Responsive médias
• En-tête - Header
• Fil d'Ariane - Breadcrumb
• Gestionnaire de consentement - Consent banner
• Icônes de favoris - Favicons
• Indicateur d'étape - Stepper
• Interrupteur - Toggle switch
• Lettre d'information et réseaux sociaux - Newsletter & Follow us
• Liens - Links
• Liens d'évitement - Skiplinks
• Menu latéral - Side menu
• Mise en avant - Call out
• Mise en exergue - Highlight
• Modale - Modal
• Navigation principale - Main navigation
• Onglets - Tabs
• Pagination
• Paramètres d'affichage - Display
• Partage - Share
• Pied de page - Footer
• Sélecteur de langue
• Sommaire - Summary
• Tableau - Table
• Tag
• Téléchargement de fichier
• Tuile - Tile

• Collectif Objets - code source

Nous conseillons d'utiliser rbenv pour gérer vos versions de ruby :

rbenv local 3.1.2
rbenv install

Lancer les tests :

bundle install
bundle exec rspec spec

Pour développer avec les tests en continu :

bundle exec guard

Lancer le guide de documentation :

make watch-guide

Utilisez le générateur pour créer un nouveau composant :

bin/rails g dsfr_component FancyButton --params title:String count:Integer

Lancer la dummy app pour itérer sur les composants :

cd spec/dummy
bundle install && npm install
bundle exec rails server

Déployer une nouvelle version de la gem :

VERSION=1.3.2 make deploy_gem

Le code source et la gem sont ouverts sous la licence MIT.