Touch: force-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die schreibgeschützte Touch.force-Eigenschaft gibt den Druck zurück, den der Benutzer auf die Touch-Oberfläche für einen Touch-Punkt ausübt.

Wert

Ein float, der den Druck darstellt, den der Benutzer auf die Touch-Oberfläche ausübt. Dies ist ein Wert zwischen 0.0 (kein Druck) und 1.0 (der maximale Druck, den die Hardware erkennen kann). Ein Wert von 0.0 wird zurückgegeben, wenn kein Wert bekannt ist (zum Beispiel, wenn das Touch-Gerät diese Eigenschaft nicht unterstützt). In Umgebungen, in denen der Druck bekannt ist, können der absolute Druck, der durch das force-Attribut dargestellt wird, und die Empfindlichkeit in Druckstufen variieren.

Beispiele

Dieses Beispiel zeigt die Verwendung der Touch.force-Eigenschaft der Touch-Schnittstelle. Diese Eigenschaft ist ein relativer Druckwert im Bereich von 0.0 bis 1.0, wobei 0.0 keinen Druck bedeutet und 1.0 das höchste Druckniveau darstellt, das das Touch-Gerät erfassen kann.

Im folgenden Codebeispiel durchläuft der touchstart-Ereignishandler die Liste der targetTouches und protokolliert den force-Wert jedes Berührungspunktes, aber der Code könnte auch unterschiedliche Verarbeitung in Abhängigkeit vom Wert aufrufen.

js
someElement.addEventListener(
  "touchstart",
  (e) => {
    // Iterate through the list of touch points and log each touch
    // point's force.
    for (let i = 0; i < e.targetTouches.length; i++) {
      // Add code to "switch" based on the force value. For example
      // minimum pressure vs. maximum pressure could result in
      // different handling of the user's input.
      console.log(`targetTouches[${i}].force = ${e.targetTouches[i].force}`);
    }
  },
  false,
);

Spezifikationen

Specification
Touch Events
# dom-touch-force

Browser-Kompatibilität

BCD tables only load in the browser