CKTIS / JavaScript
HTMLElement.style.scrollBehavior — impostare lo scorrimento fluido
Leggi, imposta o rimuovi la dichiarazione CSS in linea `scroll-behavior` di un elemento e distinguila dal valore CSS risolto e dall’opzione di una singola chiamata di scorrimento.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
element.style.scrollBehavior;
element.style.scrollBehavior = "smooth";
element.style.scrollBehavior = "auto";
element.style.scrollBehavior = "";HTMLElement.style.scrollBehavior è una proprietà del CSSOM sull’oggetto style di un’istanza di un elemento HTML. Non è una proprietà statica del costruttore HTMLElement e non fa parte di ECMAScript. Usa element.style.scrollBehavior per leggere o modificare la dichiarazione CSS in linea di scroll-behavior.
Se manca una dichiarazione in linea, la lettura restituisce "", anche se un foglio di stile imposta la proprietà. Assegnare "" rimuove solo quella dichiarazione; assegnare "auto" la imposta esplicitamente. Su un elemento collegato al documento, usa getComputedStyle(element).scrollBehavior per leggere il valore risolto dopo l’applicazione della cascata.
Impostare questa proprietà non avvia lo scorrimento. Determina come scorre un contenitore quando lo scorrimento è attivato dalla navigazione, ad esempio da un link a un frammento della pagina, o da un’API di scorrimento del CSSOM. Non modifica lo scorrimento diretto con rotellina o gesto. In CSS, auto è il valore iniziale e indica uno scorrimento immediato; smooth richiede un’animazione di cui il browser decide la durata e la curva di accelerazione. La proprietà non viene ereditata per impostazione predefinita e il browser può ignorarla.
Per configurare lo scorrimento dell’area visibile di una pagina HTML, usa l’elemento radice (document.documentElement); una dichiarazione su document.body non si propaga a quell’area. In element.scrollTo({ top: 100, behavior: "auto" }), "auto" segue il CSS; "smooth" e "instant" scelgono il comportamento solo per quella chiamata. "instant" non è un valore CSS valido per scroll-behavior. Evita di forzare lo scorrimento fluido quando è soddisfatta la condizione prefers-reduced-motion: reduce.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Inline scroll behavior</title>
</head>
<body>
<script>
const element = document.createElement("div");
console.log(JSON.stringify(element.style.scrollBehavior));
element.style.scrollBehavior = "smooth";
console.log(JSON.stringify(element.style.getPropertyValue("scroll-behavior")));
element.style.scrollBehavior = "";
console.log(JSON.stringify(element.style.scrollBehavior));
</script>
</body>
</html>Risultato
"" "smooth" ""
L’esempio usa un elemento non collegato al documento per leggere, impostare e rimuovere la dichiarazione senza far scorrere la pagina. `JSON.stringify()` rende visibile la stringa vuota come `""`.
Lezioni correlate
- JavaScript · Lezione 37 · Avanzato · Versione: 4