@-moz-document

Résumé

La règle @-moz-document est une règle @ spécifique à Gecko qui restreint la portée des règles de styles qu'elle contient, selon l'URL du document. Elle est avant tout destinée aux feuilles de styles utilisateur. Une règle @-moz-document peut spécifier une ou plusieurs fonctions d'appariement. Si au moins une des fonctions s'applique à l'URL, la règle prendra effet à cette URL.

Les fonctions possibles sont :

  • url(), qui fait correspondre une URL exacte
  • url-prefix(), qui fait correspondre le début de l'URL du document
  • domain(), qui fait correspondre le domaine (ou sous-domaine)
  • regexp(), qui fait correspondre grâce à l'expression régulière exprimée.

Gecko 6.0 note
(Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3)

Le support de la fonction regexp()a été ajouté dans Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3).

Syntaxe

Les valeurs envoyées aux fonctions url(), url-prefix(), et domain() peuvent être comprises entre des guillemets simples ou doubles, et ce de manière optionnelle. Les valeurs envoyées à la fonction regexp() doivent être incluses entre des guillemets.

Les valeurs échappées envoyées à la fonction regexp() doivent être à nouveau échappées dans le CSS. Par exemple, un . (point) sélectionne n'importe quel caractère dans les expressions régulières. Pour sélectionner un point, il faut d'abord l'échapper en utilisant les règles des expressions régulières (faire \.), puis échapper cette chaîne en utilisant les règles CSS (faire \\.).

Exemples

@-moz-document url(http://www.w3.org/),
               url-prefix(http://www.w3.org/Style/),
               domain(mozilla.org)
{
  /* Ces règles CSS s'appliquent à :
     + la page "http://www.w3.org/".
     + les pages dont l'URL commence par "http://www.w3.org/Style/"
     + les pages dont l'URL de l'hôte est « mozilla.org » ou finit par
       « .mozilla.org »
   */

  /* Rendre les pages mentionnées ci-dessus vraiment immondes */
  body { color: purple; background: yellow; }
}

Spécifications

Compatibilité des navigateurs

Disponible depuis Mozilla 1.8 / Firefox 1.5.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : FredB
 Dernière mise à jour par : FredB,