JS властивість Event.deltaMode


Загальний опис

deltaMode – це властивість об'єкта WheelEvent, яка визначає одиницю вимірювання для значень deltaX, deltaY та deltaZ. Властивість deltaMode може мати три можливі значення: 0 (DOM_DELTA_PIXEL), 1 (DOM_DELTA_LINE) або 2 (DOM_DELTA_PAGE). Ці значення відповідають тому, як інтерпретувати одиниці вимірювання для змінних deltaX, deltaY та deltaZ під час прокручування.

Якщо deltaMode дорівнює 0, значення вимірюються у пікселях, що найчастіше використовується для точного контролю над прокручуванням на екрані. Значення 1 означає, що одиницею є рядок, що дозволяє легко реалізувати прокручування, наприклад, у текстових полях або списках. Якщо deltaMode дорівнює 2, зміщення відбувається на рівні сторінки, що може бути корисним для великих областей прокручування, таких як цілі сторінки.

Приклад використання deltaMode для визначення, в яких одиницях вимірюється прокрутка:

document.addEventListener('wheel', function(event) {
  switch(event.deltaMode) {
    case 0:
      console.log('Прокрутка вимірюється в пікселях');
      break;
    case 1:
      console.log('Прокрутка вимірюється в рядках');
      break;
    case 2:
      console.log('Прокрутка вимірюється в сторінках');
      break;
  }
});

Цей приклад допомагає визначити одиницю вимірювання під час прокручування, що дозволяє адаптувати поведінку додатку в залежності від типу пристрою або налаштувань прокручування. Наприклад, для мишей прокручування, як правило, відбувається у пікселях, а для клавіатурних подій – у рядках або сторінках. deltaMode також є корисною властивістю для розробників, які працюють з кросплатформенними застосунками або адаптують веб-контент для різних пристроїв.

автор: Bond

Порада

При deltaMode = 2, будьте обережні, оскільки прокручування на цілу сторінку може бути надто грубим для дрібніших інтерфейсів. Це налаштування добре підходить для додатків, де потрібне швидке переміщення між великими розділами або сторінками.

автор: Bond
Порада

Якщо deltaMode варіюється в межах одного додатку, можна додати обробник, який буде коригувати швидкість прокручування на основі значення цієї властивості. Це дозволить створити однаковий досвід для користувача, незалежно від одиниці вимірювання.

автор: Bond
Порада

Для тестування різних значень deltaMode, спробуйте використати віртуальні пристрої або інструменти емуляції, які дозволяють задавати нестандартні налаштування прокручування. Це дасть можливість побачити, як ваш додаток поводиться при різних типах прокручування.

автор: Bond

Синтаксис

wheelEvent.deltaMode

Переглядачі

Підтримка: стаціонарні переглядачі
Переглядач Google Chrome Mozilla Firefox Apple Safari Opera Microsoft EDGE Microsoft Internet Explorer
26 17 7 15 12 9
Підтримка: мобільні переглядачі
Переглядач Mobile Google Android Mobile Google Chrome Mobile Mozilla Firefox Mobile Apple Safari
4.4 26 17 7

Приклади

+ запропонувати свій приклад у пісочниці

Цей приклад створює прокручувану область, у якій користувач може бачити поточний режим deltaMode та значення deltaX, deltaY, і deltaZ під час скролінгу. deltaMode дозволяє адаптуватися до різних налаштувань пристрою введення, що корисно для точної обробки скролінгу у користувацьких інтерфейсах.

HTML

<header>
  <h2 class="title">wheelEvent - deltaMode</h2>
  <p class="description">Визначає одиницю виміру для змін при скролінгу колеса миші.</p>
