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

CKTIS / CSS

Propriedade CSS `margin-top`

`margin-top` define a margem física superior; na escrita vertical o nome lógico muda com a direção, mas o lado físico continua em cima.

Versão: CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review

Sintaxe

<length-percentage> | auto | <anchor-size()>

margin-top define a margem física superior; na escrita vertical o nome lógico muda com a direção, mas o lado físico continua em cima.

O exemplo mede 12 px em cima tanto em LTR vertical, onde é inline-start, como em RTL, onde é inline-end. Separadamente, 10% de um tamanho em linha de 200 px dá 20 px, margens adjacentes de 30 px e 20 px colapsam para 30 px e -6px produz sobreposição.

Gramática: <length-percentage> | auto | <anchor-size()>.

O colapso segue o eixo lógico de bloco, não a vertical física: o par do exemplo está no eixo de bloco na escrita horizontal predefinida e pode colapsar, mas na escrita vertical o topo físico é um lado em linha e margin-top não colapsa aí. As margens de itens flex e grid também não colapsam; uma percentagem usa o tamanho em linha do bloco contentor, e são permitidos valores negativos e auto.

Exemplos

<!doctype html><meta charset="utf-8"><div id="vl"><i></i></div><div id="vr"><i></i></div><div id="pct"><i></i></div><div id="collapse"><i></i><i></i></div><div id="neg"><i></i><i></i></div><pre id="result"></pre><script>
const vertical=(box,dir)=>{box.style.cssText='position:relative;writing-mode:vertical-rl;direction:'+dir+';width:80px;height:80px';box.firstElementChild.style.cssText='position:absolute;top:0;right:0;width:20px;height:20px;margin-top:12px'};vertical(vl,'ltr');vertical(vr,'rtl');pct.style.cssText='position:relative;width:200px;height:60px';pct.firstElementChild.style.cssText='position:absolute;top:0;left:0;width:20px;height:20px;margin-top:10%';collapse.style.cssText='display:flow-root;width:100px';collapse.children[0].style.cssText='display:block;height:10px;margin-bottom:30px';collapse.children[1].style.cssText='display:block;height:10px;margin-top:20px';neg.style.cssText='display:flex;flex-direction:column;width:100px';neg.children[0].style.cssText='height:20px';neg.children[1].style.cssText='height:20px;margin-top:-6px';const gapTop=box=>Math.round(box.firstElementChild.getBoundingClientRect().top-box.getBoundingClientRect().top),ls=getComputedStyle(vl.firstElementChild),rs=getComputedStyle(vr.firstElementChild),[ca,cb]=[...collapse.children].map(x=>x.getBoundingClientRect()),[na,nb]=[...neg.children].map(x=>x.getBoundingClientRect());result.textContent='ltr-top='+gapTop(vl)+' start/end='+ls.marginInlineStart+'/'+ls.marginInlineEnd+'; rtl-top='+gapTop(vr)+' start/end='+rs.marginInlineStart+'/'+rs.marginInlineEnd+'; percent-top='+gapTop(pct)+'; collapsed-gap='+Math.round(cb.top-ca.bottom)+'; negative-gap='+Math.round(nb.top-na.bottom);
</script>

Resultado

ltr-top=12 start/end=12px/0px; rtl-top=12 start/end=0px/12px; percent-top=20; collapsed-gap=30; negative-gap=-6

O exemplo foi executado localmente numa sessão Chrome isolada e sem rede; o resultado provém da API CSS do navegador.

Fontes