Touch

可用性有限

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

Touch 介面表示觸控式螢幕裝置上的單個接觸點。接觸點通常是手指或觸控筆,裝置可以是觸控式螢幕或觸控板。

Touch.radiusXTouch.radiusYTouch.rotationAngle 描述了使用者與螢幕之間的接觸區域,即觸控區域。這在處理手指等不精確的輸入裝置時可能很有用。這些值用於描述一個最能匹配整個接觸區域(例如使用者指尖)的橢圓。

注意:許多屬性的值都依賴於硬體;例如,如果裝置無法檢測到施加在表面上的壓力大小,force 的值將始終為 0。radiusXradiusY 也可能出現這種情況;如果硬體只報告一個點,這些值將為 1。

建構函式

Touch()

建立一個 Touch 物件。

例項屬性

此介面沒有父介面,也不繼承或實現其他屬性。

基本屬性

Touch.identifier 只讀

返回此 Touch 物件的唯一識別符號。給定的觸控點(例如,由手指引起)在其在表面移動的整個過程中將具有相同的識別符號。這可以確保您始終跟蹤同一個觸控點。

Touch.screenX 只讀

返回觸控點相對於螢幕左邊緣的 X 座標。

Touch.screenY 只讀

返回觸控點相對於螢幕頂部的 Y 座標。

Touch.clientX 只讀

返回觸控點相對於瀏覽器視口左邊緣的 X 座標,不包括任何滾動偏移。

Touch.clientY 只讀

返回觸控點相對於瀏覽器視口頂部的 Y 座標,不包括任何滾動偏移。

Touch.pageX 只讀

返回觸控點相對於文件左邊緣的 X 座標。與 clientX 不同,此值包含水平滾動偏移(如果有)。

Touch.pageY 只讀

返回觸控點相對於文件頂部的 Y 座標。與 clientY 不同,此值包含垂直滾動偏移(如果有)。

Touch.target 只讀

返回觸控點最初放在表面上時開始的 Element,即使觸控點後來移出了該元素的互動區域,甚至從文件中移除也是如此。

觸控區域

Touch.radiusX 只讀

返回最能包圍與螢幕接觸區域的橢圓的 X 半徑。該值以與 screenX 相同的比例的畫素表示。

Touch.radiusY 只讀

返回最能包圍與螢幕接觸區域的橢圓的 Y 半徑。該值以與 screenY 相同的比例的畫素表示。

Touch.rotationAngle 只讀

返回由 radiusX 和 radiusY 描述的橢圓需要順時針旋轉的角度(以度為單位),以便最準確地覆蓋使用者與表面之間的接觸區域。

Touch.force 只讀

返回使用者施加在表面上的壓力大小,為一個介於 0.0(無壓力)和 1.0(最大壓力)之間的 float 值。

例項方法

此介面沒有方法,沒有父介面,也不繼承或實現任何方法。

規範

規範
觸控事件
# touch-interface

瀏覽器相容性

另見