Aller au contenu

Composant Schema

Le composant <Schema /> sérialise vos entités Schema.org en une balise <script type="application/ld+json"> assainie, avec zéro JavaScript côté client.


Astro

src/layouts/BaseLayout.astro
---
import { Schema } from '@unschema-graph/astro';
---
<head>
<Schema items={[organization, article]} />
</head>

Svelte 5

src/routes/+page.svelte
<script lang="ts">
import { Schema } from '@unschema-graph/svelte';
</script>
<!-- Rendu automatique dans le <head> via <svelte:head> -->
<Schema items={[organization, article]} baseUrl="https://mon-site.fr" />

Propriété Type Défaut Description
items (SchemaOrgEntity | null | undefined)[] undefined Tableau d’entités à fusionner dans le @graph unifié.
item SchemaOrgEntity | null undefined Raccourci pour transmettre une seule entité.
data SchemaOrgEntity | SchemaOrgEntity[] | null undefined Alias universel acceptant une entité unique ou un tableau.
baseUrl string Voir priorité ci-dessous Résout les valeurs @id relatives explicites par rapport à cette origine.
inLanguage string Voir priorité ci-dessous Renseigne la langue par défaut pour les entités compatibles.
pretty boolean false Active le formatage indenté du JSON pour le débogage.
indent number 2 Nombre d’espaces d’indentation si pretty est actif.
graph boolean true Enveloppe les entités dans un @graph. Si false et 1 seule entité, rendu à plat.
context string 'https://schema.org' URL du contexte JSON-LD racine.
debug (Astro uniquement) boolean false Injecte un commentaire diagnostic HTML et affiche des logs dans le terminal.

Lors de la résolution des identifiants relatifs (#organization, /articles/guide#article) :

  1. Composant Astro : prop baseUrl → configuration intégration/globale → repli Astro.site. L’intégration Astro écrit son option baseUrl dans cette configuration globale ou y écrit config.site lorsque l’option est absente.
  2. Composant Svelte : prop baseUrl → configuration globale.
  3. API Core : la valeur baseUrl transmise dans GraphOptions. getGlobalConfig() reste accessible au code de l’application, mais buildJsonLdGraph() ne la lit pas automatiquement.

Pour l’enrichissement linguistique, la valeur inLanguage déjà présente sur une entité est toujours conservée. Sinon, Astro utilise la prop du composant, puis Astro.currentLocale, puis le défaut intégration/global. Svelte utilise la prop du composant, puis le défaut global.


Méthode recommandée : passez toutes les entités du layout et de la page dans un appel unique à <Schema /> :

src/pages/article.astro
<Schema items={[editeurOrg, auteurPerson, articleNode, filAriane]} />
src/pages/a-propos.astro
<Schema item={organisation} />
src/pages/index.astro
<Schema
items={[org, website]}
pretty={import.meta.env.DEV}
debug={import.meta.env.DEV}
/>