Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

`HTMLElement.style`: transformaciones y gestos táctiles

`style.transform` cambia la geometría visual de un elemento y `style.touchAction` determina qué gestos de desplazamiento y zoom puede gestionar el navegador. Ambas propiedades escriben declaraciones CSS en línea.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

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 designa dos propiedades distintas del objeto style de una instancia de HTMLElement; la barra no forma parte de la sintaxis de JavaScript. element.style expone un objeto CSSOM modificable que refleja en todo momento el atributo style. Asignar un valor a element.style.transform o a element.style.touchAction solo cambia la declaración correspondiente. Con getPropertyValue() y setProperty(), usa los nombres CSS transform y touch-action.

Al leer en element.style una propiedad admitida sin declaración en línea, obtienes la cadena vacía "", aunque una hoja de estilos le dé un valor. Para consultar el valor resuelto de un elemento en la página, usa getComputedStyle(element). Asignar "" o llamar a removeProperty() con el nombre CSS elimina la declaración en línea; no establece el valor CSS none.

transform acepta none o una lista de funciones separadas por espacios, como translateX(24px) rotate(10deg). El orden importa. Una transformación cambia el aspecto del elemento sin mover otros elementos en el flujo normal. En una caja CSS transformable, un valor de transform distinto de none crea un contexto de apilamiento y convierte al elemento en el bloque contenedor de sus descendientes con position: absolute o position: fixed. Un span normal no reemplazado con display: inline puede almacenar la declaración transform en línea, pero esta no crea en él un contexto de apilamiento ni un bloque contenedor.

touch-action no implementa el arrastre. Con auto, el navegador gestiona el desplazamiento y el zoom de la forma habitual. pan-y pinch-zoom permite el desplazamiento vertical con un dedo y el zoom mediante un gesto de pellizco, de modo que la aplicación puede implementar el arrastre horizontal. Al comenzar el gesto, el navegador solo admite los gestos que permiten tanto el elemento tocado como los ancestros pertinentes. Los cambios posteriores no afectan al gesto en curso. Si el navegador se encarga del desplazamiento o el zoom, maneja pointercancel para restablecer el estado del arrastre. Evita aplicar touch-action: none en zonas extensas: puede impedir el zoom que necesitan las personas con baja visión.

Estas API pertenecen a la plataforma web, no a ECMAScript 2024. La compatibilidad depende del navegador y del valor. CSS.supports("touch-action", "pan-y pinch-zoom") comprueba si se admite la declaración, pero no sustituye las pruebas de gestos en un dispositivo táctil.

Ejemplos

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

Resultado

["translateX(24px)","pan-y"]
["",""]

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola de desarrollo. Muestra cómo escribir y eliminar declaraciones en línea en un elemento que no se ha insertado en el documento; no prueba la representación visual ni los gestos.

Lecciones relacionadas

  • JavaScript · Lección 35 · Avanzado · Versión: 4

Fuentes