CKTIS / JavaScript
`HTMLElement.style`: trasformazioni e gesti tattili
`style.transform` modifica la geometria visiva dell’elemento, mentre `style.touchAction` determina quali gesti di scorrimento e zoom può gestire il browser. Entrambe impostano dichiarazioni CSS in linea.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
element.style.transform = "translateX(24px) rotate(10deg)";
element.style.touchAction = "pan-y";
element.style.getPropertyValue("touch-action");
element.style.setProperty("touch-action", "pan-y");
element.style.transform = "";
element.style.removeProperty("touch-action");
getComputedStyle(element).transform;
getComputedStyle(element).touchAction;HTMLElement.style.transform/touchAction indica due proprietà distinte dell’oggetto style di un’istanza di HTMLElement; la barra non fa parte della sintassi JavaScript. element.style espone un oggetto CSSOM modificabile che riflette in tempo reale l’attributo style. Assegnare un valore a element.style.transform o a element.style.touchAction modifica soltanto la dichiarazione corrispondente. Con getPropertyValue() e setProperty() usa i nomi CSS transform e touch-action.
Per una proprietà supportata senza dichiarazione in linea, element.style restituisce la stringa vuota "", anche se un foglio di stile assegna un valore. Per leggere il valore risolto di un elemento nella pagina, usa getComputedStyle(element). Assegnare "" o chiamare removeProperty() passando il nome CSS rimuove la dichiarazione in linea, senza impostare il valore CSS none.
transform accetta none o un elenco di funzioni separate da spazi, come translateX(24px) rotate(10deg). L’ordine conta. Una trasformazione cambia l’aspetto dell’elemento senza spostare gli altri elementi nel flusso normale. Per un box CSS trasformabile, un valore di transform diverso da none crea un contesto di impilamento e fa dell’elemento il blocco contenitore dei discendenti con position: absolute o position: fixed. Un normale span non sostituito con display: inline può conservare la dichiarazione transform in linea, ma questa non crea né un contesto di impilamento né un blocco contenitore su quell’elemento.
touch-action non implementa il trascinamento. Con auto il browser gestisce normalmente scorrimento e zoom. pan-y pinch-zoom consente lo scorrimento verticale con un dito e lo zoom tramite il gesto di pizzicamento; l’applicazione può quindi implementare il trascinamento orizzontale. All’inizio del gesto, il browser ammette soltanto i gesti consentiti sia dall’elemento toccato sia dagli antenati pertinenti. Le modifiche successive non influiscono sul gesto in corso. Se il browser prende in carico lo scorrimento o lo zoom, gestisci pointercancel per azzerare lo stato del trascinamento. Evita di applicare touch-action: none ad aree estese: può impedire lo zoom necessario alle persone ipovedenti.
Queste API appartengono alla piattaforma web, non a ECMAScript 2024. Il supporto dipende dal browser e dal valore. CSS.supports("touch-action", "pan-y pinch-zoom") verifica se la dichiarazione è supportata, ma non sostituisce le prove dei gesti su un dispositivo tattile.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>Inline transform and touch-action</title>
<script>
if (typeof CSS === "undefined" || typeof CSS.supports !== "function") {
console.log("CSS.supports() is not available.");
} else if (CSS.supports("transform", "translateX(24px)") && CSS.supports("touch-action", "pan-y")) {
const element = document.createElement("div");
const style = element.style;
style.transform = "translateX(24px)";
style.touchAction = "pan-y";
console.log(JSON.stringify([style.transform, style.getPropertyValue("touch-action")]));
style.transform = "";
style.removeProperty("touch-action");
console.log(JSON.stringify([style.transform, style.touchAction]));
} else {
console.log("Required CSS values are not supported.");
}
</script>Risultato
["translateX(24px)","pan-y"] ["",""]
Salva l’esempio come file HTML, aprilo in un browser e controlla la console per sviluppatori. Mostra come impostare e rimuovere dichiarazioni in linea su un elemento non inserito nel documento; non verifica la resa visiva né i gesti.
Lezioni correlate
- JavaScript · Lezione 35 · Avanzato · Versione: 4