-moz-image-region

Non standard

Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

Pour certains éléments XUL et les pseudo-éléments qui utilisent une image grâce à la propriété list-style-image, la propriété -moz-image-region définit la partie de l'image qui est utilisée plutôt que l'image toute entière. Cela permet d'utiliser des images qui regroupent des sprites afin d'améliorer les performances.

/* Valeur avec un mot-clé */
-moz-image-region: auto;

/* Valeur de type <shape> */
-moz-image-region: rect(0, 8px, 4px, 4px);

/* Valeurs globales */
-moz-image-region: inherit;
-moz-image-region: initial;
-moz-image-region: unset;

La syntaxe de cette propriété est semblable à la syntaxe de la propriété clip. Les quatre valeurs sont relatives au coin en haut à gauche de l'image.

Note : Pour un système qui fonctionne pour n'importe quel arrière-plan, on pourra utiliser la propriété -moz-image-rect.

Syntaxe

Valeurs

auto
La région pour l'image est définie automatiquement
<shape>
Une forme définit la portion d'image qui doit être utilisée. La fonction rect() permet de définir un rectangle. Les paramètres de cette fonction correspondent respectivement aux décalages des bords haut, droit, bas et gauche. Voir <shape>.

Syntaxe formelle

<shape> | auto


<shape> = rect(<top>, <right>, <bottom>, <left>)

Exemples

#example-button {
  /* display only the 4x4 area from the top left of this image */
  list-style-image: url("chrome://example/skin/example.png");
  -moz-image-region: rect(0px, 4px, 4px, 0px);
}
#example-button:hover {
  /* use the 4x4 area to the right of the first for the hovered button */
  -moz-image-region: rect(0px, 8px, 4px, 4px);
}

Spécifications

Cette propriété est une propriété propriétaire liée à Mozilla/Gecko et ne fait partie d'aucune spécification.

Valeur initialeauto
Applicabilitééléments XUL image et aux pseudo-éléments :-moz-tree-image, :-moz-tree-twisty et :-moz-tree-checkbox. Note : -moz-image-region ne fonctionnera qu'avec les éléments image où l'icône est définie avec list-style-image. Cela ne fonctionnera pas avec l'<image src="url" /> XUL.
Héritéeoui
Valeur calculéecomme spécifié
Type d'animationdiscrète

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi