Configurar o limpador de HTML

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 1 min. de leitura
  • Você deve modificar uma inclusão de script para fazer mudanças de configuração no limpador de HTML.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Inclusões de script.
    2. Abra HTMLSanitizerConfig.
    3. Para adicionar itens à lista de exclusões, use a classe "HTML_BLACKLIST".

      Para adicionar itens à lista de inclusões, use a classe "HTML_WHITELIST".

      Use este formato:

      HTML_XXXXLIST :{
              globalAttributes :{ 
       
                  attribute:[attribute-name1,...],
                  attributeValuePattern:{ attribute-name2:attribute-value-regex-pattern,...}
       
              },<html-element-name>:{// Same as Above},----}
      • globalAttributes contém itens de atributo ou attributeValuePattern que são aplicáveis globalmente a todos os elementos HTML.
      • attribute é uma lista de atributos separados por vírgulas.
      • attributeValuePattern é um dicionário de atributos para pares atributo-valor-regex-padrão. "Atributo-valor-regex-padrão" é uma expressão regular que deve corresponder ao valor do atributo.

    Exemplo

    Considere o seguinte exemplo:

    HTML_WHITELIST:{
            globalAttributes:{
                attribute:["id","name"],},
            img:{
                attribute:["style","align"],
                attributeValuePattern:{src:".*jpeg"}}, 
            iframe:{},}

    Ele adiciona os seguintes itens à lista de inclusões:

    • O ID e o nome dos atributos globais. Essa é uma lista de cadeias de caracteres que podem ser aplicadas globalmente a todos os elementos.
    • O elemento "img" em que os atributos são estilizados e alinhados.
    • O elemento "img" em que o atributo de origem da imagem é um arquivo com a extensão .jpeg. Este é um exemplo de um padrão de expressão regular que corresponde a um valor de atributo.
    • O elemento "iframe".