dsfr-view-components 5.0.0.pre → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be08ee815bcd05cde35b9b28469c01af61b7c6242c93597e3e40f675e090c690
-  data.tar.gz: b3ef44ef8460bd258aedd1698fefd2918739264b52022b6043f76f45828ff15e
+  metadata.gz: 02b516513b253dd53b123c414a4b08ae91c4a5c51ea8633843bec5f9605cfdc4
+  data.tar.gz: 9f45ba667ec0f130097de1d2c2fc14f4bbdda018e3ebef3eb3fb8f786cff2cfa
 SHA512:
-  metadata.gz: ba9029e0f6f299c38e6a287fa55f36eff1abb1b6492b6e0922377c534a9abea09f960c1277d7e39a1bfb5b432b2b66932723f1c25f4917dc78017f67bb69457f
-  data.tar.gz: 47d7732b63da68357c01ce0be606dc845b3086100ce718920462ea0418c392999789edf7af27c5a737f71d9971b4a40a4c667d41db07fb736b95d23187df7f67
+  metadata.gz: 60c971316b5d90cd567a7e7ae7c296d644227d9b85601847a59b13c25dee4a3c0e12af5239a6c8384d7fbf58df993134c9af6648bb9533adaa648a45010b5c0b
+  data.tar.gz: c617ade15d0eb93211488799cd38963e7cecd349d2779bade57565644c59d94fc6ee9cd9d58acdc32d34be6d39ee3fa678c0ea6bfcab9cc6d512916e6918b8b9

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

@@ -0,0 +1,43 @@
+<%= tag.div(**html_attributes) do %>
+  <div class="fr-card__body">
+    <div class="fr-card__content">
+      <%= title_tag(class: "fr-card__title") do %>
+        <a class="fr-card__link" href="<%= url %>"><%= title %></a>
+      <% end %>
+      <% if description.present? %>
+        <p class="fr-card__desc"><%= description %></p>
+      <% end %>
+      <% if start_detail.present? %>
+        <div class="fr-card__start">
+          <p class="<%= start_detail_classes %>"><%= start_detail %></p>
+        </div>
+      <% end %>
+      <% if end_detail.present? %>
+        <div class="fr-card__end">
+          <p class="<%= end_detail_classes %>"><%= end_detail %></p>
+        </div>
+      <% end %>
+    </div>
+    <% if footer? %>
+      <div class="fr-card__footer">
+        <%= footer %>
+      </div>
+    <% end %>
+  </div>
+  <% if image_src.present? || badges.any? %>
+    <div class="fr-card__header">
+      <% if image_src.present? %>
+        <div class="fr-card__img">
+          <img class="fr-responsive-img" src="<%= image_src %>" alt="<%= image_alt %>">
+        </div>
+      <% end %>
+      <% if badges.any? %>
+        <ul class="fr-badges-group">
+          <% badges.each do |badge| %>
+            <li><%= badge %></li>
+          <% end %>
+        </ul>
+      <% end %>
+    </div>
+  <% end %>
+<% end %>

data/app/components/dsfr_component/card_component.rb

