Skip to main content
Validação HTML

Valor inválido X para o atributo “poster” no elemento “video”: Carácter ilegal no segmento do caminho: espaço não é permitido.

Sobre este problema HTML

O atributo poster especifica uma imagem para mostrar como marcador de posição enquanto o vídeo está a carregar ou antes do utilizador iniciar a reprodução. Como todos os atributos HTML que aceitam URLs — como src, href, e action — o valor deve estar em conformidade com a sintaxe URI válida conforme definida pela RFC 3986. Neste padrão, um carácter de espaço literal não é um carácter legal em qualquer parte de um URL. Quando o validador encontra um espaço no valor do atributo poster, assinala-o como um carácter ilegal no segmento do caminho.

Embora a maioria dos navegadores modernos seja tolerante e tente resolver URLs contendo espaços em bruto codificando-os internamente, confiar neste comportamento é problemático por várias razões:

  • Conformidade com padrões: A especificação HTML requer URLs válidos. Espaços em bruto violam este requisito.
  • Interoperabilidade: Nem todos os agentes de utilizador, clientes HTTP, ou sistemas de entrega de conteúdo tratam espaços não codificados da mesma forma. Alguns podem truncar o URL no primeiro espaço ou falhar completamente na resolução do recurso.
  • Portabilidade: Se o seu HTML for consumido por ferramentas, scrapers, ou APIs que analisam URLs rigorosamente, espaços não codificados podem causar falhas silenciosas.
  • Consistência: Manter URLs devidamente codificados previne bugs subtis quando os caminhos são construídos dinamicamente em código do lado do servidor ou cliente.

A correção é simples. Você tem duas opções:

  1. Codificar os espaços por percentagem: Substitua cada espaço no URL por %20. Isto preserva os nomes originais de ficheiros e pastas no servidor enquanto produz um URL válido no seu HTML.
  2. Eliminar espaços dos nomes de ficheiros e pastas: Use hífens (-), sublinhados (_), ou camelCase em vez de espaços. Isto é geralmente considerado a melhor prática para recursos web, pois evita problemas de codificação de forma geral.

Note que esta regra aplica-se a todo o caminho do URL, não apenas ao nome do ficheiro. Se qualquer diretório no caminho contém um espaço, também deve ser codificado ou renomeado. O mesmo princípio aplica-se a outros carateres especiais que são reservados ou não permitidos em URLs, como {, }, |, ^, e [.

Exemplos

Incorreto — espaço no caminho

O nome da pasta video images contém um espaço, que é ilegal num segmento de caminho URL.

<video controls poster="/img/video images/snapshot.png">
  <source src="/videos/sample.mp4" type="video/mp4">
</video>

Incorreto — espaço no nome do ficheiro

O nome do ficheiro my poster.jpg também desencadeia o mesmo erro.

<video controls poster="/img/my poster.jpg">
  <source src="/videos/sample.mp4" type="video/mp4">
</video>

Corrigido — codificação por percentagem dos espaços

Cada espaço é substituído por %20, produzindo um URL válido.

<video controls poster="/img/video%20images/snapshot.png">
  <source src="/videos/sample.mp4" type="video/mp4">
</video>

Corrigido — remoção de espaços do caminho

Renomear a pasta para usar um hífen elimina completamente a necessidade de codificação.

<video controls poster="/img/video-images/snapshot.png">
  <source src="/videos/sample.mp4" type="video/mp4">
</video>

Corrigido — remoção de espaços do nome do ficheiro

<video controls poster="/img/my-poster.jpg">
  <source src="/videos/sample.mp4" type="video/mp4">
</video>

Como melhor prática geral, evite espaços em todos os nomes de ficheiros e pastas utilizados na web. Use hífens ou sublinhados em vez disso. Se estiver a trabalhar com ficheiros que não pode renomear — como recursos de um CMS ou sistema de terceiros — codifique sempre os espaços como %20 no seu HTML. Isto aplica-se não apenas a poster mas a todos os atributos que recebem um valor URL, incluindo src, href, action, data, e formaction.

Encontre problemas como este automaticamente

O Rocket Validator analisa milhares de páginas em segundos, detetando problemas HTML em todo o seu site.

Ajude-nos a melhorar os nossos guias

Este guia foi útil?

Pronto para validar os seus sites?
Comece o seu teste gratuito hoje.