KeyboardEvent.getModifierState()

Die Methode KeyboardEvent.getModifierState() gibt den aktuellen Zustand des angegebenen Modifikators zurück: true, wenn der Modifikator aktiv ist (d.h. die Modifikationstasten gedrückt oder gesperrt ist), ansonsten false.

Syntax

var active = event.getModifierState(keyArg);

Rückgabe 

Einen Boolean

Parameter

keyArg

Ein Modifikatorschlüsselwert. Der Wert muss einer der KeyboardEvent.key Werte sein, die Modifikatorschlüssel darstellen, oder die Zeichenkette "Accel" . Dabei wird zwischen Groß- und Kleinschreibung unterschieden.

Modifikationstasten im Internet Explorer

IE9 verwendet "Scroll" für "ScrollLock" und "Win" für "OS".

Modifikationstasten in Gecko

• Auf den anderen Plattformen werden Alt, Control und Shift unterstützt werden.
• Alle Modifikatoren (außer "FnLock", "Hyper", "Super" und "Symbol", die nach der Implementierung von Gecko definiert werden) stehen immer für nicht vertrauenswürdige Ereignisse auf Gecko zur Verfügung. Das hängt nicht von der Plattform ab.

"Accel" virtueller Modifikator

getModifierState() also accepts a deprecated virtual modifier named "Accel". event.getModifierState("Accel") returns true when at least one of KeyboardEvent.ctrlKey or KeyboardEvent.metaKey is true.

In old implementations and outdated specifications, it returned true when a modifier which is the typical modifier key for the shortcut key is pressed. For example, on Windows, pressing Ctrl key may make it return true. However, on Mac, pressing ⌘ Command key may make it return true. Note that which modifier key makes it return true depends on platforms, browsers, and user settings. For example, Firefox users can customize this with a pref, "ui.key.accelKey".

Beispiel

// Ignorieren, wenn folgender Modifikator aktiv ist.
if (event.getModifierState("Fn") ||
    event.getModifierState("Hyper") ||
    event.getModifierState("OS") ||
    event.getModifierState("Super") ||
    event.getModifierState("Win") /* hack for IE */) {
  return;
}

// auch ignorieren, wenn zwei oder mehr Modifikatoren außer Shift aktiv sind.
if (event.getModifierState("Control") +
    event.getModifierState("Alt") +
    event.getModifierState("Meta") > 1) {
  return;
}

// Tastaturkürzel mit Standardmodifikator
if (event.getModifierState("Accel")) {
  switch (event.key.toLowerCase()) {
    case "c":
      if (event.getModifierState("Shift")) {
        // Handle Accel + Shift + C
        event.preventDefault(); // consume the key event
      }
      break;
    case "k":
      if (!event.getModifierState("Shift")) {
        // Handle Accel + K
        event.preventDefault(); // consume the key event
      }
      break;
  }
  return;
}

// Mach etwas anderes für die Pfeiltasten, wenn ScrollLock gesperrt ist.
if ((event.getModifierState("ScrollLock") ||
       event.getModifierState("Scroll") /* hack for IE */) &&
    !event.getModifierState("Control") &&
    !event.getModifierState("Alt") &&
    !event.getModifierState("Meta")) {
  switch (event.key) {
    case "ArrowDown":
    case "Down": // Hack für IE und älteren Gecko
      event.preventDefault(); // Schlüsselereignis verwenden
      break;
    case "ArrowLeft":
    case "Left": // Hack für IE und älteren Gecko
      // Mach etwas anderes für die Pfeiltasten, wenn ScrollLock gesperrt ist.
      event.preventDefault(); // Schlüsselereignis verwenden
      break;
    case "ArrowRight":
    case "Right": // Hack für IE und älteren Gecko
      // Mach etwas anderes für die Pfeiltasten, wenn ScrollLock gesperrt ist.
      event.preventDefault(); // Schlüsselereignis verwenden
      break;
    case "ArrowUp":
    case "Up": // Hack für IE und älteren Gecko
      // Mach etwas anderes für die Pfeiltasten, wenn ScrollLock gesperrt ist.
      event.preventDefault(); // Schlüsselereignis verwenden
      break;
  }
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Das KeyboardEvent, zu dem die Methode gehört.
• MouseEvent.getModifierState