dsfr-view-components 4.0 → 4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 952489c459b0e459b926500dbd5dffa0ead338ddd8c5e7196546bcaf9627f09c
-  data.tar.gz: 60ea4e318eb64e00070ed7858ab53f4429d177489f3fab88379535f9dedda488
+  metadata.gz: 1d311caf744ed3223836fc43f8e70b51666992df4c2b2f10f43ac8e302baf115
+  data.tar.gz: 7cdd00c96f50f984230622d24a138f2a46375ba5819daefa8e400ef65fb7c93e
 SHA512:
-  metadata.gz: e3cd015504d4b42841a05b7a2e0969906f7ca99abdf7dae1ec8f4441608ca54b99b4b41d6023da179618a773e6e346147844c0783e2514e88e64b3e059036f60
-  data.tar.gz: 2aa09072f0d92e5e6f3e21d315f5eb9bfff1f71e82dcae5f1db910e6721c965f0dccb5c555ebca471930d149cd9695026ea7ec50286218a9500b3bab80b99dd0
+  metadata.gz: 0ebe93f69a0cb26daf0bb4900c0c525a2e817cec21c748d8f9ddfa4bf7aa30bfe518b0a4163ae709f7af2a8888b90ea2d7961a71c4f33374f34595538878737d
+  data.tar.gz: f8ca4ff1f611861c3f60962a02d24eab0d1461b934fbf6576eaaee1b2b9f90f8a11332836dfadfba7c6fcfbc8d8f858787fb99bcfe3c18a5e4834298471d82d1

data/app/components/dsfr_component/side_menu_component/item_component.html.erb

@@ -0,0 +1,20 @@
+<%= tag.li(class: "fr-sidemenu__item", **html_attributes) do %>
+  <% if sub_items.empty? %>
+    <% if @current_page %>
+      <a href="<%= path %>" class="fr-sidemenu__link" aria-current="page"><%= title %></a>
+    <% else %>
+      <a href="<%= path %>" class="fr-sidemenu__link"><%= title %></a>
+    <% end %>
+  <% else %>
+    <button type="button" class="fr-sidemenu__btn" aria-expanded="<%= expanded? ? "true" : "false" %>" aria-controls="sidemenu-<%= object_id %>">
+      <%= title %>
+    </button>
+    <div class="fr-collapse<%= " fr-collapse--expanded" if expanded? %>" id="sidemenu-<%= object_id %>">
+      <ul class="fr-sidemenu__list">
+        <% sub_items.each do |sub_item| %>
+          <%= sub_item %>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+<% end %>

data/app/components/dsfr_component/side_menu_component/item_component.rb

@@ -0,0 +1,33 @@
+class DsfrComponent::SideMenuComponent::ItemComponent < DsfrComponent::Base
+  MAX_LEVEL = 3
+
+  renders_many :sub_items, ->(title:, path:, current_page: false, expanded: false, html_attributes: {}) {
+    DsfrComponent::SideMenuComponent::ItemComponent.new(title:, path:, current_page:, expanded:, level: @level + 1, html_attributes:)
+  }
+
+  # @param title [String] title of the side menu item
+  # @param path [String] path of the side menu item
+  # @param current_page [Boolean] active current page style
+  # @param expanded [Boolean] toggles sub menu folding
+  # @param level [Integer] nesting level (1-3), automatically set for sub_items
+  def initialize(title:, path:, current_page: false, expanded: false, level: 1, html_attributes: {})
+    raise ArgumentError, "Le menu latéral ne supporte pas plus de #{MAX_LEVEL} niveaux" if level > MAX_LEVEL
+
+    @title = title
+    @path = path
+    @current_page = current_page
+    @expanded = expanded
+    @level = level
+
+    super(html_attributes: html_attributes)
+  end
+
+  private
+
+  attr_reader :title, :path, :expanded
+  alias_method :expanded?, :expanded
+
+  def default_attributes
+    { class: 'fr-sidemenu__item' }
+  end
+end

data/app/components/dsfr_component/side_menu_component.html.erb

