Recherche
<gcds-search>
Autres noms : barre de recherche, boîte de recherche sur le site, champ de recherche.
Le composant recherche est un espace où entrer des mots-clés pour chercher des renseignements pertinents.
-
Requis sur Canada.ca
-
GitHub -
Figma
Aperçu du composant de recherche
Sur cette page
Codage et accessibilité de recherche
Placez le composant recherche dans l’en-tête
- Placez le composant recherche dans l'
en-tête sous la bascule de langue et alignez-le sur lasignature du gouvernement du Canada . - Assurez-vous que l'en-tête est réactif afin que le composant recherche apparaisse sous la signature et la bascule de langue sur les appareils mobiles.
Configurer le composant recherche pour chercher du contenu sur Canada.ca
- Utilisez le composant recherche pour effectuer une recherche globale sur Canada.ca. Par défaut, le composant est configuré pour effectuer une recherche sur Canada.ca.
- Optez de limiter la recherche à un domaine spécifique à un organisme ou un programme.
Optez pour la modification du point de terminaison de la recherche pour les applications ou sites transactionnels
- Optez pour la modification du point de terminaison de la recherche pour une application ou un site transactionnel lorsque le fait de quitter le site interromprait la tâche ou le flux de travail d'une personne.
- Utilisez la méthode de requête HTTP par défaut
GETdu composant, ou bien utilisezPOSTau besoin en définissant l'attributmethod. - Définissez l'attribut
actionsur un point de terminaison de votre choix et définissez l'attribut placeholder (message-guide) pour refléter l'étendue de la recherche. Le message-guide du champ de recherche remplira également le texte de l'étiquette.
Dans cette section
action
L'attribut action définit l'endroit où le formulaire envoit ses données.
<gcds-search action="search.html"></gcds-search>
method
L'attribut method définit comment le formulaire enverra les données du formulaire. Les options disponibles sont :
-
get -
post<gcds-search method="post"></gcds-search>
name
L'attribut name définit le nom du champ de recherche lors de l'envoi des données du formulaire.
<gcds-search name="search"></gcds-search>
placeholder
L'attribut placeholder définit le texte indicatif et le libellé du champ. Le deux prennent automatiquement la forme « Search [placeholder] ».
<gcds-search placeholder="Système de design GC"></gcds-search>
search-id
L'attribut search-id définit le id du champ.
<gcds-search search-id="searchform"></gcds-search>
suggested
La propriété suggested définit une liste de termes de recherche prédéfinis. La liste s'affichera sous forme de liste déroulante sur le champ lorsqu'il est mis en évidence.
<gcds-search suggested="['rouge', 'vert', 'bleu']"></gcds-search>
value
L'attribut value définit la valeur du champ de recherche. Définir cette valeur préremplira le champ au chargement.
<gcds-search value="Système de design"></gcds-search>
Générateur de code
Générez une version du composant dont vous avez besoin en sélectionnant les propriétés de code correspondantes ou explorez les possibilités en choisissant différentes valeurs de code.
-
Choisissez des valeurs de code pour obtenir l'élément que vous voulez.
-
Obtenez le code et intégrez-le dans votre environnement.
-
Ajoutez tout contenu nécessaire au composant (comme le texte du libellé).
Remarque : Conformément à la pratique courante, le générateur de code utilise l'anglais pour tous les éléments de code.
Aidez-nous à nous améliorer
Vous avez des questions ou des demandes? Faites-nous part de vos commentaires à l'aide de notre formulaire de contact.
Quelque chose ne va pas? Signalez-le sur GitHub en créant un