KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

rotate3d(): een asrichting en één draaihoek

Normaliseer een as met drie componenten, behandel de nulvector en maak de volgorde van ruimtelijke draaien expliciet.

Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

transform: rotate3d(0, 0, 1, 90deg);

De eerste drie argumenten van rotate3d() zijn eenheidsloze getallen voor de asrichting, geen drie hoeken of verplaatsingen. Het vierde argument is één hoek of een eenheidsloze nul. De browser normaliseert een niet-nulas: alle componenten met dezelfde positieve factor vermenigvuldigen verandert de draai niet. Een niet-normaliseerbare vector, zoals 0,0,0, maakt deze draai effectloos in plaats van de hele transformatielijst ongeldig.

Gezien vanaf het positieve aseinde naar de oorsprong is een positieve draai volgens de CSS-conventie met de klok mee. transform-origin bepaalt het punt waar de as doorheen loopt. Rotaties rond verschillende assen zijn doorgaans niet verwisselbaar: omwisselen kan het resultaat veranderen. Berekenen vereist geen perspectief; perspectief verandert de projectie. Een gedeelde driedimensionale ruimte voor afstammelingen behouden is een apart onderwerp.

Het voorbeeld gebruikt berekende matrices, geen visuele gok over diepte. De assen 0,0,1 en 0,0,5 sturen het punt allebei naar 0,10,0; de nulas laat het op 10,0,0 staan. De omgekeerde volgorde van de twee asrotaties geeft 1,0,0 of 0,-1,0 voor hetzelfde invoerpunt. Een lengte zoals 1px in de as wordt afgewezen omdat ascomponenten getallen zijn. De berekening controleert matrices, niet perspectivisch tekenen of de wisselwerking tussen geneste elementen.

Voorbeelden

const box = document.createElement('div');
document.body.append(box);
function point(transform, x, y, z) {
  box.style.transform = transform;
  const p = new DOMMatrix(getComputedStyle(box).transform).transformPoint(new DOMPoint(x,y,z));
  return [p.x,p.y,p.z].map(n => Number(n.toFixed(6))).join(',');
}
console.log('unit z axis:', point('rotate3d(0,0,1,90deg)',10,0,0));
console.log('scaled z axis:', point('rotate3d(0,0,5,90deg)',10,0,0));
console.log('zero axis:', point('rotate3d(0,0,0,90deg)',10,0,0));
console.log('X then Y list:', point('rotate3d(1,0,0,90deg) rotate3d(0,1,0,90deg)',0,0,1));
console.log('Y then X list:', point('rotate3d(0,1,0,90deg) rotate3d(1,0,0,90deg)',0,0,1));
console.log('length in axis:', CSS.supports('transform', 'rotate3d(1px,0,0,90deg)'));
box.remove();

Resultaat

unit z axis: 0,10,0
scaled z axis: 0,10,0
zero axis: 10,0,0
X then Y list: 1,0,0
Y then X list: 0,-1,0
length in axis: false

De browser voert beide volgordes uit op echte berekende matrices. Afronden verwijdert zichtbare zwevendekomma-ruis; de nulas is een draai zonder effect, geen terugval na een fout.

Bronnen