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

CKTIS / CSS

background-position-y: escolher o desvio vertical

Mova cada fundo para cima ou para baixo sem confundir o eixo físico y com o fluxo de blocos.

Versão: CSS Modules

Sintaxe

background-position-y: 25%, calc(100% - 10px);

background-position-y define a componente vertical da posição do fundo. top, center, bottom, comprimentos e percentagens descrevem-na; o valor inicial 0% mede-se a partir do topo se não for indicada uma extremidade. Uma percentagem usa a altura da área de posicionamento menos a altura da imagem após background-size. Em particular, 100% alinha as extremidades inferiores, não o topo da imagem com o fundo do contentor. calc(100% - 10px) coloca a imagem 10px acima da sua posição alinhada em baixo.

A coordenada y continua física mesmo num modo de escrita vertical; não substitui uma propriedade lógica do eixo de bloco. background-position-x não muda ao definir apenas esta propriedade individual. Um background-position ou uma abreviatura background posteriores podem substituir ambas as coordenadas: a ordem das declarações importa. Os valores separados por vírgulas correspondem às camadas de background-image e as listas mais curtas repetem-se. background-origin escolhe a caixa de referência, enquanto background-repeat controla separadamente a repetição em mosaico.

O exemplo tem uma caixa de 100×200px com uma imagem vermelha de 20×40px em x=10px e uma azul de 20×20px em x=60px. Os valores y 25% e calc(100% - 10px) produzem extremidades superiores em 40px e 170px. A consola indica a lista x inalterada e a lista y calculada. Repetir o caso com vertical-rl e rtl preserva as posições físicas. As verificações de píxeis confirmam os retângulos vermelho e azul nas duas caixas, não apenas a análise bem-sucedida da sintaxe.

Exemplos

['horizontal-tb','vertical-rl'].forEach((writingMode,i)=>{
  const box=document.createElement('div');box.id='y-'+i;
  box.style.cssText='position:absolute;top:0;width:100px;height:200px;direction:rtl;background-image:linear-gradient(red,red),linear-gradient(blue,blue);background-size:20px 40px,20px 20px;background-repeat:no-repeat;background-position-x:10px,60px';
  box.style.left=(i*120)+'px';box.style.writingMode=writingMode;box.style.backgroundPositionY='25%, calc(100% - 10px)';document.body.append(box);
  const s=getComputedStyle(box);console.log(writingMode+': x='+s.backgroundPositionX+'; y='+s.backgroundPositionY);
});

Resultado

horizontal-tb: x=10px, 60px; y=25%, calc(100% - 10px)
vertical-rl: x=10px, 60px; y=25%, calc(100% - 10px)

Executado no Chromium 157.0.8103.51 com duas camadas de gradientes separadas à razão de píxeis 1. Os valores testados usam posicionamento físico a partir do topo; palavras-chave lógicas mais recentes, fundos deslocáveis e outros motores ficam fora desta execução.

Fontes