@@ -0,0 +1,79 @@
+module DsfrComponent
+  class CardComponent < DsfrComponent::Base
+    SIZES = %i[sm lg].freeze
+    HORIZONTAL_RATIOS = [true, :half, :tier].freeze
+
+    renders_many :badges, "DsfrComponent::BadgeComponent"
+    renders_one :footer
+
+    def initialize(
+      title:,
+      url:,
+      description: nil,
+      image_src: nil,
+      image_alt: "",
+      heading_level: 3,
+      size: nil,
+      horizontal: false,
+      start_detail: nil,
+      start_detail_icon: nil,
+      end_detail: nil,
+      end_detail_icon: nil,
+      enlarge_link: true,
+      html_attributes: {}
+    )
+      raise ArgumentError, "`size` should be one of #{SIZES}" if size && SIZES.exclude?(size)
+      raise ArgumentError, "`heading_level` should be one of #{HEADING_LEVELS}" if HEADING_LEVELS.exclude?(heading_level)
+      raise ArgumentError, "`horizontal` should be one of #{[false] + HORIZONTAL_RATIOS}" if horizontal != false && HORIZONTAL_RATIOS.exclude?(horizontal)
+
+      @title = title
+      @url = url
+      @description = description
+      @image_src = image_src
+      @image_alt = image_alt
+      @heading_level = heading_level
+      @size = size
+      @horizontal = horizontal
+      @start_detail = start_detail
+      @start_detail_icon = start_detail_icon
+      @end_detail = end_detail
+      @end_detail_icon = end_detail_icon
+      @enlarge_link = enlarge_link
+
+      super(html_attributes: html_attributes)
+    end
+
+    # this guard is set at render-time because we cannot make the
+    # footer-slot distinction in the constructor
+    def before_render
+      raise ArgumentError, "You cannot setup a footer on a card with `enlarge_link: true`" if footer? && enlarge_link
+    end
+
+  private
+
+    attr_reader :title, :url, :description, :image_src, :image_alt,
+                :heading_level, :size, :horizontal, :start_detail, :start_detail_icon,
+                :end_detail, :end_detail_icon, :enlarge_link
+
+    def default_attributes
+      classes = ["fr-card"]
+      classes << "fr-enlarge-link" if enlarge_link
+      classes << "fr-card--horizontal" if horizontal
+      classes << "fr-card--horizontal-#{horizontal}" if horizontal.is_a?(Symbol)
+      classes << "fr-card--#{size}" if size
+      { class: classes }
+    end
+
+    def title_tag(*args, **kwargs, &block)
+      content_tag("h#{heading_level}", *args, **kwargs, &block)
+    end
+
+    def start_detail_classes
+      ["fr-card__detail", start_detail_icon && "fr-icon-#{start_detail_icon}"].compact.join(" ")
+    end
+
+    def end_detail_classes
+      ["fr-card__detail", end_detail_icon && "fr-icon-#{end_detail_icon}"].compact.join(" ")
+    end
+  end
+end

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

@@ -1,6 +1,13 @@
 <%= tag.div(**html_attributes) do %>
   <div class="fr-tile__body">
     <div class="fr-tile__content">
+      <% if badges.any? %>
+        <div class="fr-tile__start">
+          <% badges.each do |badge| %>
+            <%= badge %>
+          <% end %>
+        </div>
+      <% end %>
       <%= title_tag(class: "fr-tile__title") do %>
         <a class="fr-tile__link" href="<%= url %>">
           <%= title %>

data/app/components/dsfr_component/tile_component.rb

@@ -1,5 +1,7 @@
 module DsfrComponent
   class TileComponent < DsfrComponent::Base
+    renders_many :badges, "DsfrComponent::BadgeComponent"
+
     # @param title [String] title (required)
     # @param url [String] url (required)
     # @param image_src [String] chemin vers l'image (optional)
@@ -21,6 +23,10 @@ module DsfrComponent
       super(html_attributes: html_attributes)
     end
 
+    def before_render
+      raise ArgumentError, "TileComponent accepte au maximum 4 badges (#{badges.size} fournis)" if badges.size > 4
+    end
+
   private
 
     attr_reader :title, :url, :image_src, :image_alt, :description, :orientation, :heading_level

data/app/helpers/dsfr_components_helper.rb

@@ -24,6 +24,7 @@ module DsfrComponentsHelper
     dsfr_proconnect_button: 'DsfrComponent::ProconnectButtonComponent',
     dsfr_side_menu: 'DsfrComponent::SideMenuComponent',
     dsfr_side_menu_item: 'DsfrComponent::SideMenuComponent::ItemComponent',
+    dsfr_card: 'DsfrComponent::CardComponent',
     # 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 = '5.0.0.pre'.freeze
+    VERSION = '5.0.0'.freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dsfr-view-components
 version: !ruby/object:Gem::Version
-  version: 5.0.0.pre
+  version: 5.0.0
 platform: ruby
 authors:
 - BetaGouv developers
@@ -347,6 +347,8 @@ files:
 - app/components/dsfr_component/breadcrumbs_component.rb
 - app/components/dsfr_component/button_component.rb
 - app/components/dsfr_component/callout_component.rb
+- app/components/dsfr_component/card_component.html.erb
+- app/components/dsfr_component/card_component.rb
 - app/components/dsfr_component/header_component.html.erb
 - app/components/dsfr_component/header_component.rb
 - app/components/dsfr_component/header_component/direct_link_component.rb
@@ -418,7 +420,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Composants ViewComponent pour le Système de Design de l'État (DSFR)
 test_files: []