База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

`HTMLElement.style`: трансформации и жестове с докосване

`style.transform` променя видимата геометрия на елемента, а `style.touchAction` определя кои жестове за превъртане и мащабиране може да обработва браузърът. И двете свойства записват CSS декларации директно в елемента.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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 означава две отделни свойства на обекта style на екземпляр на HTMLElement; наклонената черта не е част от синтаксиса на JavaScript. element.style предоставя изменяем CSSOM обект, който отразява текущото съдържание на атрибута style. Присвояването на стойност на element.style.transform или element.style.touchAction променя само съответната декларация. При getPropertyValue() и setProperty() използвай имената в CSS: transform и touch-action.

За поддържано свойство без декларация директно в елемента element.style връща празния низ "", дори таблица със стилове да задава стойност. За да прочетеш стойността, определена от браузъра за елемент в страницата, използвай getComputedStyle(element). Присвояването на "" или извикването на removeProperty() с името в CSS премахва декларацията от елемента, без да задава стойността none.

transform приема none или списък от функции, разделени с интервали, например translateX(24px) rotate(10deg). Редът е важен. Трансформацията променя изгледа на елемента, без да мести други елементи в нормалния поток на документа. При CSS кутия, която може да се трансформира, стойност на transform, различна от none, създава контекст на подреждане по слоеве и превръща елемента в съдържащ блок за потомците с position: absolute или position: fixed. Обикновен незаменен елемент span с display: inline може да съхрани декларацията transform в атрибута style, но тя не създава нито контекст на подреждане по слоеве, нито съдържащ блок за този елемент.

touch-action не реализира влачене. При auto браузърът обработва превъртането и мащабирането както обикновено. pan-y pinch-zoom позволява вертикално превъртане с един пръст и мащабиране чрез събиране или раздалечаване на два пръста; приложението може само да реализира хоризонтално влачене. В началото на жеста браузърът допуска само жестовете, разрешени едновременно от докоснатия елемент и съответните му предшественици. По-късни промени не влияят на текущия жест. Ако браузърът поеме превъртането или мащабирането, обработи pointercancel, за да изчистиш състоянието на влачене. Избягвай touch-action: none върху големи области: това може да блокира мащабирането, от което се нуждаят хората с отслабено зрение.

Това са интерфейси на уеб платформата, а не възможности на ECMAScript 2024. Поддръжката зависи от браузъра и стойността. CSS.supports("touch-action", "pan-y pinch-zoom") проверява поддръжката на декларацията, но не замества изпитването на жестовете на устройство със сензорен екран.

Примери

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

Резултат

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

Запази примера като HTML файл, отвори го в браузър и провери конзолата за разработчици. Кодът показва записване и премахване на декларации върху елемент, който не е добавен към документа; не проверява визуализацията или жестовете.

Свързани уроци

  • JavaScript · Урок 35 · Напреднало · Версия: 4

Източници