La bibliothèque iframe-resizer vise à éliminer les problèmes liés à l'utilisation des iframes. Il redimensionnera votre iframe pour qu'elle corresponde à la taille de votre contenu, puis surveillera l'iframe pour s'assurer qu'elle a toujours la taille parfaite.
Comme les navigateurs ne fournissent pas une méthode unique et fiable pour calculer la taille du contenu, iframe-resizer inspecte automatiquement votre page et sélectionne la meilleure valeur pour votre contenu chaque fois qu'il détecte quelque chose de modifié.
Pour garantir un impact minimal sur votre site, iframe-resizer est hautement optimisé et utilise la théorie des ensembles pour garantir qu'il vérifie uniquement les éléments de page qui affectent le dimensionnement de vos iframes.
Même sur les pages les plus complexes, iframe-resizer peut détecter les modifications apportées au HTML et au CSS, calculer les dimensions du contenu révisées et mettre à jour l'iframe en moins d'une milliseconde.
Prend en charge les iframes internes (même domaine) et externes (inter-domaines) via un simple fichier JS conçu pour être un invité sans impact sur les sites qui l'hébergent.
De plus, iframe-resizer fournit une gamme de fonctionnalités API de navigateur manquantes, qui vous permettent d'intégrer en toute sécurité votre contenu iframe à la page parent.
onMouseEnter
et onMouseLeave
à l'élément iframeLorsqu'il est combiné avec viewer.js, il peut même redimensionner les iframes contenant des documents PDF et ODF.
Veuillez consulter le site Web iframe-resizer pour les guides de configuration et la documentation de l'API. Cela inclut les versions pour :
Avec des guides de configuration pour :
Il existe également une API pour prendre en charge la création de composants personnalisés supplémentaires.
Cette version d'iframe-resizer a été largement réécrite pour utiliser les API de navigateur modernes, ce qui a permis de meilleures performances et une plus grande précision dans la détection des événements de redimensionnement de contenu.
Avec cette version, l'opportunité a été saisie pour actualiser et simplifier l'API. Si vous venez d'une version précédente, il existe un guide de mise à niveau pour expliquer les modifications.
Pour la version 5, iframe-resizer est divisé en deux packages principaux pour faciliter le déploiement sur différents domaines et mieux prendre en charge le tremblement d'arborescence. Ces deux packages peuvent être installés à partir de NPM ou téléchargés sous forme de fichier zip.
Le package de page parent configure une iframe pour le redimensionnement automatique du contenu. Il existe des versions de ce package pour plusieurs bibliothèques et frameworks populaires (voir ci-dessous).
Ce package doit être chargé dans l'iframe, où il attendra tranquillement un message de la page parent avant de s'initialiser. Il est conçu pour être un bon invité sur le site de quelqu'un d'autre.
En plus des deux packages principaux, il existe des versions du package parent pour les plates-formes suivantes.
Un composant React pour la page parent.
Un composant Vue pour la page parent.
Un simple wrapper jQuery pour la page parent.
L'API principale de la page parent, utilisée par @iframe-resizer/parent
, ainsi que les versions des composants du framework et de la bibliothèque.
Copyright © 2013-24 David J. Bradshaw - Sous licence GPL V3