În acest articol, vom vorbi despre una dintre caracteristicile cele mai promițătoare ale API-ului Maps Rambler - conexiunea widget-uri personalizate.
Ce sunt widget-urile? Strict vorbind, acestea sunt module generate de JS pentru creșterea funcționalității API. În termeni figurativi, dacă API este fundamentul pentru lucrul cu hărți, widget-urile sunt o casă. Și cum va fi - depinde de tine. Prin scrierea propriului dvs. widget, puteți implementa ideile cele mai sălbatice în domeniul cartografiei.
În momentul de față, am dezvoltat deja patru widget-uri: "Traseu". „Principe“. "Blocaje de trafic" și "Camere foto". Pe exemplul lor, este destul de posibil să se înțeleagă ce sunt widget-urile API-ului "Rambler-Maps", de ce sunt necesare și cum funcționează. Apropo, ne puteți trimite propriile widget-uri și le vom posta pe site, astfel încât toată lumea să le poată folosi!
Deci, creați un widget. Tot ceea ce este necesar pentru funcționarea ei este trecut prin argumente în metoda RMap.registerWidget. Primul argument este numele widgetului (pentru referința ulterioară la acesta), al doilea este obiectul cu parametrii, care vor fi discutate în detaliu.
Apoi - parametrul de control. array de controale widget. În cazul nostru, acesta este un buton de comutare (SwitchButton). Printre proprietățile obiectului de control, este important să evidențiem funcțiile importante, constând în switchOn și switchOff, care sunt funcții care declanșează când butonul este pornit și oprit. E suficient să-ți dai numele, ne vom întoarce mai târziu.
Parametrul cursor vă permite să specificați ce cursoare să utilizați în anumite situații. De exemplu, pentru widget-ul nostru, un cursor încrucișat cruce va fi suficient pentru o poziționare precisă.
Următorul parametru opțional este eventTypes - tipuri de evenimente widget pe care le puteți utiliza, de exemplu, pentru a interacționa cu alte widget-uri.
Parametrul instrumente este o listă de biblioteci API care sunt utilizate în widget. Apropo, îmi amintesc că widget-urile pot și chiar ar trebui să utilizeze toate metodele API disponibile.
În cele din urmă, variabilele și funcțiile widget-ului.
Notă utilă - orice funcții publice ale widgetului, de exemplu, descrise mai sus turnOn sau turnOff. poate fi invocată în scriptul paginii, folosind o expresie ca map.widgets.Location.turnOn ().
Widget-ul a fost creat. Mai mult, codul generat poate fi plasat direct în corpul paginii, dar (!) Este mult mai convenabil să-l salvați într-un modul JS separat și să îl conectați împreună cu API-ul. Apoi, metoda getWidget este utilizată pentru a apela widget-ul. iar scriptul de pe pagină este redus la doar câteva linii.