Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

Attributo HTML width

L’attributo width specifica la larghezza degli elementi HTML che lo supportano. Accetta un numero intero non negativo senza unità. Su canvas controlla la larghezza del bitmap, non soltanto le dimensioni di visualizzazione impostate con CSS.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

width="<non-negative integer>"

width non è un attributo globale. Specifica la dimensione orizzontale in pixel CSS per img, iframe, embed, object, video, input con type="image" e per source il cui elemento genitore è picture. Il valore è un numero intero non negativo, ad esempio width="240", senza px né %.

Gli attributi di dimensione sono indicazioni per il rendering; CSS può modificare le dimensioni di visualizzazione. Non servono a deformare le immagini: una coppia width e height dovrebbe mantenere le proporzioni naturali entro la tolleranza di arrotondamento definita dallo standard. picture non supporta direttamente width; l’immagine viene visualizzata dal suo elemento img e le dimensioni possono essere specificate anche sugli elementi source pertinenti.

Su canvas, l’attributo width controlla la larghezza del bitmap. Se il valore manca o si verifica un errore durante l’analisi, viene usato il valore predefinito 300; l’altezza predefinita è 150. Modificare soltanto le dimensioni CSS ridimensiona la presentazione senza cambiare le dimensioni del bitmap. Impostare width con un contesto 2D cancella il bitmap e reimposta lo stato di disegno, anche quando si assegna il valore già presente.

L’esempio distingue le due dimensioni: il bitmap misura 240 × 120, ma viene visualizzato a 480 × 240 pixel CSS.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>width attribute</title>
<canvas id="drawing" width="240" height="120" style="width: 480px; height: 240px">Canvas demonstration</canvas>
<pre id="result"></pre>
<script>
  const canvas = document.getElementById('drawing');
  document.getElementById('result').textContent =
    `Bitmap: ${canvas.width} x ${canvas.height}\n` +
    `CSS width: ${getComputedStyle(canvas).width}`;
</script>
</html>

Risultato

Bitmap: 240 x 120
CSS width: 480px

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti