CKTIS / CSS
Propriedade CSS `list-style-image`
`list-style-image` seleciona a imagem usada no lugar do símbolo do marcador de lista.
Versão: CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review
Sintaxe
<image> | nonelist-style-image seleciona a imagem usada no lugar do símbolo do marcador de lista.
O exemplo atribui uma imagem local a um li real e indica listStyleImage e o estilo de ::marker.
A gramática aceite é <image> | none; os valores globais continuam na cascata.
Se a imagem não estiver disponível ou o valor for none, a renderização recorre a list-style-type.
Exemplos
<!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>Resultado
value=linear-gradient(red, blue); type=disc; position=outside; image=linear-gradient(rgb(255, 0, 0), rgb(0, 0, 255)); marker=inline-block
O exemplo foi executado localmente numa sessão Chrome isolada e sem rede; o resultado provém da API CSS do navegador.