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
- HTML Standard — The img element
- HTML Standard — The source element
- HTML Standard — The embed element
- HTML Standard — The iframe element
- HTML Standard — Image Button state
- HTML Standard — Location of the media resource
- HTML Standard — The track element
- HTML Standard — The audio element
- HTML Standard — The video element
- HTML Standard — The script element