Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

src — endereço do recurso

O atributo `src` especifica o URL de um recurso utilizado por um elemento HTML, como uma imagem, um script ou uma gravação. Não é um atributo global: a sua aplicabilidade, obrigatoriedade e forma de carregamento dependem do elemento.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

src="URL"

src fornece o endereço de um recurso, não o seu conteúdo nem o texto alternativo. O valor indicado tem de ser um URL válido e não vazio; são permitidos espaços em redor. Os endereços relativos são resolvidos em relação ao URL base do documento. Não utilize src="" em vez de omitir o atributo.

Em img, identifica uma imagem; é obrigatório pelo menos um dos atributos src e srcset. A seleção adaptativa através de srcset ou picture pode fazer com que seja utilizada outra imagem. alt fornece texto alternativo, não um endereço. Em input, src aplica-se apenas a type="image" e é obrigatório nesse caso. Em iframe, identifica uma página, mas um srcdoc presente tem prioridade; em embed, identifica o recurso incorporado.

Em audio e video, identifica a gravação. Especifique recursos alternativos com elementos source, omitindo src no elemento pai. Cada um desses elementos source exige src. Em contrapartida, um source dentro de picture tem de utilizar srcset e não pode ter src. Em track, o src obrigatório identifica dados de uma faixa de texto, como legendas. Alterar apenas source.src num elemento multimédia existente não muda a reprodução; alterar src em audio ou video aciona o algoritmo de carregamento.

Em script, src obtém código em vez de utilizar o texto filho do elemento. Só é permitido para scripts clássicos e módulos JavaScript, não para mapas de importação nem blocos de dados. Não trate o texto de um script com src como código de substituição. O exemplo utiliza uma imagem SVG autónoma num URL data:, pelo que não é necessário um ficheiro de imagem separado.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>src example</title>
</head>
<body>
  <img
    src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='80'%3E%3Crect%20width='80'%20height='80'%20fill='blue'/%3E%3C/svg%3E"
    alt="Blue square"
    width="80"
    height="80">
</body>
</html>

Resultado

An 80 × 80 CSS-pixel blue square.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes