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

CKTIS / CSS

type() : trois contextes aux significations différentes

Distinguez une exigence de syntaxe CSS d’une indication MIME d’image ; type() n’est pas un convertisseur de valeurs autonome.

Version : CSS Modules

Syntaxe

attr(data-size type(<length>), 12px); image-set(url("photo.avif") type("image/avif")); @function --f(--x type(<length> | <percentage>)) returns type(<length> | <percentage>) { result: var(--x); }

Dans attr(), type() demande au navigateur d’analyser l’attribut comme une longueur CSS. La chaîne 40px satisfait cette exigence, mais pas 40, nombre non nul sans unité. Une valeur de repli fournie est utilisée si l’attribut manque ou ne peut pas être analysé selon le type demandé. Cela diffère de attr(data-size px), qui interprète un attribut numérique avec une unité donnée. type() seul n’est pas une valeur de largeur.

Dans image-set(), type("image/avif") fournit une indication MIME de format d’image, sous forme d’une chaîne entre guillemets plutôt que d’une grammaire CSS comme . Un candidat dont l’indication MIME est invalide ou non prise en charge est exclu de la sélection ; la fonction peut encore contenir d’autres candidats utilisables. L’indication ne convertit pas le fichier et ne prouve pas que la ressource est valide. L’acceptation de la déclaration par CSS.supports() prouve seulement la prise en charge syntaxique, pas le décodage ni la sélection de ce candidat.

Le projet de spécification des fonctions personnalisées utilise aussi type() pour la syntaxe des paramètres et du résultat dans @function. Une syntaxe combinée comme | exige cette enveloppe. Cette forme décrit les valeurs CSS admises, pas les formats d’image. La prise en charge d’un contexte ne prouve pas celle d’un autre ; testez le contexte réellement utilisé.

Dans l’exécution enregistrée avec Chromium 157, attr() typé donne 40px pour 40px et la valeur de repli 12px pour 40 comme pour un attribut absent. Une règle de fonction personnalisée analysée produit une largeur réelle de 25px. Les sondes image-set() acceptent syntaxiquement une chaîne MIME connue et une autre inventée, tandis que width: type() est rejeté. Ces sondes ne chargent aucune image et ne montrent pas le rendu d’un format de repli.

Exemples

const box=document.createElement('div');
box.style.cssText='width:attr(data-size type(<length>), 12px);height:10px';document.body.append(box);
const width=value=>{if(value===null)box.removeAttribute('data-size');else box.setAttribute('data-size',value);return getComputedStyle(box).width};
const length=width('40px'),bad=width('40'),missing=width(null);
const sheet=new CSSStyleSheet();
sheet.replaceSync('@function --typed(--x type(<length> | <percentage>)) returns type(<length> | <percentage>) { result: var(--x); }');
document.adoptedStyleSheets=[...document.adoptedStyleSheets,sheet];
box.style.width='--typed(25px)';const custom=getComputedStyle(box).width;
console.log('attr='+length+','+bad+','+missing+'; custom-rule='+sheet.cssRules.length+'; custom-width='+custom+'; image-type-syntax='+CSS.supports('background-image','image-set(url("data:,") type("image/avif"))')+'; unknown-mime-syntax='+CSS.supports('background-image','image-set(url("data:,") type("image/x-not-real"))')+'; standalone='+CSS.supports('width','type(<length>)'));

Résultat

attr=40px,12px,12px; custom-rule=1; custom-width=25px; image-type-syntax=true; unknown-mime-syntax=true; standalone=false

L’exemple mesure la substitution d’attribut et le résultat d’une fonction personnalisée. Ses deux vérifications d’image sont volontairement limitées à la syntaxe ; true ne valide pas le format MIME inventé.

Sources