Seznámení s JavaScript API 4.0

Noah Sager

<\/HEAD>Nyní, když byl ArcGIS API for JavaScript 4.0 uvolněn<\/A><\/STRONG> již několik týdnů, je to vynikající příležitost projít si některou z nové syntaxe a funkčnosti. Tento blog projde ukázkovou 3D aplikaci se zaměřením na widget Search. Můžete sledovat ukázkový kód z Esri Developer Support GitHub repozitáře<\/A><\/STRONG> a spustit hostovanou ukázku zde: Zobrazit živě<\/A><\/STRONG>.

Co se týče funkčnosti, aplikace zobrazuje 3D mapu se čtyřmi widgety: Search, Zoom, Compass a Attribution. Ve výchozím nastavení View obsahuje poslední tři widgety, jak je popsáno v dokumentaci<\/A><\/STRONG>. Pokud nejste obeznámeni se změnami ve verzi 4.x, všechny mapové aplikace obsahují mapu a view. Mapa drží data a view obsahuje vizualizační informace pro tato data. Jinými slovy, mapa je subjekt a view je kamera; kompletní s filtry, režimy a nastaveními. Všechny 2D aplikace budou mít MapViews a 3D aplikace budou mít SceneViews (poznámka: termín 'scene' označuje tři rozměry v rámci ArcGIS). Totéž platí pro mapy z ArcGIS Online a Portal for ArcGIS: WebMap je 2D a WebScene je 3D.

<\/A>

2D mapa + 3D scéna<\/P><\/DIV>

Do widgetu Search můžete zadat lokaci a buď vybrat výsledek z rozbalovacích návrhů, nebo stisknout Enter na klávesnici pro přechod na první místo v seznamu. View se přiblíží k této lokaci a umístí na mapu symbol obrázku značky. Pokud otevřete Developer Tools v webovém prohlížeči, uvidíte užitečné zprávy v konzoli indikující průběh widgetu Search.

V kódu je mnoho užitečných komentářů popisujících funkčnost s odkazy na reference pro nalezení více informací. Konstruktor Map a SceneView může být nový, ale jsou velmi přímočaré. Na co se zde chci zaměřit jsou dvě věci:

SearchViewModel<\/A><\/STRONG> (začínající na řádku 88) a view.ui<\/A><\/STRONG> (začínající na řádku 117).

Jednou z úžasných funkcí verze 4.0 je oddělení stylování a obchodní logiky. To znamená, že widgety mají view a ViewModel. View je samotný widget a stará se o zobrazení widgetu, zatímco ViewModel spravuje vlastnosti a konfigurace. Měl bych zmínit, že nemusíme používat ViewModel, pokud nechceme, protože vlastnosti ViewModel jsou také propojeny s view widgetu. Toto bylo provedeno pro jednoduchost. Jako příklad si prohlédněme widget Search v kódu:

<\/A>

Widget Search a SearchViewModel<\/P><\/DIV>

Skutečný konstruktor widgetu byl použit pro pojmenování widgetu a nastavení viditelnosti na true (výchozí hodnota je stejně true). SearchViewModel spravuje všechny konfigurace nastavené pro přizpůsobení uživatelského zážitku a rozhraní tak, jak jsem potřeboval (viz ukázka pro komentáře). Co je zajímavé na tomto systému ViewModel je to, že protože je oddělen od konstruktoru widgetu, je nyní mnohem snazší sdílet obchodní logiku mezi widgety a kódovými základy. Zde jsou další informace o

SearchViewModel<\/A><\/STRONG>.

Druhým zajímavým aspektem verze 4.0, o kterém zde budu hovořit, je způsob přidání widgetu Search do aplikace. Podívejme se na úryvek kódu z verze 4.0 a z verze 3.x. V současné době můžeme přidat widget přímo do uživatelského rozhraní view bez vytváření samostatného div elementu. Toto je efektivní (a troufám si říct elegantní) pracovní postup.

<\/>A

Přidat Search Widget verze 4.0<\/>P<\/>\/><\/>\/><\/>At the version 3.x musíme vytvořit div element, odkazovat na div při vytváření widgetu, a opět ho odkazovat uvnitř HTML tagu body.

Přidat Search Widget verze 3.x

Pro více informací o přidávání widgetů do view můžete odkázat tuto dokumentaci.

Shrnuto, ArcGIS API for JavaScript je výkonný produkt využívající sílu GIS přímo ve vašem webovém prohlížeči. Pokud jste pracovali s dřívějšími verzemi API, přečtení Přechod na verzi 4.x vám může pomoci začít. A pokud jste úplný nováček, můžete začít s Průvodcem Discover verze 4.x. Je toho ještě hodně co přijde, jak budeme pokračovat v přidávání funkčnosti a úžasnosti do JavaScript API verze 4.x. Přeji šťastné kódování!Noah S. - vedoucí připravenosti SDK