jquery használata modulban

Well, én hoztalak úgymond ebbe az utcába, és továbbra is véleményem, amit már elmondtam a témanyitóban linkelt topicban, de ez itt olyan alapvető téma, amit nagyon sokan sokkal jobban ismernek nálam. Én nem vagyok jártas a modulfejlesztésben. Emiatt a kérdéseidet sem igazán értem; igazából a közelében sem voltam hasonló feladatnak, más talán volt:

Akkor a kérdés:
Hogyan kellene szabályosan használni jquery-t modulban? A jquery core-t hogyan kellene include-olni, hogy ne legyen ütközés?

Remélem akad modulfejlesztésben járatos kolléga, aki abból az irányból tudja megfogalmazni az állásfoglalását, amelyikből neked az kell.

Először is tisztázzuk azt, hogy mi az a jQuery és hogy működik. Aztán megnézzük, mit lehet vele tenni.

Melléklet: http://www.codeproject.com/Articles/426013/How-jQuery-works

Mi a jQuery

1. A böngészők a mezei hardcore javascriptet értik meg.
2. Pár embernek feltűnt, hogy mezei hardcore javascriptet kódolni nem könnyű/nem elég erőfeszítés-hatékony (nem elég lean).
3. Kifejlesztettek egy kódolást egyszerűsítő réteget.
   • A neve jQuery lett.
   • Telepakolták hasznos dolgokkal, hogy a leggyakrabban előforduló feladatokat meg lehessen vele csinálni, méghozzá itt a lényeg: könnyen és gyorsan.
4. A jQuery a kódban újfajta "dialektust" tesz lehetővé. Könnyebb, egyszerűbben áttekinthető dolgokat tudsz beleírni, és azt is működőképessé teszi.
5. (A javascript parszer önmagától nem ismerné fel a jQuery-vel behozott új információkat, ahoz fog kelleni neki segítség.)

Ez a jQuery: egy mediátor réteg a böngészők javascript parszere és a kódíró emberek között, és elsősorban az emberek kedvéért készült, hogy könnyebb/jobb legyen a munkájuk. (DX, Developer eXperience?)

Hogyan valósul meg?

1. A natúr javascriptnek vannak saját funkciói, és a jQuery további funkciókat definiál. Vegyesen használhatod őket a kódodban.
2. Amikor jQuery-t írsz, akkor teljesen javascript syntax szerint dolgozol, csak olyan funkciókat használsz benne, amik a böngésző számára amúgy kínaiak lennének.
3. Ezért kell egy "tolmács" réteg, aki elmagyarázza a javascript parszernek, hogy amikor te a jQuery funkcióidat beírtad, akkor mit akartál.
4. Ez a "tolmács" a jQuery library; ezt először be kell linkelni az olyan oldalakon, ahol jQuery funkciókkal spékelt scriptet akarsz futtatni.

A jQuery library egy objektumot hoz létre a böngésző "ős objektumán", a window objecten. (Definiál egy window.jQuery-t (amit window.$-ként is el lehet érni).)

Ezen az objektumon belül vannak definiálva a jQuery funkciók. Ha van window.jQuery (emlékeztetőül: benne csücsül a sok definiált jQuery funkció), akkor van mi feldolgozza a jquery funkciókat, van tolmács.

Mit csinálnak a jQuery Pluginek?

A jQuery pluginek feltételezik, hogy van már egy window.jQuery object, és az abban lévő funkció-listát még további funkciókkal bővítik ki.

A sima jQuery libraryt belinkeled először, ez lefut, és létrehozza a default kompetencia-készletet (window.jQuery object), az utána következőnek belinkelt jquery pluginek pedig, mikor lefutnak akkor megtalálják ezt a window.jQuery objectet, és tovább bővítik, mintegy további funkciókra is megtanítják.

Az egésznek window.jQuery a neve, és ezen a néven fogja keresni aztán az oldal összes jQuery-használó összetevője.

Hol tud ez elromlani nálad?

Ott, hogy ha nem megfelelően linkelsz be jQuery librarykat.

Te a moduljaidból drupal_add_js-el meg az .info file-okból is próbáltad definiálni a jQuery library-t, ha jól értettem; ez a következőt eredményezte:

1. A Drupal valahol a folyamat legelején hozzáadott egy jQuery libet (7-es drupal jquery_update modul hiányában a 1.4.4-es verziót, de ez most még irreleváns), mert az default viselkedés tőle.
2. Aztán a core további összetevői meghívogattak további jQuery plugineket, pl. a core által használt jQuery once() plugint is.
3. A Libraries modul a sites/all/librariesből is hozzáadta a plugineket, amiket talált.
4. Talán contrib modulok is eljutottak már addig, hogy meghívogassák a nekik szükséges plugineket.

Ha figyeltünk, látjuk, hogy eddig végig az a window.jQuery object volt építgetve-bővitgetve, amit a Drupal az elején definiált. Mostanra jó kövérre hízott, végre is tud hajtani egy halom okos dolgot (pluginek által behozott funkciókat), mert már benne vannak azoknak a funkcióknak a definíciói is.

És akkor valaki jön, és a moduljából belinkel egy másik jQuery libet.

Ha semmilyen óvintézkedést nem tett, akkor annyi történik, hogy az eddig kövérre tanított window.jQuery felül lesz írva egy full alapértelmezettel (mivel ugyanaz a neve, új értéket kap a változó, előző erték kuka). Ez a frissen definiált, mondhatni újszülött jQuery object semmit nem fog még tudni az oldalról.

Az összes mindenki az előzővel beszélt. A tanárok már leléptek. Az oldal scriptjei elkezdik hívogatni azokat a funkciókat, amik csak a felülírással agyoncsapott előző window.jQuery-nek lettek megtanítva. Viszlát. Nem fog működni.

(Legalábbis én ezt értettem meg ebből (amikor mondja, hogy a "The once() function was added to the jQuery object which was destroyed"): https://drupal.org/node/995268#comment-7202002)

Megoldás

A Drupal tapasztalati pontjaim száma továbbra is relatíve alacsony, így azt tudom mondani, hogy én csak a jquery_update és jqmulti modulokkal manipulálnám a window.jQuery object karrierjét. Azok kiforrott, biztonságos contrib modulok, olyan szakemberek írták őket, akik tudták, hogy mit csinálnak.

Pl. a jqmulti szerzőjének ki kellett módolnia, hogy egyszerre két jQuery object is jelen tudjon lenni runtime-kor (így mondják?), és ráadásul megtalálják mindkettőt a scriptek, melyiknek melyik kell. Meg van oldva szakember által. Akkor én ezzel már a modulomból nem próbálkoznék.

A jquery_update-hez annyit, hogy okos óvatossággal emelgesse az ember a jquery verziót, mert ezt a modult használva minden scriptnek az emelt verziójú jQuery jut, és régebben írt scriptekben (akár core, akár contrib összetevőkben) ez nem minden funkciónak tetszhet, szóval figyelni kell.

Jqmultival kapcsolatban annyit tudnék mondani, hogy semmivel sem tudok többet, mint ami a README-jében le van írva. Egyszer mintha használtam volna... Emlékszem, írtad, hogy a beállítófelületéhez nem nyúltál... szerintem azt pedig kell, mert valahol meg kell mondani neki, hogy melyik scriptek legyenek a ráadásként jelenlévő, emelt verziójú jQuery objecthez rendelve (hogy a többit békén tudja hagyni).

Szóval alaposan olvasd el a modul project-oldalát és readme-jét.

Ha ezen kívül van további lehetőség és módszer a fentiek megoldására Drupal használatakor, akkor annak ismertetése már tényleg a tapasztaltak dolga kell hogy legyen.

jQuery használata modulban

(hogy a kérdésre is válaszoljak)

Kijavíthatom a kérdést? Ilyenre: jQuery funkciók használata modulok által definiált scriptekben.

1. A modulodban kell valamit js-el intézni.
2. A jQuery "dialektus" használata mellett döntesz, mert azt jobban ismered.
3. Fogsz egy .js kiterjesztésű file-t, beteszed a modulod könyvtárába, és beleteszed azt, amit úgy hívnak, hogy "immediately invoked anonymous function, that will alias the jQuery namespace to $" Ez a Zen smink default js file-jában (némileg felokosítva) így néz ki:
   

     (function ($, Drupal, window, document, undefined) {
       // Ide jön majd a kódod.
     })(jQuery, Drupal, this, this.document);

4. drupal_add_js-el, vagy #attached-el meghívod, amikor kell (vagy a modul .info file-jába teszed, nem tudom, nem fejlesztek modulokat).
5. Így a Drupal core által biztosított 1.4.4-es jQuery library-n lesz áthajtva a kód, ennek írhatsz jQuery-t (olyan funkciókat, amit ez a verzió megért).

Most jön az, hogy kell-e neked modernebb verzió, és mennyire legyen modernebb.

• Ha csupa olyan dolgot kell megvalósítanod, amit az 1.4.4 funkcióival is könnyen meg lehet, akkor kezdhetsz is dolgozni, semmi variálás nem kell.
• Ha olyasmit kell csinálnod, amihez újabb jQuery funkciók kellenének, akkor meg lehetne nézni, hogy melyik a legkisebb jQuery library verzió, amely már ismeri az(oka)t a funkció(ka)t.
• Ha 1.8-as alattiak, akkor dönthetsz a jquery_update használata mellett is, ez a modul addig feltornázza az oldal egyetlen jQuery libjét 1.8-ig, ha kell (óvatosan, írtam a másik kommentemben).
• Ha még 1.8-ban se lenne meg, ami neked kell, vagy nem akarod kockáztatni az oldal régebbi funkciókat használó összetevőinek egészségét, akkor jön a jqmulti, ami a default 1.4.4 lib mellé behoz még egyet, és kiválaszthatod, hogy mely scriptek legyenek a modernebben keresztül hajtva.

Szóval szerintem így dönteném el, hogy mikor melyik megoldáshoz folyamodjak. Ha 1.4.4 által ismert funkciókkal is meg tudom oldani, miért ne oldjam meg úgy? Az a legkevesebb fejfájás, mind a backend, mind a frontend teljesítményt az hagyja békén a leginkább.