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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
force

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Requires a vendor prefix or different name for use.
Has more compatibility info.