</header>
<main>
  <div class="result">
    <div class="scrollable" id="scrollable-area">
      <p>Прокручуйте тут, щоб побачити значення deltaMode та відстань скролінгу.</p>
      
      <p>Lorem ipsum dolor, sit amet consectetur adipisicing elit. Magnam consequatur ut numquam tempore sequi expedita nemo quam tenetur! Dolorem, provident ipsam! Repellat sequi quis commodi temporibus obcaecati, sed possimus! Rerum.
      Rem, optio provident. Asperiores at quas libero nesciunt voluptatibus voluptate. Itaque ullam voluptas nostrum architecto voluptatibus in, excepturi, sapiente amet, non fuga iusto vero cupiditate eveniet obcaecati quidem saepe provident.
      Nam sequi atque labore, adipisci, animi ullam numquam doloremque impedit obcaecati explicabo accusamus est, ut cupiditate expedita aspernatur nostrum non perferendis quo quasi odit quod dicta porro nihil. Assumenda, saepe.
      Aliquid quod exercitationem deserunt, unde numquam excepturi quidem quaerat vel tempore beatae deleniti perspiciatis ducimus repellat modi. Saepe quos nam consectetur. Laudantium fugiat provident ipsum velit quasi molestias porro ratione!
      Ullam doloribus facere minima sit velit, minus nemo, similique, voluptate quia aliquam quaerat! Maiores quas neque laboriosam expedita, at est! In illum quas culpa distinctio non est ullam possimus facilis?
      Sint, recusandae reiciendis. Non in, saepe facilis sequi accusantium, iste animi velit esse dolores iusto obcaecati enim voluptatum illum odio, at quod sunt officiis vitae. Natus fuga dolor mollitia nulla?
      Ex at vero exercitationem molestias ipsa reprehenderit saepe fuga maxime! Ullam doloribus totam esse aspernatur? Nam libero accusamus, commodi omnis vel ex laborum? Quae veritatis asperiores officiis qui aut similique?
      Deleniti dicta nisi, consequuntur ullam corporis cum ut et itaque quam dolore consequatur ipsum? Voluptatum modi in odio, vero explicabo consequuntur obcaecati animi consequatur consectetur, nulla distinctio molestias perspiciatis repudiandae.
      Aut harum nobis repellendus dolorum quae incidunt doloremque quidem. Iste ipsum at, unde quia vero rem atque dolorem sunt adipisci molestias sapiente. Soluta id maiores sint impedit quia tenetur vel.
      Maiores rerum autem, itaque iste magni excepturi laborum provident cupiditate neque saepe at corporis necessitatibus fugit in dolor ullam ducimus explicabo et unde, reiciendis veritatis magnam voluptate eaque. Cum, nemo!
      Qui illum illo perferendis sapiente sint ipsum quidem laboriosam excepturi aliquam, hic, dignissimos rerum natus atque similique velit. Doloremque nostrum voluptatum facere odit quia alias excepturi eos quisquam qui dolor.
      Nostrum cupiditate, ea sequi iusto saepe quo, suscipit porro esse aspernatur quibusdam soluta aliquid quia fugit odit cumque, blanditiis magni expedita eveniet! Officia rem, praesentium tempore odit alias consequatur quidem.
      Quibusdam velit odio quidem consequatur deleniti magni excepturi repellat expedita. Ipsa eius quasi nemo dolorem consectetur corporis labore enim, porro dicta fugit eum fugiat sunt. Ea libero debitis quibusdam temporibus?
      Expedita ratione eius, autem quia ipsum animi culpa possimus amet? Beatae laborum velit sapiente ut alias rem accusantium qui quam optio quas dolores error iusto, voluptatum cupiditate ducimus expedita ad!
      Quod natus deserunt velit ducimus laudantium sapiente quibusdam aut molestiae sed, officiis sint tempora voluptate nisi minus aliquam impedit illo nesciunt odio maiores, neque dolorum! Voluptate voluptates doloribus ipsam labore?
      Enim nesciunt, minus explicabo earum dolor doloribus mollitia similique recusandae quibusdam beatae hic animi accusamus ut reiciendis non molestias, nostrum minima aut. Aliquam hic temporibus dolores quam eaque debitis sapiente!
      Officiis dignissimos laboriosam unde esse odit. Sunt, incidunt velit non ex deserunt iusto labore praesentium fuga voluptates ut eius reiciendis ullam consequuntur tempore unde, dignissimos iste reprehenderit ab? Laboriosam, neque?
      Temporibus est in expedita quo maxime autem magni modi illo, et deleniti corrupti. Odit veritatis repellendus facilis illo nostrum sapiente, cum ut doloribus iste soluta atque, tenetur vitae! Nam, ipsam?
      Maxime vitae culpa nostrum libero animi error veritatis aspernatur aliquam, nihil sunt recusandae sequi, dolore amet exercitationem. Inventore corrupti beatae repudiandae? Suscipit optio fuga soluta, esse eum ea perferendis obcaecati.
      Incidunt libero deleniti nemo iste accusantium quam labore laudantium magni. Error expedita voluptatibus consectetur enim fugit quaerat debitis ipsum necessitatibus suscipit, repellat delectus labore nesciunt neque natus illum ex impedit?</p>
    </div>
    <p id="output"></p>
  </div>
</main>

CSS

body {
  font-size: 16px;
  line-height: 1.5;
  font-family: monospace;
}

