Touch: force 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

Touch.force 只讀屬性返回使用者在 Touch 點上對觸控表面施加的壓力大小。

一個 float 值,表示使用者對觸控表面施加的壓力大小。該值介於 0.0(無壓力)和 1.0(硬體能識別的最大壓力)之間。如果不知道該值(例如觸控裝置不支援此屬性),則返回 0.0。在已知壓力的環境中,force 屬性所代表的絕對壓力以及壓力級別的靈敏度可能會有所不同。

示例

此示例演示瞭如何使用 Touch 介面的 Touch.force 屬性。此屬性是施加壓力的相對值,範圍在 0.01.0 之間,其中 0.0 表示無壓力,1.0 表示觸控裝置能夠感應到的最高壓力級別。

在以下程式碼片段中,touchstart 事件處理程式會遍歷 targetTouches 列表並記錄每個觸控點的 force 值,但程式碼可以根據該值呼叫不同的處理方式。

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

規範

規範
觸控事件
# dom-touch-force

瀏覽器相容性