Merge pull request #1104 from dnum-mi/docs/improve-docs

docs/improve docs

Author: laruiss

src/components/DsfrDataTable/DsfrDataTable.md

@@ -2,11 +2,11 @@
 
 ## 🌟 Introduction
 
-Le composant `DsfrDataTable` est un élément puissant et polyvalent pour afficher des données sous forme de tableaux dans vos applications Vue. Utilisant une combinaison de slots, de props, et d'événements personnalisés, ce composant offre une flexibilité remarquable. Plongeons dans les détails !
+Le composant `DsfrDataTable` est un élément puissant et polyvalent pour afficher des données sous forme de tableaux dans vos applications Vue avec une intégration facile du **tri** et de la **pagination**, entre autres. Utilisant une combinaison de slots, de props, et d'événements personnalisés, ce composant offre une flexibilité remarquable. Plongeons dans les détails !
 
 ::: warning Prudence
 
-Ce composant est tout neuf et a besoin de vos retours. Son API ne devrait pas changer, elle devrait s’étoffer dans les prochaines semaines ou les prochains mois.
+Ce composant est complexe. Son API ne devrait pas changer, elle devrait s’étoffer dans les prochaines semaines ou les prochains mois.
 
 Si vous avez des propositions, veuillez lancer une [**discussion**](https://github.com/dnum-mi/vue-dsfr/discussions) avant d’ouvrir une issue.
 

src/components/DsfrFooter/DsfrFooter.md

@@ -76,6 +76,7 @@ Aucun événement spécifique pour ce composant.
 
 1. `footer-link-lists` : Permet de personnaliser les listes de liens dans la partie supérieure du pied de page.
 2. `description` : Pour personnaliser la description dans le corps du pied de page.
+3. `footer-partners` : Pour personnaliser les liens vers les partenaires, par défaut est généré grâce à la prop `partners`.
 
 ## 📝 Exemple
 

src/components/DsfrFooter/DsfrFooter.vue

@@ -87,6 +87,7 @@ const props = withDefaults(defineProps<DsfrFooterProps>(), {
 defineSlots<{
   'footer-link-lists': () => VNode
   description: () => VNode
+  'footer-partners': () => VNode
 }>()
 
 const allLinks = computed(() => {
@@ -218,10 +219,13 @@ const externalOperatorLink = computed(() => {
           </ul>
         </div>
       </div>
-      <DsfrFooterPartners
-        v-if="partners"
-        v-bind="partners"
-      />
+      <!-- @slot Slot #description pour le contenu de la description du footer. Sera dans `<p class="fr-footer__content-desc">` -->
+      <slot name="footer-partners">
+        <DsfrFooterPartners
+          v-if="partners"
+          v-bind="partners"
+        />
+      </slot>
       <div class="fr-footer__bottom">
         <ul class="fr-footer__bottom-list">
           <li

src/components/DsfrFooter/docs-demo/DsfrFooterDemo.vue

@@ -40,18 +40,22 @@ const ecosystemLinks = [
   {
     label: 'legifrance.gouv.fr',
     href: 'https://legifrance.gouv.fr',
+    title: 'Légifrance, nouvelle fenêtre',
   },
   {
     label: 'info.gouv.fr',
     href: 'https://info.gouv.fr',
+    title: 'Informations gouvernementales, nouvelle fenêtre',
   },
   {
     label: 'service-public.fr',
     href: 'https://service-public.fr',
+    title: 'Informations et démarches administratives, nouvelle fenêtre',
   },
   {
     label: 'data.gouv.fr',
     href: 'https://data.gouv.fr',
+    title: 'Plateforme des données publiques, nouvelle fenêtre',
   },
 ]
 
@@ -71,24 +75,35 @@ app?.appContext.app.use(
     ],
   }),
 ).component('VIcon', VIcon)
+
+const partners = {
+  titleTag: 'h5',
+  title: 'Partenaires',
+  mainPartner: {
+    name: 'Partenaire 1',
+    href: '/partenaire-1',
+    logo: 'https://loremflickr.com/100/100/cat?random=1',
+  },
+}
 </script>
 
 <template>
   <DsfrFooter
-    :before-mandatory-links="beforeMandatoryLinks"
-    :after-mandatory-links="afterMandatoryLinks"
-    :a11y-compliance="a11yCompliance"
-    :logo-text="logoText"
-    :legal-link="legalLink"
-    :personal-data-link="personalDataLink"
-    :cookies-link="cookiesLink"
-    :a11y-compliance-link="a11yComplianceLink"
-    :desc-text="descText"
-    :home-link="homeLink"
-    :licence-text="licenceText"
-    :licence-to="licenceTo"
-    :licence-name="licenceName"
-    :licence-link-props="licenceLinkProps"
-    :ecosystem-links="ecosystemLinks"
+    :before-mandatory-links
+    :after-mandatory-links
+    :a11y-compliance
+    :logo-text
+    :legal-link
+    :personal-data-link
+    :cookies-link
+    :a11y-compliance-link
+    :desc-text
+    :home-link
+    :licence-text
+    :licence-to
+    :licence-name
+    :licence-link-props
+    :ecosystem-links
+    :partners
   />
 </template>

src/components/DsfrTable/DsfrTable.md

@@ -8,7 +8,7 @@ Le composant `DsfrTable` est un élément puissant et polyvalent pour afficher d
 
 <VIcon name="vi-file-type-storybook" /> La story sur le tableau sur le storybook de [VueDsfr](https://storybook.vue-ds.fr/?path=/docs/composants-dsfrtable--docs)
 
-::: warning
+::: warning CONSEIL
 
 Pour des tableaux complexes, nous vous recommandons d’utiliser [DsfrDataTable](/composants/DsfrDataTable)