JS властивість Event.ctrlKey (Mouse)

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

ctrlKey — це властивість об'єкта MouseEvent, яка повертає булеве значення, що вказує, чи була натиснута клавіша "Ctrl" під час події миші. Вона використовується для обробки подій, коли важливо знати, чи користувач тримав натиснутою клавішу "Ctrl", наприклад, для виконання спеціальних функцій або для додаткового керування.

Це особливо корисно для створення комбінацій миші та клавіатури, коли натискання клавіші "Ctrl" під час кліку змінює дію або додає іншу функціональність. Наприклад, багато додатків використовують комбінації, де "Ctrl" + "Click" виконує дію, відмінну від звичайного кліку. Властивість ctrlKey повертає true, якщо "Ctrl" була натиснута, і false в іншому випадку.

document.addEventListener('click', function(event) {
    if (event.ctrlKey) {
        console.log("Натиснута клавіша Ctrl під час кліку!");
    }
});

Залежно від ваших потреб, ctrlKey можна використовувати разом з іншими властивостями MouseEvent, такими як shiftKey, altKey або metaKey, щоб створити складні комбінації, котрі відповідають конкретним взаємодіям користувача. Це також допомагає уникнути конфліктів з інтерфейсами, де звичайний клік може мати одне призначення, а клік з "Ctrl" – інше. Зазвичай властивість ctrlKey використовується з подіями click, dblclick, mousedown та mouseup.

правити

Порада

Для запобігання конфліктам з інтерфейсом користувача або іншими комбінаціями, використовуйте event.preventDefault(), щоб скасувати дію за замовчуванням, якщо вона заважає обробці вашої комбінації.

автор: Bond правити

Порада

Якщо створюєте власні комбінації для обробки подій, враховуйте, що ctrlKey часто використовується в стандартних комбінаціях браузера (як, наприклад, "Ctrl + C" або "Ctrl + V"). Це може спричинити конфлікти, тому слід вибирати не зайняті комбінації.

автор: Bond правити

Порада

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

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

event.ctrlKey

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	1	1.5	1	12.1	12

Підтримка: мобільні переглядачі

Переглядач
	37	18	4	1

Підтримка: серверні переглядачі

Переглядач
	-	-

Приклади

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

<div id="indicator">Демонстраційний елемент</div>

document.addEventListener('mousemove', function(event) {
    if (event.ctrlKey) {
        let indicator = document.getElementById('indicator');
        indicator.style.left = event.clientX + 'px';
        indicator.style.top = event.clientY + 'px';
    }
});

document.addEventListener('mousedown', function(event) {
    if (event.ctrlKey && event.button === 2) { // Правий клік з Ctrl
        console.log("Спеціальне меню викликано правою кнопкою миші з Ctrl");
    }
});