header {
  background-color: #f1f1f1;
  margin-bottom: 25px;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

header h2.title {
  padding-bottom: 15px;
  border-bottom: 1px solid #999;
}

header p.description {
  font-style: italic;
  color: #222;
}

.result {
  background-color: #f8f8f8;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

.scrollable {
  height: 150px;
  overflow-y: auto;
  border: 2px solid #ccc;
  padding: 10px;
  margin-top: 15px;
}

JS

const scrollableArea = document.getElementById('scrollable-area');
const output = document.getElementById('output');

scrollableArea.addEventListener('wheel', event => {

  // Визначаємо тип deltaMode
  let mode;
  switch (event.deltaMode) {
    case 0:
      mode = 'Пікселі';
      break;
    case 1:
      mode = 'Рядки';
      break;
    case 2:
      mode = 'Сторінки';
      break;
    default:
      mode = 'Невідомий';}


  // Виводимо інформацію про deltaMode і значення скролінгу
  output.innerHTML = `
    <p>Режим: ${mode}</p>
    <p>deltaX: ${event.deltaX}</p>
    <p>deltaY: ${event.deltaY}</p>
    <p>deltaZ: ${event.deltaZ}</p>
  `;
});
//# sourceURL=pen.js
автор: Bond

Цей приклад використовує deltaMode для визначення типу прокрутки і змінює поведінку залежно від режиму. Це дозволяє створити адаптивний інтерфейс, який відповідає на різні типи прокручування, такі як прокручування мишею, клавіатурою або іншими пристроями.

document.addEventListener('wheel', function(event) {
  if (event.deltaMode === 0) {
    console.log('Прокручуємо елемент плавно по пікселях');
    // Виконати плавну прокрутку
  } else if (event.deltaMode === 1) {
    console.log('Прокручуємо на кілька рядків');
    // Прокрутка з проміжками між рядками
  } else if (event.deltaMode === 2) {
    console.log('Прокручуємо цілу сторінку');
    // Прокрутка на цілу сторінку
  }
});
автор: Bond

У цьому прикладі значення deltaY нормалізується відповідно до deltaMode, щоб адаптувати прокручування в пікселях для різних типів пристроїв і одиниць вимірювання. Це допомагає зробити прокручування більш уніфікованим.

document.addEventListener('wheel', function(event) {
  let normalizedDelta;
  if (event.deltaMode === 1) {
    normalizedDelta = event.deltaY * 40; // множимо на 40 для адаптації під пікселі
  } else if (event.deltaMode === 2) {
    normalizedDelta = event.deltaY * 800; // множимо на 800 для сторінкової прокрутки
  } else {
    normalizedDelta = event.deltaY; // значення в пікселях
  }
  console.log('Нормалізоване значення прокручування:', normalizedDelta);
});
автор: Bond

Коментарі

Коментарів ще немає — будьте першим!

Відповідь для

Як форматувати текст?
Пишемо Виходить
**важливо**
*акцент*
~~застаріле~~
Виділення в тексті. Те саме роблять кнопки панелі, що спливає над виділеним.
## Як працює каскад
### Порядок оголошень
Заголовки всередині тексту. Найбільший не потрібен — він у сторінки вже є.
[[css/property/color]] Посилання на сторінку довідника. Наберіть [[ — поле веде сходинками (розділ → тип → сторінка), а хибний ключ підкреслить хвилею.
[[!sandbox/S0oh1hBm]] Живий приклад окремим рядком — саме вікно результату. Той самий ключ зі знаком !: наберіть [[! і дійдіть сходинками до потрібної сторінки, список покаже її приклади.
[MDN](https://developer.mozilla.org) Посилання на чужий сайт.
![Схема каскаду](https://site.com/схема.png) Картинка. Опис обов'язковий: його читають пошуковик і незрячі.
Задайте `display: grid` контейнеру Код усередині речення.
```css
.card { display: grid }
```
Код блоком. Мова після трьох лапок вмикає підсвітку.
- Походження
1. Походження
Перелік: маркований і нумерований.
- [ ] дописати приклади
- [x] перевірити в Firefox
Перелік завдань із галочками. Пробіл у порожніх дужках обов'язковий.
> Порядок важить лише за рівної ваги. Цитата на всю ширину абзацу.
Специфічність
: вага селектора; більша перемагає
Список означень: термін, а під ним пояснення з відступом. Пробіл після двокрапки обов'язковий.
Каскад має три критерії[^1]
[^1]: Походження, специфічність, порядок.
Виноска: номер у тексті, примітка внизу сторінки. Без згадки [^1] у тексті примітка не з'явиться.
Відповідь: ||сорок два|| Ховає те, що між рисками: читач бачить на цьому місці розмиту пляму, а решта речення лишається звичайною. Клац — і текст відкрито.
|| Показати рішення
Задайте контейнеру `display: grid`.
||
Ховає цілі абзаци. На сторінці видно лише підпис із першого рядка («Показати рішення»), решта розгортається клацанням по ньому. Закривні риски — окремим рядком.
Порожній рядок Новий абзац. Щоб перенести рядок усередині абзацу, поставте \ в його кінці.

Увійдіть — коментар з'явиться одразу, без капчі й очікування перевірки.

Правка
Зворотний зв'язок
Вхід