Options héritées

Pour aider certains utilisateurs à migrer entre les versions d’Astro, nous introduisons occasionnellement des options héritées (ou legacy en anglais).

Ces options vous permettent d’accepter certains comportements dépréciés ou obsolètes d’Astro dans la dernière version, afin que vous puissiez continuer à mettre à niveau et profiter des nouvelles versions d’Astro jusqu’à ce que vous soyez en mesure de mettre à jour complètement le code de votre projet.

collectionsBackwardsCompat

Type : boolean
Par défaut : false

Ajouté à la version : astro@6.0.0 Nouveau

L’option legacy.collectionsBackwardsCompat assure une rétrocompatibilité temporaire pour les projets incapables de migrer vers l’API Content Layer introduite dans la version 5.0.

astro.config.mjs

import { defineConfig } from 'astro/config';
export default defineConfig({
  legacy: {
    collections: true
  }
});

Cette option préserve certaines fonctionnalités héritées des collections de contenu de la v4 :

• Prend en charge type: 'content' et type: 'data' sans chargeurs
• Préserve les entrée d’API existantes : entry.slug et entry.render()
• Utilise des identifiants d’entrée basés sur le chemin au lieu d’identifiants basés sur le slug.

Il s’agit d’un outil d’aide à la migration temporaire. Migrez les collections vers l’API Content Layer, puis désactivez cette option.