CKTIS / JavaScript
Largura e altura em CSS em linha: `style.width` e `style.height`
Usa `element.style.width` e `element.style.height` para ler, definir e remover declarações CSS em linha. Ler uma declaração não é o mesmo que medir o elemento.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
element.style.width
element.style.height
element.style.width = cssWidth
element.style.height = cssHeight
element.style.width = ""
element.style.height = ""element.style.width e element.style.height leem e alteram declarações CSS no atributo style de um elemento HTML, não os seus atributos HTML width e height. element.style devolve um objeto que acompanha as alterações às declarações, não uma cópia estática. Cada propriedade devolve texto CSS ou "" se não houver uma declaração em linha, mesmo que uma folha de estilos forneça um valor.
Atribui cadeias de caracteres como "120px", "50%" ou "auto". Inclui px quando quiseres indicar píxeis: a API não acrescenta uma unidade a um número. Um valor inválido como "invalid" deixa a declaração existente inalterada. "" remove a declaração em linha e deixa a cascata determinar o valor; "auto", pelo contrário, define uma declaração.
Uma declaração em linha não garante o tamanho final. A cascata, a disposição dos elementos e restrições como max-width podem afetá-lo. Estas propriedades não se aplicam a elementos em linha não substituídos, como um span normal. box-sizing determina se o tamanho se refere à caixa de conteúdo (content-box) ou se também inclui o espaçamento interior e os contornos (border-box).
Para um elemento que participa na disposição da página, lê getComputedStyle(element).width ou .height para obter o valor CSS resolvido como texto. Para obter as dimensões do retângulo delimitador em píxeis CSS, chama element.getBoundingClientRect() e lê os valores numéricos width e height. O retângulo inclui o espaçamento interior e os contornos e tem em conta as transformações CSS. São API do navegador, não fazem parte do ECMAScript 2024 e exigem um ambiente com DOM.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>Inline width and height</title>
<script>
const element = document.createElement("div");
const style = element.style;
const log = () => console.log(JSON.stringify([style.width, style.height]));
log();
element.style.width = "50%";
element.style.height = "80px";
log();
element.style.width = "invalid";
log();
element.style.width = "";
element.style.height = "auto";
log();
</script>Resultado
["",""] ["50%","80px"] ["50%","80px"] ["","auto"]
Guarda o exemplo num ficheiro `.html`, abre-o num navegador e consulta a consola de desenvolvimento. O `div` não é inserido no documento, pelo que as quatro linhas mostram declarações, não medições da disposição da página.
Lições relacionadas
- JavaScript · Lição 12 · Avançado · Versão: 4