@@ -0,0 +1,15 @@
+<%= tag.nav(**html_attributes) do %>
+  <div class="fr-sidemenu__inner">
+    <button type="button" class="fr-sidemenu__btn" aria-expanded="false" aria-controls="sidemenu-collapse-<%= object_id %>"><%= title %></button>
+    <div class="fr-collapse" id="sidemenu-collapse-<%= object_id %>">
+      <% if title %>
+        <p class="fr-sidemenu__title" id="sidemenu-title-<%= object_id %>"><%= title %></p>
+      <% end %>
+      <ul class="fr-sidemenu__list">
+        <% items.each do |item| %>
+          <%= item %>
+        <% end %>
+      </ul>
+    </div>
+  </div>
+<% end %>

data/app/components/dsfr_component/side_menu_component.rb

@@ -0,0 +1,20 @@
+module DsfrComponent
+  class SideMenuComponent < DsfrComponent::Base
+    renders_many :items, "DsfrComponent::SideMenuComponent::ItemComponent"
+
+    # @param title [String] title of the side menu
+    def initialize(title:, html_attributes: {})
+      @title = title
+
+      super(html_attributes:)
+    end
+
+  private
+
+    attr_reader :title
+
+    def default_attributes
+      { class: 'fr-sidemenu', role: 'navigation', "aria-labelledby": "sidemenu-title-#{object_id}" }
+    end
+  end
+end

data/app/helpers/dsfr_components_helper.rb

@@ -22,6 +22,8 @@ module DsfrComponentsHelper
     dsfr_notice: 'DsfrComponent::NoticeComponent',
     dsfr_search: 'DsfrComponent::SearchComponent',
     dsfr_proconnect_button: 'DsfrComponent::ProconnectButtonComponent',
+    dsfr_side_menu: 'DsfrComponent::SideMenuComponent',
+    dsfr_side_menu_item: 'DsfrComponent::SideMenuComponent::ItemComponent',
     # DO NOT REMOVE: new component mapping here
   }.freeze
   HELPER_NAME_TO_CLASS_NAME.each do |name, klass|

data/lib/dsfr/components/version.rb

@@ -1,5 +1,5 @@
 module Dsfr
   module Components
-    VERSION = '4.0'.freeze
+    VERSION = '4.1'.freeze
   end
 end

data/lib/generators/dsfr_component/templates/component.rb.erb

@@ -1,18 +1,18 @@
 class DsfrComponent::<%= @name %>Component < DsfrComponent::Base
 <% if options[:params].empty? %>
-  def initialize(classes: [], html_attributes: {})
-    super(classes: classes, html_attributes: html_attributes)
+  def initialize(html_attributes: {})
+    super(html_attributes: html_attributes)
   end
 <% else %>
 <%- options[:params].each do |param, type| -%>
   # @param <%= param %> [<%= type %>] FIXME: document
 <%- end -%>
-  def initialize(<%= options[:params].keys.map { |p| "#{p}:" }.join(", ") %>, classes: [], html_attributes: {})
+  def initialize(<%= options[:params].keys.map { |p| "#{p}:" }.join(", ") %>, html_attributes: {})
   <%- options[:params].keys.each do |param| -%>
     <%= "@#{param} = #{param}" %>
   <%- end -%>
 
-    super(classes: classes, html_attributes: html_attributes)
+    super(html_attributes: html_attributes)
    end
 <% end  %>
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dsfr-view-components
 version: !ruby/object:Gem::Version
-  version: '4.0'
+  version: '4.1'
 platform: ruby
 authors:
 - BetaGouv developers
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-30 00:00:00.000000000 Z
+date: 2026-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: html-attributes-utils
@@ -42,16 +42,22 @@ dependencies:
   name: dsfr-assets
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.13.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.13.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.15'
 - !ruby/object:Gem::Dependency
   name: deep_merge
   requirement: !ruby/object:Gem::Requirement
@@ -357,6 +363,10 @@ files:
 - app/components/dsfr_component/proconnect_button_component.rb
 - app/components/dsfr_component/search_component.html.erb
 - app/components/dsfr_component/search_component.rb
+- app/components/dsfr_component/side_menu_component.html.erb
+- app/components/dsfr_component/side_menu_component.rb
+- app/components/dsfr_component/side_menu_component/item_component.html.erb
+- app/components/dsfr_component/side_menu_component/item_component.rb
 - app/components/dsfr_component/skiplink_component.html.erb
 - app/components/dsfr_component/skiplink_component.rb
 - app/components/dsfr_component/stepper_component.html.erb