Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

anchor-name : nommer une boîte qu’un autre élément peut suivre

Reliez un élément positionné à une ancre admissible sans recopier ses coordonnées en JavaScript.

Version : CSS Modules

Syntaxe

anchor-name: --target;

anchor-name attribue à la boîte principale d’un élément un ou plusieurs identifiants commençant par deux tirets, par exemple --target ou une liste séparée par des virgules. none n’attribue aucun nom. La propriété seule ne déplace pas l’ancre, ne crée pas de popup et ne définit pas la navigation au clavier. Un élément positionné peut sélectionner le nom par position-anchor et obtenir un bord de la boîte cible avec anchor().

Les noms ne sont pas nécessairement uniques. La cible sélectionnée dépend de la portée, des relations DOM et de l’admissibilité d’un candidat dont la mise en page peut être calculée à temps. Les composants réutilisables doivent gérer cette portée volontairement, au lieu de traiter les noms comme des identifiants HTML globalement uniques. Un élément sans boîte appropriée ne fournit pas de géométrie d’ancrage ordinaire. Prévoyez des replis et vérifiez toute la syntaxe de positionnement, pas seulement la reconnaissance d’anchor-name.

L’exemple nomme --target une ancre de 80×30px placée à left: 40px et top: 20px. Une deuxième boîte suit ses bords gauche et inférieur et apparaît à 40,50. Déplacer l’ancre à 100,50 amène la boîte dépendante à 100,80 sans calcul de sa position en JavaScript. Renommer l’ancre --other rompt la recherche : les replis explicites de 0px placent alors la boîte à 0,0. JavaScript ne fait que modifier les styles et lire la géométrie obtenue.

Exemples

const host = document.createElement('div');
host.style.cssText = 'position:relative;width:500px;height:200px';
const anchor = document.createElement('div'), popup = document.createElement('div');
anchor.style.cssText = 'position:absolute;left:40px;top:20px;width:80px;height:30px;anchor-name:--target';
popup.style.cssText = 'position:absolute;position-anchor:--target;left:anchor(left,0px);top:anchor(bottom,0px);width:50px;height:20px';
host.append(anchor,popup); document.body.append(host);
const position = () => {const a=host.getBoundingClientRect(),b=popup.getBoundingClientRect();return [Math.round(b.left-a.left),Math.round(b.top-a.top)].join(' ');};
console.log('anchored:', position());
anchor.style.left='100px'; anchor.style.top='50px';
console.log('moved:', position());
anchor.style.anchorName='--other';
console.log('missing name:', position());
host.remove();

Résultat

anchored: 40 50
moved: 100 80
missing name: 0 0

Exécuté dans Chromium 157.0.8103.51 au sein d’un bloc conteneur isolé. Le positionnement par ancre est une fonction CSS récente : testez les navigateurs cibles et prévoyez un repli utilisable. La résolution entre arbres fantômes, les alternatives automatiques de débordement et les interactions accessibles d’un popup ne sont pas couvertes.

Sources