Repository Public
1// Explorateur d'API — réponse JSON en arbre de texte repliable. Uniquement des nœuds de texte React : jamais de HTML injecté.2import { useState } from "react"3import { t } from "../../../i18n"4import type { Json } from "../../../admin/openapi"5import { Icon } from "../../kit"67/** Nombre d'enfants montrés d'emblée dans un nœud ; le reste s'ouvre à la demande. */8const PAGE = 1009/** Les deux premiers niveaux sont ouverts d'emblée. */10const OPEN_DEPTH = 21112const isContainer = (v: Json): v is Json[] | { [k: string]: Json } => typeof v === "object" && v !== null1314function Leaf({ value }: { value: Exclude<Json, Json[] | { [k: string]: Json }> }) {15 const kind = value === null ? "null" : typeof value16 return <span className={`adm-explorer-v ${kind}`}>{typeof value === "string" ? JSON.stringify(value) : String(value)}</span>17}1819function Node({ name, index, value, depth, last }: { name: string | null; /** rang dans un tableau (sert de nom accessible) */ index?: number; value: Json; depth: number; last: boolean }) {20 const [open, setOpen] = useState(depth < OPEN_DEPTH)21 const [shown, setShown] = useState(PAGE)22 const key = name === null ? null : (23 <>24 <span className="adm-explorer-k">{JSON.stringify(name)}</span>25 {": "}26 </>27 )28 const comma = last ? null : ","29 if (!isContainer(value)) {30 return (31 <li className="adm-explorer-leaf">32 {key}33 <Leaf value={value} />34 {comma}35 </li>36 )37 }38 const entries: [string | null, Json][] = Array.isArray(value) ? value.map((v) => [null, v]) : Object.entries(value)39 const [a, b] = Array.isArray(value) ? ["[", "]"] : ["{", "}"]40 if (!entries.length) {41 return (42 <li className="adm-explorer-leaf">43 {key}44 {a}45 {b}46 {comma}47 </li>48 )49 }50 return (51 <li>52 <button type="button" className="adm-explorer-toggle" aria-expanded={open} aria-label={t(open ? "adm.explorer.tree.collapse" : "adm.explorer.tree.expand", { name: name ?? (index === undefined ? t("adm.explorer.tree.root") : `[${index}]`) })} onClick={() => setOpen((o) => !o)}>53 <Icon name="chevron" small />54 </button>55 {key}56 {a}57 {open ? (58 <>59 <ul>60 {entries.slice(0, shown).map(([k, v], i) => (61 <Node key={k ?? i} name={k} index={k === null ? i : undefined} value={v} depth={depth + 1} last={i === entries.length - 1} />62 ))}63 {entries.length > shown ? (64 <li>65 <button type="button" className="btn small" onClick={() => setShown((n) => n + PAGE * 5)}>66 {t("adm.explorer.tree.more", { n: entries.length - shown })}67 </button>68 </li>69 ) : null}70 </ul>71 {b}72 </>73 ) : (74 <>75 <span className="adm-explorer-fold"> {t("adm.explorer.tree.items", { n: entries.length })} </span>76 {b}77 </>78 )}79 {comma}80 </li>81 )82}8384export function JsonTree({ value, label }: { value: Json; label: string }) {85 return (86 <div className="adm-explorer-tree mono" role="group" aria-label={label} tabIndex={0} data-testid="explorer-body">87 <ul>88 <Node name={null} value={value} depth={0} last />89 </ul>90 </div>91 )92}93