Método insertRule() do XML DOM

Definição e uso

O método insertRule() insere uma regra no estilo.

Sintaxe:

insertRule(regra,index)
Parâmetros Descrição
regra

Obrigatório. A representação textual completa e parseável da regra a ser adicionada ao estilo.

  • Para conjuntos de regras (rule sets),regra indica o seletor e a declaração de estilo.
  • Para regras @ (At rules),regra Indica o identificador @ e o conteúdo da regra.
index Obrigatório. A posição onde a regra deve ser inserida ou anexada ao array cssRules.

Retorno

o valor do parâmetro index.

lançar

Este método lançará uma exceção com o seguinte código em uma das seguintes situações: Exceção DOMException:

HIERARCHY_REQUEST_ERR
A sintaxe CSS não permite que a regra especificada apareça na posição especificada.
INDEX_SIZE_ERR
index Não corresponde a nenhuma regra no conjunto de regras da tabela, como index é um número negativo ou maior que o valor cssRules.length.
NO_MODIFICATION_ALLOWED_ERR
Este estilo é apenas leitura.
SINTESE
especificado regra O texto tem um erro de texto.

Descrição

Este método será executado no array cssRules da tabela de estilos na posição especificada index Insira (ou anexe) uma nova regra CSS. Este é um método padrão do DOM, consulte CSSStyleSheet.addRule(),é um método alternativo específico para o IE.

Exemplo

Empurrar uma regra para o topo da tabela de estilos:

myStyle.insertRule("#blanc { color: white }", 0);

Páginas relacionadas

Manual de referência do XML DOM:CSSStyleSheet.addRule()