
script : bgMax v1.1.1
langage : javascript
catégorie : module
usage : Un background-image toujours adaptĂ© aux mesures de la fenĂȘtre du visiteur, avec en prime une apparition en fondu.
tags : effets spéciaux - image
Une image de fond, quand elle est bien soignée, peut apporter à un site web un bel atout graphique. Hélas, avec la variété croissante des tailles d'écrans, on ne sait jamais dans quelles conditions le visiteur pourra profiter de notre belle image.
bgMax permet de pallier ce problème, et d'aller même un peu plus loin.
Pour commencer, il faut charger le script, en insérant le code suivant entre les balises <head> et </head> de la page :
<script src="bgMax.min.js" type="text/javascript"></script>
Ensuite, on déclenche l'éffet par un tout petit bout de javascript placé en fin de page, juste avant la balise </body> :
<script type=\"text/javascript\"> bgMax.init('dossier/mon-image.jpg'); </script>
On peut également paramétrer plusieurs options, que l'on passera en second argument de la fonction, sous la forme d'un tableau associatif :
var options = { option1 : valeur1, option2 : valeur2, optionN : valeurN }; bgMax.init('dossier/mon-image.jpg', options);
Les options disponibles sont les suivantes :
| option | type | description | par défaut |
| mode | String | mode d'ajustement de l'image. max : l'image occupe toute la largeur de la fenêtre, quite à déborder dans la hauteur. full : l'image tient toute entière dans la fenêtre, en occupant autant de place que possible. |
"max" |
|---|---|---|---|
| enlarge | Boolean | Autorise ou interdit l'agrandissement l'image au delà de ses dimensions réelles. |
true |
| reduce | Boolean | Autorise ou interdit la réduction de l'image en dessous de ses dimensions réelles. |
true |
| position | String |
positionnement css de l'image : "fixed" ou "absolute" |
"absolute" |
| align | String |
alignement horizontal de l'image, par rapport à la largeur de la page : "left", "center", ou "right". |
"center" |
| vertAlign | String |
alignement vertical de l'image. En position absolue, cet alignement se fait par rapport à la hauteur de la page. En position fixe, il est fonction de la hauteur de la fenĂȘtre. Valeurs acceptĂ©es : "top", "bottom", ou"middle". |
"top" |
| fadeAfter | Mixed |
permet de faire apparaître l'image en fondu. false : pas d'effet de fondu. Integer : l'image apparaîte en fondu, si son chargement s'est terminé après le délai exprimé par cette valeur (en millisecondes). 0 : l'image apparaît en fondu dans tous les cas. |
1000 |
| fadeOptions | Object |
options du fondu. |
{ duration: 1000, frameRate: 25 } |
| zIndex | Integer |
profondeur css de l'image |
-1 |
| ffHack | String |
Pour une fois, ce n'est pas Internet Explorer mais Firefox qui nous casse les pieds ! |
"0px" |
L'image de fond de cette page est gérée par bgMax. Redimentionnez la fenêtre de votre navigateur et vous constaterez que l'image s'adapte à sa largeur.
Vous pouvez également essayer différents paramétrage du script dans ce bac à sable.
Vous trouverez dans ce zip une version minifiée du script (3,7Ko), et une autre commentée.
Notez que ce module embarque plusieurs fragments de code présentés sur ce site : fade, pour l'effet de fondu, transfer, qui facilite la gestion des options, et winDim, qui permet de connaître les mesures de la fenêtre.
compatibilité :
(autres navigateurs non testés)
Une module Joomla a également été développé pour faciliter l'intĂ©gration de bgMax sur cette plateforme. Ça se passe Par ici. Merci Lomart.
bgMax.init('image.jpg', {
mode : "full",
position : "fixed",
enlarge : 0,
fadeAfter : 0
});