Dom CSS : Objet CSSMediaRule.insertRule

La méthode javascript Définition

Définition

La méthode javascript CSSMediaRule.insertRule() permet d'ajouter un bloc de règle à une position précise dans CSSMediaRule.cssRules.
Exemple de code :
<style type="text/css" id="media">
@media print {
  BODY { font-size: 10pt }
}
</style>
/*
Dans cet exemple nous considérons que mediaRule est un objet de type interface CSSMediaRule
*/
alert(mediaRule.cssRules.length);
//1
var index = mediaRule.insertRule("br{ color:red }",0);
alert(index)
//0
alert(mediaRule.cssRules.length);
//2

Paramètres de insertRule

Paramètres

La méthode javascript CSSMediaRule.insertRule(regle,Number) accepte comme paramètres :
- regle valeur de type String qui représente un bloc de propriété.
- Number est un entier allant de 0 à CSSMediaRule.cssRules.length-1.

Valeur retournée de insertRule

Valeur retournée

La méthode javascript CSSMediaRule.insertRule(regle,Number) retourne une valeur de type Number qui correspond à l'index de la nouvelle règle.

Exceptions de insertRule

Exceptions

La méthode javascript CSSMediaRule.insertRule() renvoie comme exceptions:
- HIERARCHY_REQUEST_ERR : la règle ne peut être insérée à l'index fourni, par exemple, si une règle @import est insérée après un jeu de règles standard ou une autre règle-at.
- INDEX_SIZE_ERR : l'index fourni n'est pas un point d'insertion valide.
- NO_MODIFICATION_ALLOWED_ERR : la règle media est en lecture seule.
- SYNTAX_ERR : la règle indiquée a une syntaxe erronée et n'est pas analysable.