Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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> | none

list-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.

Fontes