Aller au contenu

Utiliser les Intégrations

Les intégrations Astro permettent d’ajouter de nouvelles fonctionnalités et de nouveaux comportements à votre projet en quelques lignes de code. Vous pouvez écrire une intégration personnalisée vous-même, utiliser une intégration officielle ou utiliser des intégrations construites par la communauté.

Les intégrations peuvent…

  • Débloquer React, Vue, Svelte, Solid et d’autres frameworks UI populaires.
  • Intégrer des outils comme Tailwind et Partytown avec quelques lignes de code.
  • Ajouter de nouvelles fonctionnalités à votre projet, comme la génération automatique de sitemap.
  • Écrire du code personnalisé qui s’accroche au processus de construction, au serveur de développement, et plus encore.

Framework d'interface utilisateur

Adaptateurs SSR

Autres

Configuration automatique des intégrations

Titre de la section Configuration automatique des intégrations

Astro inclut une commande astro add pour automatiser la configuration des intégrations.

Exécutez la commande astro add en utilisant le gestionnaire de paquets de votre choix et notre assistant d’intégration automatique mettra à jour votre fichier de configuration et installera toutes les dépendances nécessaires.

Fenêtre de terminal
npx astro add react

Il est même possible d’ajouter plusieurs intégrations en même temps !

Fenêtre de terminal
npx astro add react tailwind partytown

Les intégrations Astro sont toujours ajoutées via la propriété integrations dans votre fichier astro.config.mjs.

Il y a trois façons d’importer une intégration dans votre projet Astro :

  1. En installant un paquet d’intégration npm.
  2. En important votre propre intégration depuis un fichier local dans votre projet.
  3. En écrivant votre intégration en ligne, directement dans votre fichier de configuration.
astro.config.mjs
import {defineConfig} from 'astro/config';
import installedIntegration from '@astrojs/vue';
import localIntegration from './my-integration.js';
export default defineConfig({
integrations: [
// 1. Importer à partir d'un paquet npm installé
installedIntegration(),
// 2. Importer depuis un fichier JS local
localIntegration(),
// 3. Depuis un objet en ligne
{name: 'namespace:id', hooks: { /* ... */ }},
]
})

Consultez l’API intégration de référence pour connaître les différentes façons d’écrire une intégration.

Les intégrations sont presque toujours conçues comme des fonctions “factory” qui renvoient l’objet d’intégration proprement dit. Cela vous permet de passer des arguments et des options à la fonction “factory” afin de personnaliser l’intégration pour votre projet.

integrations: [
// Exemple : Personnalisez votre intégration avec des arguments de fonction
sitemap({filter: true})
]

Les intégrations Falsy sont ignorées, vous pouvez donc les activer et les désactiver sans vous soucier des valeurs undefined et booléennes laissées en suspens.

integrations: [
// Exemple : Sauter la construction d'un plan du site sous Windows
process.platform !== 'win32' && sitemap()
]

Pour mettre à jour toutes les intégrations officielles en une seule fois, lancez la commande @astrojs/upgrade. Cela mettra à jour Astro et toutes les intégrations officielles vers leurs dernières versions.

Fenêtre de terminal
# Mise à jour d'Astro et des intégrations officielles vers la version la plus récente
npx @astrojs/upgrade

Pour mettre à jour manuellement une ou plusieurs intégrations, utilisez la commande appropriée de votre gestionnaire de paquets.

Fenêtre de terminal
# Exemple : mise à jour des intégrations React et Tailwind
npm install @astrojs/react@latest @astrojs/tailwind@latest

Pour supprimer une intégration, désinstallez d’abord l’intégration de votre projet

Fenêtre de terminal
npm uninstall @astrojs/react

Ensuite, supprimez l’intégration de votre fichier astro.config.* :

astro.config.mjs
import { defineConfig } from 'astro/config'
import react from "@astrojs/react";
export default defineConfig({
integrations: [
react()
]
})

Vous trouverez de nombreuses intégrations développées par la communauté dans le [répertoire des intégrations d’Astro] (https://astro.build/integrations/). Suivez les liens pour obtenir des instructions détaillées d’utilisation et de configuration

L’API d’intégration d’Astro s’inspire de Rollup et de Vite, et est conçue pour être familière à quiconque a déjà écrit un plugin Rollup ou Vite.

Consultez l’API intégration de référence pour apprendre ce que les intégrations peuvent faire et comment en écrire une vous-même.