Zpracování událostí mapování

V tomto článku se dozvíte, jak používat třídu událostí mapování. Vlastnost zvýrazňuje události na mapě a na různých vrstvách mapy. Události můžete také zvýraznit při interakci se značkou HTML.

Interakce s mapou

Ukázka událostí mapy zvýrazní název událostí, které se spouští při interakci s mapou. Zdrojový kód pro tuto ukázku naleznete ve zdrojovém kódu mapových událostí.

A screenshot showing a map with a list of map events that are highlighted anytime your actions on the map trigger that event.

Interakce s vrstvami mapy

Ukázka událostí vrstvy zvýrazní název událostí, které se spouští při interakci s vrstvou symbolů. Symbol, bublina, čára a mnohoúhelníková vrstva podporují stejnou sadu událostí. Vrstvy heat mapy a dlaždic nepodporují žádnou z těchto událostí. Zdrojový kód pro tuto ukázku naleznete ve zdrojovém kódu události vrstvy.

A screenshot showing a map with a list of layer events that are highlighted anytime you interact with the Symbol Layer.

Interakce se značkou HTML

Ukázka událostí vrstvy značky HTML zvýrazní název událostí, které se spouští při interakci s vrstvou značky HTML. Zdrojový kód pro tuto ukázku naleznete ve zdrojovém kódu vrstvy html značky Events.

A screenshot showing a map with a list of HTML marker layer events that are highlighted anytime your actions on the map trigger that event.

Následující tabulka obsahuje seznam všech podporovaných událostí třídy mapování.

Událost Popis
boxzoomend Aktivuje se, když skončí interakce "lupa rámečku".
boxzoomstart Aktivuje se při zahájení interakce "lupa rámečku".
click Aktivuje se při stisknutí a uvolnění polohovacího zařízení ve stejném bodě na mapě.
close Aktivuje se, když se automaticky otevírané okno zavře ručně nebo programově.
contextmenu Aktivuje se při kliknutí pravým tlačítkem myši.
data Aktivuje se, když se načte nebo změní nějaká mapová data.
dataadded Aktivuje se při přidání obrazců do DataSource.
dataremoved Aktivuje se při odebrání obrazců z objektu DataSource.
datasourceupdated Aktivuje se při aktualizaci objektu DataSource .
dblclick Aktivuje se při kliknutí na bodovací zařízení dvakrát na stejném místě na mapě.
drag Aktivovalo se opakovaně během interakce s přetažením na mapě, místní nabídce nebo značce HTML.
dragend Aktivuje se, když na mapě, místní nabídce nebo značce HTML skončí interakce přetažením.
dragstart Aktivuje se, když se na mapě, místní nabídce nebo značce HTML spustí interakce přetahováním myší.
error Aktivuje se, když dojde k chybě.
idle

Aktivuje se po posledním vykresleném snímku před tím, než mapa přejde do stavu nečinnosti:

  • Neprobíhá žádný přechod kamery.
  • Všechny aktuálně požadované dlaždice se načetly.
  • Všechny animace prolnutí a přechodů byly dokončeny.

keydown Aktivuje se, když se stiskne klávesa.
keypress Aktivuje se, když se stiskne klávesa, která vytváří typovatelný znak (klávesu ANSI).
keyup Aktivuje se, když se uvolní klíč.
layeradded Aktivuje se při přidání vrstvy do mapy.
layerremoved Aktivuje se při odebrání vrstvy z mapy.
load Aktivovalo se okamžitě po stažení všech potřebných prostředků a první vizuálně kompletní vykreslování mapy se stalo.
mousedown Aktivuje se, když se v mapě stiskne bodovací zařízení nebo když je nad prvkem.
mouseenter Aktivuje se při počátečním přesunutí polohujícího zařízení přes mapu nebo prvek.
mouseleave Aktivuje se při přesunutí polohujícího zařízení z mapy nebo prvku.
mousemove Aktivuje se, když se v mapě nebo prvku přesune bodující zařízení.
mouseout Aktivuje se, když bodové zařízení opustí plátno mapy, zůstane prvek.
mouseover Aktivuje se při přesunutí polohujícího zařízení přes mapu nebo prvek.
mouseup Aktivuje se, když se v mapě uvolní bodovací zařízení nebo když je nad prvkem.
move Aktivovalo se opakovaně během animovaného přechodu z jednoho zobrazení do druhého v důsledku interakce uživatele nebo metod.
moveend Aktivuje se hned po dokončení přechodu z jednoho zobrazení do druhého v důsledku interakce uživatele nebo metod.
movestart Aktivuje se těsně před zahájením přechodu z jednoho zobrazení na druhé v důsledku interakce uživatele nebo metod.
open Aktivuje se, když se automaticky otevírané okno otevře ručně nebo programově.
pitch Aktivuje se při každé změně sklonu (naklonění) mapy v důsledku interakce uživatele nebo metod.
pitchend Aktivuje se okamžitě po dokončení změny sklonu (naklonění) mapy v důsledku interakce uživatele nebo metod.
pitchstart Aktivuje se při každém zahájení změny sklonu (naklonění) mapy v důsledku interakce uživatele nebo metod.
ready Aktivuje se, když se načtou minimální požadované prostředky mapování, než bude mapa připravená k programové interakci.
render

Aktivuje se při každém vykreslení mapy na obrazovku v důsledku:

  • Změna polohy, přiblížení, rozteče nebo ložiska mapy.
  • Změna stylu mapy
  • Změna DataSource zdroje.
  • Načtení vektorové dlaždice, souboru GeoJSON, glyfu nebo spritu.

resize Aktivuje se hned po změně velikosti mapy.
rotate Aktivovalo se opakovaně během interakce s přetažením, které chcete otočit.
rotateend Aktivuje se, když skončí interakce přetažením, která se má otočit.
rotatestart Aktivuje se při spuštění interakce "přetažením otočit".
shapechanged Aktivuje se při změně vlastnosti objektu obrazce.
sourcedata Aktivuje se, když se některý ze zdrojů mapy načte nebo změní, včetně toho, jestli se dlaždice patřící ke zdroji načte nebo změní.
sourceadded Aktivuje se při DataSource přidání nebo VectorTileSource přidání do mapy.
sourceremoved Aktivuje se při DataSource odebrání nebo VectorTileSource odebrání z mapy.
styledata Aktivuje se, když se načte nebo změní styl mapy.
styleimagemissing Aktivuje se, když se vrstva pokusí načíst obrázek z spritu image, která neexistuje.
tokenacquired Aktivuje se při získání přístupového tokenu Microsoft Entra.
touchcancel Aktivuje se, když touchcancel dojde k události v mapě.
touchend Aktivuje se, když touchend dojde k události v mapě.
touchmove Aktivuje se, když touchmove dojde k události v mapě.
touchstart Aktivuje se, když touchstart dojde k události v mapě.
wheel Aktivuje se, když v mapě dojde k události kolečka myši.
zoom Aktivovalo se opakovaně během animovaného přechodu z jedné úrovně přiblížení na jinou v důsledku interakce uživatele nebo metod.
zoomend Aktivuje se hned po dokončení přechodu z jedné úrovně přiblížení na druhou v důsledku interakce uživatele nebo metod.
zoomstart Aktivuje se těsně před zahájením přechodu z jedné úrovně přiblížení na jinou v důsledku interakce uživatele nebo metod.

Další kroky

Úplné příklady kódu najdete v následujících článcích: