mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
3af0d5d2e0
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
65 lines
2.2 KiB
Plaintext
65 lines
2.2 KiB
Plaintext
---
|
||
title: "Exemples"
|
||
description: "Afficher des code blocks dans la barre latérale droite sur les ordinateurs de bureau"
|
||
keywords: ["RequestExample", "ResponseExample", "code examples", "request-response"]
|
||
---
|
||
|
||
Les composants `<RequestExample>` et `<ResponseExample>` affichent des code blocks dans la barre latérale droite afin de créer une mise en page à deux colonnes qui maintient les exemples visibles pendant que les utilisateurs font défiler votre contenu. Ces composants sont conçus pour la documentation d’API, mais ils fonctionnent sur toutes les pages.
|
||
|
||
Cas d’utilisation courants :
|
||
|
||
* Documentation d’API endpoint avec des exemples de requête et de réponse
|
||
* Exemples de configuration accompagnés d’un texte explicatif
|
||
* Exemples de code auxquels les utilisateurs se réfèrent en suivant des instructions
|
||
* Exemples « avant/après » dans des tutoriels
|
||
|
||
Sur les appareils mobiles, les composants `<RequestExample>` et `<ResponseExample>` s’affichent comme des code blocks et peuvent être dépassés en faisant défiler.
|
||
|
||
<RequestExample>
|
||
```bash Request
|
||
curl --request POST \
|
||
--url https://dog-api.kinduff.com/api/facts
|
||
```
|
||
</RequestExample>
|
||
|
||
<ResponseExample>
|
||
```json Response
|
||
{ "status": "success" }
|
||
```
|
||
</ResponseExample>
|
||
|
||
<div id="requestexample">
|
||
## RequestExample
|
||
</div>
|
||
|
||
Utilisez `<RequestExample>` pour épingler des exemples de code dans la barre latérale droite. Ce composant fonctionne de façon similaire au composant [CodeGroup](/fr/components/code-groups), mais affiche le code dans la barre latérale plutôt qu’en ligne.
|
||
|
||
Vous pouvez inclure plusieurs code blocks dans un seul `<RequestExample>`. Chaque code block doit avoir un attribut title.
|
||
|
||
````mdx RequestExample
|
||
<RequestExample>
|
||
|
||
```bash Requête
|
||
curl --request POST \
|
||
--url https://dog-api.kinduff.com/api/facts
|
||
```
|
||
|
||
</RequestExample>
|
||
````
|
||
|
||
<div id="responseexample">
|
||
## ResponseExample
|
||
</div>
|
||
|
||
Le composant `<ResponseExample>` épingle les exemples de code dans la barre latérale droite, sous tout contenu `<RequestExample>` présent sur la même page.
|
||
|
||
````mdx ResponseExample
|
||
<ResponseExample>
|
||
|
||
```json Réponse
|
||
{ "status": "success" }
|
||
```
|
||
|
||
</ResponseExample>
|
||
````
|