Cartes d’importation : `importmap`
Associez les spécificateurs de modules nus à des URL avec `importmap`.
Cartes d’importation : `importmap` est une leçon HTML Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage HTML Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours HTML Academy comprend 4 leçons au total.
Le problème des spécificateurs nus
Dans Node, import "lodash" fonctionne parce que le résolveur trouve node_modules/lodash. Les navigateurs n’ont pas de node_modules — ils ont besoin d’une véritable URL. Sans aide, import "lodash" déclenche l’erreur « Échec de la résolution du spécificateur de module ».
Rôle des cartes d’importation
Une carte d’importation déclare un dictionnaire JSON qui associe des spécificateurs nus (et des préfixes d’URL) à des URL réelles. Le navigateur consulte la carte lors de la résolution des modules et transforme import "lodash" en une récupération depuis l’URL que vous avez configurée.
<script type="importmap">
{
"imports": {
"lodash": "https://esm.sh/lodash@4.17.21",
"preact": "https://esm.sh/preact"
}
}
</script>L’ordre des déclarations compte
La carte d’importation doit apparaître avant tout <script type="module"> qui utilise des spécificateurs nus — dès qu’un module a commencé à résoudre ses importations, la carte est figée. Placez le <script type="importmap"> vers le haut du <head>.
Correspondances de préfixes
Les entrées se terminant par une barre oblique correspondent aux préfixes d’URL : "@/": "/src/" redirige toute import "@/utils/sum.js" vers /src/utils/sum.js. C’est ainsi que vous simulez la syntaxe d’alias généralement prise en charge par les outils de regroupement.
Gestion des versions par carte
Une carte d’importation centralise les choix de version : modifiez "react" de esm.sh/react@18 à esm.sh/react@19 en un seul endroit et chaque module qui l’importe récupère la nouvelle URL. Sans carte d’importation, chaque endroit d’importation contient sa propre version codée en dur.
Portées
La clé scopes permet de définir des correspondances différentes pour différentes parties de votre site. Dans /admin/, vous pouvez vouloir une version plus récente d’une dépendance que dans /public/ ; les portées vous permettent de cibler les chemins.
{
"imports": { "lodash": "https://esm.sh/lodash@4" },
"scopes": {
"/admin/": { "lodash": "https://esm.sh/lodash@5" }
}
}Une seule carte par document
Chaque document peut contenir au maximum un <script type="importmap">. En placer deux sur la même page n’est pas valide ; fusionnez leur contenu en un seul bloc pour combiner les entrées.
Cartes d’importation externes
Vous pouvez héberger la carte à une URL externe avec <script type="importmap" src="map.json">. La prise en charge par les navigateurs est plus récente que pour les cartes en ligne, mais elle est désormais largement répandue ; cette solution est utile lorsque vous souhaitez mettre en cache une grande carte séparément du document.
Génération des cartes d’importation
Des outils comme le générateur JSPM et le mode --servedir d’esbuild produisent automatiquement des cartes d’importation à partir de package.json. Les cartes générées incluent chaque dépendance transitive et associent chacune à une URL de CDN — un flux de travail sans node_modules.
Prise en charge par les navigateurs
Les cartes d’importation sont disponibles dans Chrome, Edge, Safari et Firefox. Les navigateurs plus anciens ignorent la balise <script type="importmap">, ce qui signifie que les spécificateurs nus échouent. Pour une large prise en charge des anciens navigateurs, construisez l’application avec un outil de regroupement qui résout les spécificateurs lors de la construction et diffusez des URL simples.
Option de correctif de compatibilité
Le correctif de compatibilité ES Module Shims (es-module-shims.js) ajoute la prise en charge des cartes d’importation — ainsi que de plusieurs fonctionnalités plus récentes — aux anciens navigateurs. Incluez-le avant votre script importmap. La plupart des projets modernes ignorent le correctif de compatibilité et s’appuient sur la prise en charge native.
Vérification des connaissances
Pourquoi un <script type="importmap"> doit-il apparaître avant tout script de module qui utilise des spécificateurs nus ?
Résumé
Les cartes d’importation associent des spécificateurs nus et des préfixes d’URL à de véritables URL, ce qui rétablit dans le navigateur la syntaxe Node « import lodash ». Déclarez-les une fois par document avant tout script de module, éventuellement dans un fichier externe via src, avec des portées pour les remplacements par chemin. Combinez-les avec un CDN (esm.sh, jsdelivr) pour un flux de travail sans node_modules.
Questions Fréquemment Posées
La leçon « Cartes d’importation : `importmap` » est-elle gratuite ?
Oui — le texte complet de « Cartes d’importation : `importmap` » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours HTML Academy, passe à CoddyKit PRO. Le cours HTML Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Cartes d’importation : `importmap` » ?
Associez les spécificateurs de modules nus à des URL avec `importmap`. Tu pratiques HTML Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer HTML Academy ?
Aucune expérience préalable n'est requise. HTML Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « Cartes d’importation : `importmap` » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon HTML Academy ?
Oui. Chaque leçon HTML Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Scripts de modules ES : `type=module`
- Cartes d’importation : `importmap`
- `import()` dynamique dans les modules
- Notions fondamentales de la fédération de modules