Ce composant est disponible depuis la version 1.1.0.
Nous sommes attentifs à vos retours afin de pouvoir apporter des corrections si nécessaire.
Soyez vigilant quand à son utilisation en production !
La citation permet de citer un texte dans une page éditoriale. La citation peut provenir d'un extrait d’un discours oral formulé par une tierce personne ou d’un texte écrit.
Structure
La citation est composée des éléments suivants :
le texte de la citation - obligatoire
une icône - obligatoire - qui permet d’informer l’utilisateur qu’il s’agit d’une mise en avant de citation
un texte pour l’auteur - optionnel - afin de préciser quand nécessaire l’auteur de la citation
un texte pour les détails de la citation - optionnel - afin de préciser l’origine du texte cité
image d’illustration - optionnelle
un séparateur - obligatoire - verticale en desktop, horizontal en mobile
La citation est disponible en deux variantes : avec illustration ou sans illustration.
Citation avec illustration
La citation avec illustration permet d'incarner l’auteur de la citation avec une image .
Complète
<figure class="fr-quote fr-quote--column">
<blockquote cite="[À MODIFIER | https://lien-vers-la-source.fr || supprimer l'attribut si pas d'url pour la source']">
<p>« Lorem [...] elit ut. »</p>
</blockquote>
<figcaption>
<p class="fr-quote__author">Auteur</p>
<ul class="fr-quote__source">
<li>
<cite>Ouvrage</cite>
</li>
<li>Détail 1</li>
<li>Détail 2</li>
<li>Détail 3</li>
<li>
<a target="_blank" href="[À MODIFIER | Lien vers la sources ou des infos complémentaires]">Détail 4</a>
</li>
</ul>
<div class="fr-quote__image">
<img src="../img/placeholder.1x1.png" class="fr-responsive-img" alt="" />
<!-- L’alternative de l’image (attribut alt) doit rester vide car l’image est illustrative et ne doit pas être restituée aux technologies d’assistance -->
</div>
</figcaption>
</figure>
Sans auteur
<figure class="fr-quote fr-quote--column">
<blockquote cite="[À MODIFIER | https://lien-vers-la-source.fr || supprimer l'attribut si pas d'url pour la source]">
<p>« Lorem [...] elit ut. »</p>
</blockquote>
<figcaption>
<ul class="fr-quote__source">
<li>
<cite>Ouvrage</cite>
</li>
<li>Détail 1</li>
<li>Détail 2</li>
<li>Détail 3</li>
<li>
<a target="_blank" href="[À MODIFIER | Lien vers la sources ou des infos complémentaires]">Détail 4</a>
</li>
</ul>
<div class="fr-quote__image">
<img src="../img/placeholder.1x1.png" class="fr-responsive-img" alt="" />
<!-- L’alternative de l’image (attribut alt) doit rester vide car l’image est illustrative et ne doit pas être restituée aux technologies d’assistance -->
</div>
</figcaption>
</figure>
Sans détails
<figure class="fr-quote fr-quote--column">
<blockquote cite="[À MODIFIER | https://lien-vers-la-source.fr || supprimer l'attribut si pas d'url pour la source]">
<p>« Lorem [...] elit ut. »</p>
</blockquote>
<figcaption>
<p class="fr-quote__author">Auteur</p>
<div class="fr-quote__image">
<img src="../img/placeholder.1x1.png" class="fr-responsive-img" alt="" />
<!-- L’alternative de l’image (attribut alt) doit rester vide car l’image est illustrative et ne doit pas être restituée aux technologies d’assistance -->
</div>
</figcaption>
</figure>
Sans source
<figure class="fr-quote fr-quote--column">
<blockquote cite="[À MODIFIER | https://lien-vers-la-source.fr || supprimer l'attribut si pas d'url pour la source]">
<p>« Lorem [...] elit ut. »</p>
</blockquote>
<figcaption>
<div class="fr-quote__image">
<img src="../img/placeholder.1x1.png" class="fr-responsive-img" alt="" />
<!-- L’alternative de l’image (attribut alt) doit rester vide car l’image est illustrative et ne doit pas être restituée aux technologies d’assistance -->
</div>
</figcaption>
</figure>
Citation sans illustration
La citation sans illustration est à utiliser quand il n’est pas nécessaire ou pas possible d’incarner l’auteur de la citation.
<figure class="fr-quote fr-quote--column">
<blockquote cite="[À MODIFIER | https://lien-vers-la-source.fr || supprimer l'attribut si pas d'url pour la source]">
<p>« Lorem [...] elit ut. »</p>
</blockquote>
<figcaption>
<p class="fr-quote__author">Auteur</p>
<ul class="fr-quote__source">
<li>
<cite>Ouvrage</cite>
</li>
<li>Détail 1</li>
<li>Détail 2</li>
<li>Détail 3</li>
<li>
<a target="_blank" href="[À MODIFIER | Lien vers la sources ou des infos complémentaires]" rel="noopener" >Détail 4</a>
</li>
</ul>
</figcaption>
</figure>
La citation sans illustration se décline elle aussi sans auteur, sans citation et sans source.
Variante mobile
En mobile, le séparateur passe en dessous le texte de la source sur les deux versions avec ou sans illustration.
Pour la citation avec illustration, l’image est affichée en dessous le texte de la citation.
Règles d’utilisation
Pour le texte de la citation, il faut intégrer au début et à la fin des guillemets avec des espaces insécables.
Pour la source, un ouvrage doit obligatoirement être en italique.
Des champs détails non précisés sont prévus pour d’autres information, par exemple : édition, collection, date, ville, la fonction ou titre de l’auteur. Pour indiquer une URL dans ce champ, ajouter un soulignement pour en faire un lien.
Deux citations ne peuvent se suivre directement.
Accessibilité/SEO
Lorsque la citation reprend un text d’un autre site, ajouter l’url de celui-ci en attribut cite=”” du <blockquote> afin d’indiquer au moteur de recherche la liaison. Ne mettez pas l’attribut si aucune url de ressource n’est disponible.
L’ouvrage cité doit être placé dans une balise <cite> et ainsi apparaitre en italique.
Le texte de la citation est contenu dans un <blockquote> inséré dans un bloc <figure> et les infos complémentaires (image, auteur, ouvrage... ) dans le <figcaption>.
Contenus
Une citation n’est pas limité en nombre de caractère, tant qu’elle est correctement “sourcée”, il convient cependant de ne pas excéder une taille trop importante pour éviter que le bloc ne prenne trop de place, notamment en mobile.
Pour rappel, les citations courtes d’une oeuvre publiée sont autorisées et encadrées en France par le Code de la Propriété Intellectuelle et plus précisément l'article L122-5.
Personnalisation
Certains éléments du composant sont optionnels, voir sa structure.
Couleurs d’accent
L'élément Icône peut utiliser les couleurs illustratives :
Élément | Valeur par défaut | Valeur(s) autorisée(s) | |
|---|---|---|---|
Token | Classe css | ||
Fond | $artwork-minor-blue-france Correspondance : | $[couleur]-main (thèmes clair / sombre) exemples : | .fr-quote--[couleur]
|
Voir l’ensemble des couleurs illustratives à disposition
Besoin d’aide ?
L'équipe du DSFR est là pour vous aider.
Retrouvez-la sur :
la communauté slack pour poser vos questions, et échanger avec d’autres utilisateurs.
Vous êtes agent de l’État et souhaitez accéder au slack ? Rejoignez la communauté dès maintenant !le centre de support pour envoyer vos demandes de correctifs et d'évolution.