Touch: force-Eigenschaft

Wert

Ein float, der die Menge Druck darstellt, die der Benutzer auf die Berührungsoberflä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 die Druckkraft bekannt ist, kann der absolute Druck, der durch das force-Attribut repräsentiert wird, sowie die Empfindlichkeit in Druckstufen variieren.

Beispiele

Dieses Beispiel zeigt die Verwendung der Touch.force-Eigenschaft des Touch-Interfaces. Diese Eigenschaft ist ein relativer Druckwert im Bereich von 0.0 bis 1.0, wobei 0.0 keinen Druck und 1.0 den höchsten Druckwert darstellt, den das Touch-Gerät erkennen kann.

Im folgenden Code-Ausschnitt durchläuft der touchstart-Ereignishandler die Liste targetTouches und protokolliert den force-Wert jedes Berührungspunktes, aber der Code könnte unterschiedliche Prozessen ausführen, abhängig vom Wert.

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}`);
  }
});

Spezifikationen

Browser-Kompatibilität