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

CKTIS / CSS

Propriété CSS `list-style-image`

`list-style-image` choisit l’image utilisée à la place du symbole du marqueur de liste.

Version : CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review

Syntaxe

<image> | none

list-style-image choisit l’image utilisée à la place du symbole du marqueur de liste.

L’exemple affecte une image locale à un vrai li et rapporte listStyleImage ainsi que le style de ::marker.

La grammaire acceptée est <image> | none ; les valeurs globales participent toujours à la cascade.

Si l’image est indisponible ou vaut none, le rendu revient à list-style-type.

Exemples

<!doctype html>
<html lang="en"><meta charset="utf-8"><title>CKTIS CSS reference example</title>
<body><div class="probe">probe</div><pre id="result"></pre><script>
document.body.innerHTML = '<ul><li id="item">entry</li></ul><pre id="result"></pre>';
const item=document.querySelector("#item");const property="list-style-image";const candidates=["linear-gradient(red, blue)","none"];
const value=candidates.find(candidate=>CSS.supports(property,candidate));item.style.setProperty(property,value);
const style=getComputedStyle(item);const marker=getComputedStyle(item,"::marker");
document.querySelector("#result").textContent="value="+value+"; type="+style.listStyleType+"; position="+style.listStylePosition+"; image="+style.listStyleImage+"; marker="+marker.display;
</script></body></html>

Résultat

value=linear-gradient(red, blue); type=disc; position=outside; image=linear-gradient(rgb(255, 0, 0), rgb(0, 0, 255)); marker=inline-block

L’exemple a été exécuté localement dans une session Chrome isolée et sans réseau ; le résultat provient de l’API CSS du navigateur.

Sources