Touch: pageX-Eigenschaft

Limited availability

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

Die schreibgeschützte Eigenschaft Touch.pageX gibt die X-Koordinate des Berührungspunkts relativ zum Ansichtsfenster, einschließlich etwaiger Bildlauf-Verschiebung, zurück.

Wert

Ein double Gleitkommawert, der die X-Koordinate des Berührungspunkts relativ zum Ansichtsfenster, einschließlich etwaiger Bildlauf-Verschiebung, darstellt.

Beispiele

Dieses Beispiel veranschaulicht, wie auf die Eigenschaften Touch.pageX des Touch-Objekts und Touch.pageY zugegriffen wird. Die Eigenschaft Touch.pageX ist die horizontale Koordinate eines Berührungspunkts relativ zum Ansichtsfenster (in CSS-Pixel), einschließlich etwaiger Bildlauf-Verschiebung. Die Eigenschaft Touch.pageY ist die vertikale Koordinate eines Berührungspunkts relativ zum Ansichtsfenster (in CSS-Pixel), einschließlich etwaiger Bildlauf-Verschiebung.

Im folgenden einfachen Code-Snippet nehmen wir an, dass der Benutzer einen oder mehrere Berührungskontakte auf dem source-Element initiiert, die Berührungspunkte bewegt und dann alle Kontakte mit der Oberfläche beendet. Wenn der touchmove-Ereignishandler aufgerufen wird, werden die Touch.pageX- und Touch.pageY-Koordinaten jedes Berührungspunkts über die TouchEvent.changedTouches-Liste aufgerufen.

js
// Register a touchmove listeners for the 'source' element
const src = document.getElementById("source");

src.addEventListener(
  "touchmove",
  (e) => {
    // Iterate through the touch points that have moved and log each
    // of the pageX/Y coordinates. The unit of each coordinate is CSS pixels.
    for (let i = 0; i < e.changedTouches.length; i++) {
      console.log(`touchpoint[${i}].pageX = ${e.changedTouches[i].pageX}`);
      console.log(`touchpoint[${i}].pageY = ${e.changedTouches[i].pageY}`);
    }
  },
  false,
);

Spezifikationen

Specification
Touch Events
# dom-touch-pagex

Browser-Kompatibilität

BCD tables only load in the browser