„2007:Ajax függvények” változatai közötti eltérés
(→Kiterjesztések az Array osztályhoz) |
|||
(4 közbenső módosítás, amit 2 másik szerkesztő végzett, nincs mutatva) | |||
977. sor: | 977. sor: | ||
</tr> | </tr> | ||
</table> | </table> | ||
+ | |||
+ | |||
+ | ===Kiterjesztések a dokumentum DOM osztályhoz=== | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="594"> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | |||
+ | <td width="172"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="74"> | ||
+ | <p class="western"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="115"> | ||
+ | <p class="western"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="175"> | ||
+ | <p class="western"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="172"> | ||
+ | <p class="western"><b>getElementsByClassName(Classname[,paramentElement])</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="74"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="115"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">className: | ||
+ | a CSS osztály neve, parentElement: objektum vagy elemazonosító | ||
+ | mely a keresett</font></p> | ||
+ | <p class="western">elemeket tartalmazhatja</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="175"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Visszaadja | ||
+ | az összes</font></p> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">olyan | ||
+ | elemet amely</font></p> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">kapcsolatban | ||
+ | van a</font></p> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">megadott | ||
+ | CSS osztállyal.</font></p> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Ha | ||
+ | nincs parentElement</font></p> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">megadva, | ||
+ | akkor az egész</font></p> | ||
+ | <p class="western" style="widows: 2; orphans: 2;">dokumentumban | ||
+ | keres.</p></td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | |||
+ | ==A Prototype.js által definiált új objektumok és függvények== | ||
+ | |||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;" align="justify"> | ||
+ | A másik út amin keresztül a a könyvtár segít neked, | ||
+ | hogy sok olyan objektumot tartamaz amely egyrészt segíti az | ||
+ | objektumorientált tervezést, másrészt pedig közös funkcionalitásokat | ||
+ | tartalmaz.</p> | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;" align="justify"> | ||
+ | <br> | ||
+ | </p> | ||
+ | |||
+ | ===A PeriodicalExecuter objektum=== | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;"> | ||
+ | |||
+ | <font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | objektum arra szolgáltat logikát, hogy adott időközönként egy | ||
+ | függvényt folyamatosan meg tudjunk hívni.</font></p> | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;" align="justify"> | ||
+ | <br> | ||
+ | </p> | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="641"> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="162"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="80"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | |||
+ | <td width="146"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | </td> | ||
+ | <td width="194"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | |||
+ | <td width="162"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>[ctor](callback,interval</b><font face="TimesNewRomanPSMT, Times New Roman, serif"><b>)</b></font></p> | ||
+ | </td> | ||
+ | <td width="80"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Konstruktor</p> | ||
+ | </td> | ||
+ | <td width="146"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Callback: | ||
+ | egy paraméter nélküli függvény, interval: másodpercek száma.</p> | ||
+ | </td> | ||
+ | <td width="194"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Létrehozza | ||
+ | egy példányát az objektumnak, ami a függvényt folyamatosan | ||
+ | előhívja.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;" align="justify"> | ||
+ | |||
+ | <br> | ||
+ | </p> | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="641"> | ||
+ | <tr valign="top"> | ||
+ | <td width="153"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Tulajdonság</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="88"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="356"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="153"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Callback</b></p> | ||
+ | </td> | ||
+ | <td width="88"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Function()</p> | ||
+ | </td> | ||
+ | <td width="356"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">A | ||
+ | mehívandó függvény, nem fog semmilyen paramétert átadni neki.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="153"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Frequency</b></p> | ||
+ | </td> | ||
+ | <td width="88"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Number</p> | ||
+ | </td> | ||
+ | <td width="356"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Az | ||
+ | intervallum másodpercekben</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="153"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>CurrentlyExecuting</b></p> | ||
+ | </td> | ||
+ | <td width="88"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Boolean</p> | ||
+ | </td> | ||
+ | <td width="356"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Azt | ||
+ | jelszi, hogy a függvény fut-e</p> | ||
+ | </td> | ||
+ | |||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | |||
+ | ===Az Enumerable objektum=== | ||
+ | Az | ||
+ | Enumerable objektum segítségével sokkal elegánsabb kódot lehet írni | ||
+ | elemek iterálására egy listaszerű struktúrában. Sok egyéb objektum | ||
+ | terjeszti ki az Enumerable objektumot. | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="649"> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Each(iterator)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | |||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | adott iterátor meghívja a függvényt átadva neki az első | ||
+ | paraméterben az adott elemet a listában, a második paraméterben | ||
+ | pedig az elem indexét.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>All([iterator])</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Ez | ||
+ | a függvény arra jó, hogy tesztüljük az egész gyüjteményt az adott | ||
+ | függvény használatával. Az all false értéket ad vissza, ha az | ||
+ | iterator függvény false vagy null értéket ad vissza bármelyik | ||
+ | elemre. Egyébként pedig true lesz a visszatérési értéke. Ha nincs | ||
+ | iterátor megadva, akkor magán az elemen vizsgálja meg a false | ||
+ | vagy null értéket. egy függvény</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Any(iterator)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Ez | ||
+ | a függvény arra jó, hogy tesztüljük az egész gyüjteményt az adott | ||
+ | függvény használatával. Az any true értéket ad vissza, ha az | ||
+ | iterator függvény nem false vagy null értéket ad vissza bármelyik | ||
+ | elemre.Egyébként pedig false lesz a visszatérési értéke. Ha nincs | ||
+ | iterátor megadva, akkor magán az elemen vizsgálja meg hogy az | ||
+ | értéke más-e mint false vagy null.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Collect(iterator)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | |||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Meghívja | ||
+ | az iterator függvényt minden egyes elemre és minden eredményt egy | ||
+ | tömbben ad vissza a megfelelő sorrendben.</font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Detect(iterator)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Meghívja | ||
+ | az iterator függvényt minden egyes elemre és az első olyan | ||
+ | elemmel fog visszatérni aminél az iterator függvény visszatérési | ||
+ | értéke true (vagy pontosabban nem false). Ha nincs ilyen elem, | ||
+ | akkor a detectnull értéket fog visszaadni.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Entries()</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | |||
+ | <p class="western">nincs</p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Ugyanaz, | ||
+ | mint a toArray().</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Find(iterator)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Ugyanaz, | ||
+ | mint a detect()</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>findAll(iterator)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | |||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Meghívja | ||
+ | az iterator függvényt minden egyes elemre és egy tömbben | ||
+ | visszaadja mindazokat, amelyeknél az iterátor függvény | ||
+ | visszatérési értéke true volt. Ez a függvény a reject() | ||
+ | ellentéte.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Grep(pattern | ||
+ | [,iterator])</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | |||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">pattern: | ||
+ | egy RegExp objektum ami az elemek kiválasztására használhatunk, | ||
+ | iterator: egy függvény objektum Function(value,index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | összes elemet megvizsgálja az átadott pattern ellenében. A | ||
+ | függvény egy tömbben fogja visszaadni azokat az elemeket, melyek | ||
+ | megfeleltek a reguláris kifejezésnek. Ha az iterator meg van | ||
+ | adva, akkor a visszaadott tömb a hívás eredményeit fogja | ||
+ | tartalmazni minden egyes elemre amit megfelelt a kifejezésnek.</font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Include(obj)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">obj: | ||
+ | bármilyen objektum</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Megpróbálja | ||
+ | megkeresni az adott objektumot a gyűjteményben. True lesz a | ||
+ | visszatérési értéke ha megtalálta, egyébként pedig false.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Inject(initialValue,iterator)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | |||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">initialValue: | ||
+ | bármilyen objektum ami inicializáló értékként felhasználható, | ||
+ | iterator: egy függvény objektum Function(value,index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Összeköti | ||
+ | az összes elemet az iterator függvény segítésével. Az iterátort | ||
+ | az előző iteráció eredményével hívja meg az accumulator | ||
+ | paraméterben. Az első iteráció az initialValue értékét veszi az | ||
+ | accumulator paraméterben. A visszatérési érték az utolsó hívás | ||
+ | eredménye lesz.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Invoke(methodName | ||
+ | [,arg1 [,arg2 [….]])</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">methodName: | ||
+ | a metódus nevet ami minde egyes elemre meg lesz hívva, | ||
+ | arg1..argN: argumentumok, melyek a metódusnak át lesznek adva.</font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">A | ||
+ | megadott metódust meghívja minden egyes elemre átadva neki az | ||
+ | adott paramétereket (arg1 to argN), a visszatérési érték pedig a | ||
+ | függvényhívások eredménye lesz egy tömbben.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Map(iterator)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | |||
+ | <p class="western">Ugyanaz, mint a collect()</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Max([iterator])</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | |||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">A | ||
+ | legnagyobb értékű elemet adja vissza a gyűjteményben vagy a | ||
+ | legnagyobb eredéményét az iterátorhívásoknak, ha az iterator meg | ||
+ | volt adva.</font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Min([iterator])</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">A | ||
+ | legkisebb értékű elemet adja vissza a gyűjteményben vagy a | ||
+ | legkisebb eredéményét az iterátorhívásoknak, ha az iterator meg | ||
+ | volt adva.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Partition([iterator])</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | |||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömbböt fog visszaadni amely másik két tömbböt tartalmaz. Az első | ||
+ | az összes olyan elemet tartalmazza, melyen az iterátorhívás true | ||
+ | eredményt produkált, a másikban pedig a többi elem lesz. Ha az | ||
+ | iterator nem volt megadva, akkor az első tömbben azon elemek | ||
+ | lesznek, melyek true értéket produkálnak, a másikban pedig | ||
+ | értelemszerűen a többi elem lesz.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Pluck(propertyName)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">propertyName: | ||
+ | a tulajdonság neve, melzet minden elemből ki kell olvasni. Név | ||
+ | helyett tartalmazhatja a tulajdonság indexét is.</font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömbben az adott tulajdonság értékeit adja vissza minden egyes | ||
+ | elemből.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Reject(iterator)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | |||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Meghívja | ||
+ | az iterator függvényt minden egyes elemre és egy tömbben | ||
+ | visszaadja mindazokat, amelyeknél az iterátor függvény | ||
+ | visszatérési értéke false volt. Ez a függvény a findAll() | ||
+ | ellentéte.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Select(iterator)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | |||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Ugyanaz | ||
+ | mint a findAll().</font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>sortBy(iterator)</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">iterator: | ||
+ | egy függvény objetum Function(value, index) formában</font></p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | elemeket sorbarendezve egy tömbben fogja visszaadni a | ||
+ | függvényhívás eredményétől függően.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>ToArray()</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | |||
+ | <p class="western">nincs</p> | ||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömbben adja vissza a gyűjtemény összes elemét.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="181"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>zip(collection1[,collection2 | ||
+ | [,...collectionN[,transform]]])</b></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="153"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">collection1 | ||
+ | .. collectionN: enumerációk az egyesítéshez, transform: egy | ||
+ | függvény objektum Function(value, index) formában</font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="195"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Összevonja | ||
+ | az adott gyűjteményeket az eredeti gyűjteménnyel. Az eredménye | ||
+ | egy új tömb lesz, amiben az elemek száma megegyezik az | ||
+ | eredetiével és minden egyes elem egy újabb tömb. Ha a transform | ||
+ | függvény meg van adva, akkor a belső tömbbök a visszatérés előtt | ||
+ | ezzel lesznek feldolgozva. Egy gyors példa: [1,2,3].zip([4,5,6], | ||
+ | [7,8,9]).inspect() visszatérési értéke "[[1,4,7],[2,5,8],[3,6,9] | ||
+ | ]"</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | |||
+ | ===A Hash objektum=== | ||
+ | A Hash objektum egy hash struktúrát implementál, azaz | ||
+ | Kulcs:Érték párosok gyűjteménye. Minden elem a Hash objektumban egy | ||
+ | tümb két elemmel: az első a kulcs, a másik pedig az érték. Minden | ||
+ | elemnek két tulajdonsága van: a key és a value. | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="658"> | ||
+ | <tr valign="top"> | ||
+ | <td width="133"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="63"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="125"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | </td> | ||
+ | <td width="279"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="133"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Keys()</b></p> | ||
+ | </td> | ||
+ | <td width="63"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">példány</p> | ||
+ | </td> | ||
+ | <td width="125"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Nincs</p> | ||
+ | </td> | ||
+ | <td width="279"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömbben visszaadja az elemek kulcsait.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="133"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Values()</b></p> | ||
+ | </td> | ||
+ | <td width="63"> | ||
+ | <p class="western" style="text-indent: 0.06cm; widows: 2; orphans: 2;" align="justify"> | ||
+ | példány</p> | ||
+ | </td> | ||
+ | <td width="125"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Nincs</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="279"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömbben visszaadja az elemek értékeit</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="133"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Merget(otherHash)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="63"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">példány</p> | ||
+ | </td> | ||
+ | <td width="125"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">otherHash:Hash | ||
+ | objektum</p> | ||
+ | </td> | ||
+ | <td width="279"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | adott has objektumot összevonja az átadott hash objektummal és | ||
+ | egy új hash objektumot fog visszaadni.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="133"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>toQueryString()</b></p> | ||
+ | </td> | ||
+ | <td width="63"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">példány</p> | ||
+ | </td> | ||
+ | <td width="125"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Nincs</p> | ||
+ | </td> | ||
+ | <td width="279"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | öszes elemet a hash objektumban szöveges formában fogja | ||
+ | visszaadni, 'key1=value1&key2=value2&key3=value3'</font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="133"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Inspect()</b></p> | ||
+ | </td> | ||
+ | <td width="63"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">példány</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="125"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">nincs</p> | ||
+ | </td> | ||
+ | <td width="279"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Szintén | ||
+ | egy jól formázott szövegként adja vissza a hash kulcs:érték | ||
+ | párosait.</font></p> | ||
+ | </td></table> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===Az ObjectRange osztály=== | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;" align="justify"> | ||
+ | <font size="4">Az </font><font size="4"><i>Enumerable</i></font> | ||
+ | |||
+ | <font size="4">osztályból származik.</font></p> | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;" align="justify"> | ||
+ | <br> | ||
+ | </p> | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;"> | ||
+ | <font face="TimesNewRomanPSMT, Times New Roman, serif"><font size="4">Értékek | ||
+ | sorozatát reprezentája alsó és felső határokkal.</font></font></p> | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;" align="justify"> | ||
+ | <br> | ||
+ | |||
+ | </p> | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="650"> | ||
+ | |||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="96"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Tulajdonság</b></font></p> | ||
+ | </td> | ||
+ | <td colspan="2" width="67"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | |||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Kind</b></font></p> | ||
+ | </td> | ||
+ | <td colspan="3" width="368"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="96"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>Start</b></p> | ||
+ | </td> | ||
+ | <td colspan="2" width="67"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">(bármi)</font></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">példány</font></p> | ||
+ | |||
+ | </td> | ||
+ | <td colspan="3" width="368"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | alsó határa a tartománynak</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="96"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>end </b> | ||
+ | |||
+ | </p> | ||
+ | </td> | ||
+ | <td colspan="2" width="67"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">(bármi)</font></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">példány</font></p> | ||
+ | </td> | ||
+ | |||
+ | <td colspan="3" width="368"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">A | ||
+ | felső határa a tartománynak</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="96"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>exclusive </b> | ||
+ | </p> | ||
+ | |||
+ | </td> | ||
+ | <td colspan="2" width="67"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Boolean</font></p> | ||
+ | </td> | ||
+ | <td width="62"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">példány</font></p> | ||
+ | </td> | ||
+ | <td colspan="3" width="368"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Azt | ||
+ | határozza meg hogy a határok beleértendőek-e a tartományba.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td colspan="2" width="159"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td colspan="3" width="84"> | ||
+ | |||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="147"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméter</b></font></p> | ||
+ | </td> | ||
+ | <td width="202"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td colspan="2" width="159"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>[ctor](start, | ||
+ | end, exclusive)</b></p> | ||
+ | </td> | ||
+ | <td colspan="3" width="84"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">Konstruktor</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="147"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">start: | ||
+ | az alsó határ, end: a felső határ, exclusive: a határok benne | ||
+ | lesznek a tartományban</font></p> | ||
+ | </td> | ||
+ | <td width="202"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tartományt hoz létre, kezdve a start paramétertől az end | ||
+ | paraméter értékéig. Fontos megjegyezni, hogy a start és end | ||
+ | objektumoknak ugyanolyan típusnak kell lennie és kell | ||
+ | definiálniuk egy succ() metódust.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td colspan="2" width="159"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>include(searchedValue)</b></p> | ||
+ | </td> | ||
+ | <td colspan="3" width="84"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;" align="justify">példány</p> | ||
+ | </td> | ||
+ | <td width="147"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">searchedValue: | ||
+ | a</font></p> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">keresett | ||
+ | érték</font></p> | ||
+ | </td> | ||
+ | <td width="202"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Megvizsgálja, | ||
+ | hogy az adott értéket tartalmazza-e a tartomány. A visszatérési | ||
+ | érték true vagy false lehet.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | ===A Class objektum=== | ||
+ | |||
+ | A Class objektum más osztályok deklarálásakor használatos a könyvtárban. Ennek az objektumnak a használatával egy osztály deklarációjánál azt érjük el, hogy támogatni fogja az initialize() metódust, amely konstruktorként működik. | ||
+ | |||
+ | Lássunk egy példát: | ||
+ | |||
+ | |||
+ | //deklaráljuk az osztályt// | ||
+ | var MySampleClass = Class.create(); | ||
+ | //implementáljuk magát az osztályt | ||
+ | MySampleClass.prototype = { | ||
+ | initialize: function(message) { | ||
+ | this.message = message; | ||
+ | }, | ||
+ | showMessage: function(ajaxResponse) { | ||
+ | alert(this.message); | ||
+ | } | ||
+ | }; | ||
+ | //most pedig példányosítsuk// | ||
+ | var myTalker = new MySampleClass('hi there.'); | ||
+ | |||
+ | myTalker.showMessage(); //mutassuk meg az üzenetet/// | ||
+ | |||
+ | |||
+ | |||
+ | ==Az Ajax.Base osztály== | ||
+ | |||
+ | Ez | ||
+ | az osztály szolgál alaposztályul a legtöbb osztályhoz az Ajax | ||
+ | objektumban. | ||
+ | <p class="western"><br><br> | ||
+ | </p> | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="570"> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="148"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | |||
+ | <td width="149"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | |||
+ | <td width="148"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>setOptions(options)</b></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western">Option: ajax opció</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western">Beállítja a kívánt opciókat az ajax művelethet</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="148"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>responseIsSuccess()</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western">Nincs</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | |||
+ | <p class="western">True lesz a visszatérési értéke, ha az AJAX | ||
+ | művelet sikerest volt, egyébként pedig false</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="148"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><b>responseIsFailure()</b></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | |||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western">Nincs</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western">Ellentetje a <i>responseIsSucces</i>() | ||
+ | metódusnak</p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | |||
+ | ==Az Ajax.Request osztály== | ||
+ | Az ajax.base osztályból származik. | ||
+ | Összefoglalja az AJAX műveleteket. | ||
+ | |||
+ | |||
+ | |||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="650"> | ||
+ | |||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="115"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Tulajdonság</b></font></p> | ||
+ | </td> | ||
+ | |||
+ | <td width="123"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="85"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Kind</b></font></p> | ||
+ | </td> | ||
+ | <td width="269"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>leírás</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="115"> | ||
+ | <p class="western"><b>Events</b></p> | ||
+ | </td> | ||
+ | <td width="123"> | ||
+ | <p class="western">Array</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="85"> | ||
+ | <p class="western">Statikus</p> | ||
+ | </td> | ||
+ | <td width="269"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">A | ||
+ | lehetséges események/állapotok listája egy AJAX művelethez. A | ||
+ | lista értékei: 'Uninitialized', 'Loading', </font>'Loaded', | ||
+ | 'Interactive', és 'Complete.'</p> | ||
+ | </td> | ||
+ | |||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="115"> | ||
+ | <p class="western"><b>Transport</b></p> | ||
+ | </td> | ||
+ | <td width="123"> | ||
+ | <p class="western">XMLHttpRequest</p> | ||
+ | </td> | ||
+ | |||
+ | <td width="85"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="269"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | XMLHttpRequest objektum ami tartalmazz az </font>AJAX műveletet</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="115"> | ||
+ | <p class="western"><b>url</b></p> | ||
+ | </td> | ||
+ | <td width="123"> | ||
+ | <p class="western">String</p> | ||
+ | </td> | ||
+ | <td width="85"> | ||
+ | |||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="269"> | ||
+ | <p class="western">A kéréshez tartozó URL</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | <p class="western"><br><br> | ||
+ | |||
+ | </p> | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="650"> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="134"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="128"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | </td> | ||
+ | <td width="263"> | ||
+ | |||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="134"> | ||
+ | <p class="western"><b>[ctor](url, options)</b></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | |||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="128"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">url: | ||
+ | a hívandó url, options: </font>AJAX opciók</p> | ||
+ | </td> | ||
+ | <td width="263"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Létrehozza | ||
+ | az adott objektum egy példányát amivel meg fogja hívni az adott | ||
+ | url-t a megadott opciókkal. Az onCreate esemény ki fog váltódni a | ||
+ | konstruktor hívásaközben.</font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==AJAX opciók== | ||
+ | |||
+ | |||
+ | |||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="650"> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | |||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Alapérték</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>Method</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western">String</p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western">’post’</p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | |||
+ | <p class="western">A http kérés módja</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>Parameters</b></p> | ||
+ | </td> | ||
+ | <td width="184"> | ||
+ | |||
+ | <p class="western">String</p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western">”</p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">url-formázott | ||
+ | listája az kérésben </font>átadandó értékeknek</p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>Asynchronous</b></p> | ||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western">Boolean</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western">True</p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Azt | ||
+ | jelzi, hogy az AJAX hívást </font>asszinkron módon kell-e végezni</p> | ||
+ | </td> | ||
+ | |||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>postBody</b></p> | ||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western">String</p> | ||
+ | </td> | ||
+ | |||
+ | <td width="72"> | ||
+ | <p class="western"><br> | ||
+ | </p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Content | ||
+ | passed to in the request's </font>body in case of a HTTP POST</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>RequestHeaders</b></p> | ||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western">Array</p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | |||
+ | <p class="western"><br> | ||
+ | </p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">A | ||
+ | hívásban átadandó http fejlécek listája. Az elemek számának | ||
+ | párosnak kell lennie, minden páratlan elem egy fejléc elem nevét | ||
+ | tartalmazza, az azt követő értéknek pedig az értéknekszöveges | ||
+ | formában. Például:['myheader1', 'this is the value', | ||
+ | 'myother-</font>header', 'another value']</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | |||
+ | <td width="125"> | ||
+ | <p class="western"><b>onXXXXXXXX</b></p> | ||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;">Function(XMLHttpRequest)</p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western"><br> | ||
+ | |||
+ | </p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egyedi | ||
+ | függvény ami a megfelelő esemény/státusz elérésekor hívódik meg | ||
+ | az AJAX hívás során. A függvény egy paramétert fog kapni, ami az | ||
+ | XMLHttpRequest objektumot tartalmazza.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | |||
+ | <p class="western"><b>onSucces</b></p> | ||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;">Function(XMLHttpRequest)</p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western"><br> | ||
+ | </p> | ||
+ | |||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egyedi | ||
+ | függvény ami a az AJAX hívás sikeres befejezésekor hívódik meg. A | ||
+ | függvény egy paramétert fog kapni, ami az XMLHttpRequest | ||
+ | </font>objektumot tartalmazza.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>onFailure</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;">Function(XMLHttpRequest)</p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western"><br> | ||
+ | </p> | ||
+ | </td> | ||
+ | |||
+ | <td width="212"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egyedi | ||
+ | függvény ami a az AJAX hívás sikertelen befejezésekor hívódik | ||
+ | meg. A függvény egy paramétert fog kapni, ami az XMLHttpRequest | ||
+ | </font>objektumot tartalmazza.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>Insertion</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;">Function(Object, | ||
+ | String)</p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western">Null</p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | |||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Olyan | ||
+ | függvény amely a visszaadott szöveget beszúrja egy adott elembe. | ||
+ | Két paramétere van, az elsőben a frissítendő elemet, mint | ||
+ | objektumot kell átadni, míg a másodikban a szöveget. Csak az | ||
+ | Ajax.Updater objektummal használható. </font> | ||
+ | </p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>evalScript</b></p> | ||
+ | </td> | ||
+ | |||
+ | <td width="184"> | ||
+ | <p class="western">Boolean</p> | ||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western">False</p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Azt | ||
+ | határozza meg, hogy a válasz érkezésekor ki kell-e értékelni a | ||
+ | szkript blokkot. Csak az Ajax.Updater objektummal használható.</font></p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>decay</b></p> | ||
+ | </td> | ||
+ | <td width="184"> | ||
+ | <p class="western">number</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="72"> | ||
+ | <p class="western">1</p> | ||
+ | </td> | ||
+ | <td width="212"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Meghatározza | ||
+ | a folyamatos lelassulást(növekedést) az Ajax.PeriodicalUpdater | ||
+ | objektum frissítési gyakoriságában amikor az utolsó válasz azonos | ||
+ | az előzőével. Például ha 2 a beállított érték és egy frissítés | ||
+ | után azonos válasz érkezik az előzővel, akkor az objektum kétszer | ||
+ | annyi ideig fog várni a következő frissítéssel. Ha ez újra | ||
+ | megismétlődik, akkor legközelebb már négyszer annyi ideig vár és | ||
+ | így tovább. </font> | ||
+ | </p> | ||
+ | </td> | ||
+ | |||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | |||
+ | ==Form függvények== | ||
+ | A formok függvényei. | ||
+ | |||
+ | ''' A Field objektum''' | ||
+ | <p class="western"><br><br> | ||
+ | </p> | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="650"> | ||
+ | <tr valign="top"> | ||
+ | <td width="148"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | </td> | ||
+ | <td width="229"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="148"> | ||
+ | <p class="western"><b>clear(field1 [, field2[, field3 [...]]])</b></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">fieldN: | ||
+ | a beviteli mező azonosítója vagy maga </font>az mező</p> | ||
+ | </td> | ||
+ | <td width="229"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;">Az összes | ||
+ | átadott mező értékét kitörli.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | |||
+ | <td width="148"> | ||
+ | <p class="western"><b>present(field1 [,field2 [, field3 [...]]])</b></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">fieldN: | ||
+ | a beviteli mező azonosítója vagy maga </font>az mező</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="229"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">true | ||
+ | lesz a visszatérési értéke ha mindegyik mező tartalmaz valamilyen | ||
+ | </font>értéket(nem üres).</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="148"> | ||
+ | <p class="western"><b>focus(field)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">fieldN: | ||
+ | a beviteli mező azonosítója vagy maga </font>az mező</p> | ||
+ | </td> | ||
+ | |||
+ | <td width="229"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;">A fókuszt az | ||
+ | adott mezőre állítja.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="148"> | ||
+ | <p class="western"><b>select(field)</b></p> | ||
+ | </td> | ||
+ | |||
+ | <td width="67"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">fieldN: | ||
+ | a beviteli mező azonosítója vagy maga </font>az mező</p> | ||
+ | </td> | ||
+ | <td width="229"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Kijelöli | ||
+ | az értéket a mezőben ha az </font>támogatja a szövegkijelölést.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="148"> | ||
+ | <p class="western"><b>activate(field)</b></p> | ||
+ | </td> | ||
+ | |||
+ | <td width="67"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">fieldN: | ||
+ | a beviteli mező azonosítója vagy maga </font>az mező</p> | ||
+ | </td> | ||
+ | <td width="229"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">A | ||
+ | fókuszt az adott mezőre állítja és kijelöli az értéket a mezőben | ||
+ | ha az </font>támogatja a szövegkijelölést.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | <p class="western"><br><br> | ||
+ | </p> | ||
+ | |||
+ | |||
+ | '''A form Objektum''' | ||
+ | |||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="658"> | ||
+ | <tr valign="top"> | ||
+ | <td width="169"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="52"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="83"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | </td> | ||
+ | <td width="295"> | ||
+ | |||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="169"> | ||
+ | <p class="western"><b>Serialize(form)</b></p> | ||
+ | </td> | ||
+ | <td width="52"> | ||
+ | |||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="83"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">form: | ||
+ | az űrlap azonosítója vagy maga az </font>űrlap</p> | ||
+ | </td> | ||
+ | <td width="295"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">a | ||
+ | mezők neveit és azok értékeit egy urlformázott formában adja | ||
+ | vissza, pl. </font>'field1=value1&field2=value2&field3=value3</p> | ||
+ | |||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="169"> | ||
+ | <p class="western"><b>findFirstElement(form)</b></p> | ||
+ | </td> | ||
+ | <td width="52"> | ||
+ | <p class="western">példány</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="83"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">form: | ||
+ | az űrlap azonosítója vagy maga az </font>űrlap</p> | ||
+ | </td> | ||
+ | <td width="295"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Visszaadja | ||
+ | az első engedélyezett mezőt az </font>űrlapon.</p> | ||
+ | </td> | ||
+ | |||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="169"> | ||
+ | <p class="western"><b>getElements(form)</b></p> | ||
+ | </td> | ||
+ | <td width="52"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | |||
+ | <td width="83"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">form: | ||
+ | az űrlap azonosítója vagy maga az </font>űrlap</p> | ||
+ | </td> | ||
+ | <td width="295"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömbben adja vissza az összes beviteli </font>mezőt az űrlapon | ||
+ | belül.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="169"> | ||
+ | <p class="western"><b>getInputs(form [,typeName [, name]])</b></p> | ||
+ | </td> | ||
+ | <td width="52"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="83"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">form: | ||
+ | az űrlap azonosítója vagy maga az </font>űrlap</p> | ||
+ | </td> | ||
+ | <td width="295"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömböt ad vissza, ami tartalmazz az összes <input> elemet | ||
+ | az űrlapon. Opcinálisan a lista szűrhető a megadott type vagy | ||
+ | name paraméter segítségével.</font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="169"> | ||
+ | <p class="western"><b>Disable(form)</b></p> | ||
+ | </td> | ||
+ | <td width="52"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="83"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">form: | ||
+ | az űrlap azonosítója vagy maga az </font>űrlap</p> | ||
+ | </td> | ||
+ | <td width="295"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Letiltja | ||
+ | az összes bevizeli mezőt az űrlapon </font>belül.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | |||
+ | <td width="169"> | ||
+ | <p class="western"><b>Enable(form)</b></p> | ||
+ | </td> | ||
+ | <td width="52"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="83"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">form: | ||
+ | az űrlap azonosítója vagy maga az </font>űrlap</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="295"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Engedélyezi | ||
+ | az összes bevizeli mezőt az űrlapon </font>belül.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="169"> | ||
+ | <p class="western"><b>focusFirstElement(form)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="52"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="83"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">form: | ||
+ | az űrlap azonosítója vagy maga az </font>űrlap</p> | ||
+ | </td> | ||
+ | |||
+ | <td width="295"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Activates | ||
+ | the first visible, enabled input field </font>in the form.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="169"> | ||
+ | <p class="western"><b>Reset(form)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="52"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="83"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">form: | ||
+ | az űrlap azonosítója vagy maga az </font>űrlap</p> | ||
+ | </td> | ||
+ | |||
+ | <td width="295"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Visszaállítja | ||
+ | az eredeti értékeket az űrlapon. Ugyanazt mint a reset() metódos | ||
+ | hívása a </font>form objektumon.</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | <p class="western"><br><br> | ||
+ | </p> | ||
+ | <p class="western"><br><br> | ||
+ | |||
+ | </p> | ||
+ | |||
+ | '''Form.Element osztály''' | ||
+ | <p class="western"><br><br> | ||
+ | </p> | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="591"> | ||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | </td> | ||
+ | <td width="193"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | |||
+ | <tr valign="top"> | ||
+ | <td width="125"> | ||
+ | <p class="western"><b>Serialize(element)</b></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | |||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">element: | ||
+ | elemazonosító vagy </font>maga az elem</p> | ||
+ | </td> | ||
+ | <td width="193"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Az | ||
+ | elemet egy név=érték páros formájában adja vissza, pl. | ||
+ | </font>'elementName=elementValue'</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | |||
+ | <td width="125"> | ||
+ | <p class="western"><b>getValue(element)</b></p> | ||
+ | </td> | ||
+ | <td width="67"> | ||
+ | <p class="western">Példány</p> | ||
+ | </td> | ||
+ | <td width="149"> | ||
+ | <p class="western"><font face="TimesNewRomanPSMT, Times New Roman, serif">element: | ||
+ | elemazonosító vagy </font>maga az elem</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="193"> | ||
+ | <p class="western">Visszaadja az elem értékét</p> | ||
+ | |||
+ | </td></table> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | '''A Form.Element.Serializers objektum''' | ||
+ | <p class="western"><br><br> | ||
+ | </p> | ||
+ | <p class="western" style="margin-bottom: 0cm; widows: 2; orphans: 2;"> | ||
+ | <font face="TimesNewRomanPSMT, Times New Roman, serif"><font size="4">Az | ||
+ | objektum pár olyan hasznos függvényt tartalmaz, amely segíti az | ||
+ | űrlap elemek aktuális értékének kinyerését.</font></font></p> | ||
+ | |||
+ | <p class="western"><br><br> | ||
+ | </p> | ||
+ | <table border="1" bordercolor="#000000" cellpadding="7" cellspacing="0" width="651"> | ||
+ | <tr valign="top"> | ||
+ | <td width="155"> | ||
+ | |||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Metódus</b></font></p> | ||
+ | </td> | ||
+ | <td width="69"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Típus</b></font></p> | ||
+ | </td> | ||
+ | <td width="148"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Paraméterek</b></font></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="220"> | ||
+ | <p class="western" align="center"><font face="Arial Narrow, sans-serif"><b>Leírás</b></font></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="155"> | ||
+ | <p class="western"><b>inputSelector(element)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="69"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="148"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">element: | ||
+ | objektum vagy az azonosítója egy olyan űrlap elemnek, melynek van | ||
+ | </font><font face="TimesNewRomanPS-ItalicMT, Times New Roman, serif"><i>checked | ||
+ | </i></font><font face="TimesNewRomanPSMT, Times New Roman, serif">tulajdonsága, | ||
+ | ilyen például a radio button vagy a </font>checkbox.</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="220"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömböt ad vissza az elem nevével és értékével, | ||
+ | pl.['elementName',</font>'elementValue']</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="155"> | ||
+ | <p class="western"><b>textarea(element)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="69"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="148"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">element: | ||
+ | objektum vagy az azonosítója egy olyan űrlap elemnek, melynek van | ||
+ | </font><font face="TimesNewRomanPS-ItalicMT, Times New Roman, serif"><i>value | ||
+ | </i></font><font face="TimesNewRomanPSMT, Times New Roman, serif">tulajdonsága, | ||
+ | ilyen például a textbox, button vagy a </font>password.</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="220"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömböt ad vissza az elem nevével és értékével, | ||
+ | pl.['elementName',</font>'elementValue']</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td width="155"> | ||
+ | <p class="western"><b>select(element)</b></p> | ||
+ | |||
+ | </td> | ||
+ | <td width="69"> | ||
+ | <p class="western">példány</p> | ||
+ | </td> | ||
+ | <td width="148"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">element: | ||
+ | objektum vagy az azonosítója egy <select> </font>elemnek</p> | ||
+ | |||
+ | </td> | ||
+ | <td width="220"> | ||
+ | <p class="western" style="widows: 2; orphans: 2;"><font face="TimesNewRomanPSMT, Times New Roman, serif">Egy | ||
+ | tömböt ad vissza az elem nevével és az összes kiválasztott opció | ||
+ | értékével vagy szövegével, pl. ['elementName', 'selOpt1 </font>selOpt4 | ||
+ | selOpt9']</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | |||
+ | ==Forrás anyagok== | ||
+ | |||
+ | '''Források:''' | ||
+ | *http://www.prototypedoc.com/ | ||
+ | *http://beta.bigmedium.com/bm~doc/prototype-151-api.pdf | ||
+ | *http://www.maxkiesler.com/index.php/search/results/2dbb93bd8aeff0d9feb5f0cf0f39631e/ | ||
+ | |||
+ | '''Letölthető AJAX scriptek:''' | ||
+ | *http://www.dhtmlgoodies.com/index.html?page=ajax | ||
+ | *http://www.hotscripts.com/Ajax/index.html | ||
+ | |||
+ | '''Letölthető függvény-könyvtárak:''' | ||
+ | *Prototype.js letöltése: http://www.prototypejs.org/ | ||
+ | *Dojo letöltése: http://dojotoolkit.org/ | ||
+ | *Rico függvénytár: http://openrico.org/downloads | ||
+ | |||
+ | '''Ajaxxal foglalkozó fórum:''' | ||
+ | http://www.prog.hu/kereses/?expr=ajax&oc=20 | ||
+ | |||
+ | '''Kapcsolódó irodalmak:''' | ||
+ | *Steve Holzner – Ajax for Dummies | ||
+ | *Nicholas C. Zakas & Jeremy McPeakand & Joe Fawcett – Professional Ajax | ||
+ | *Ryan Asleson and Nathaniel T. Schutta – Fundations of Ajax | ||
+ | |||
+ | [[Kategória:Lexikon_(classic)]] |
A lap jelenlegi, 2008. január 29., 10:23-kori változata
Tartalomjegyzék
- 1 Mi is az AJAX?
- 2 Prototype.js
- 3 A segédfüggvények
- 4 Az Ajax objektum
- 5 Az Ajax.Request osztály
- 6 Az Ajax.Updater osztály használata
- 7 Kiterjesztések a JavaScript osztályokhoz
- 8 A Prototype.js által definiált új objektumok és függvények
- 9 Az Ajax.Base osztály
- 10 Az Ajax.Request osztály
- 11 AJAX opciók
- 12 Form függvények
- 13 Forrás anyagok
Mi is az AJAX?
A leírás megtalálható az alábbi linken: Wikipedia.hu
Prototype.js
Mi is ez?
Abban az esetben ha még nem találkoztál volna vele, a prototype.js egy JavaScript könyvtár,melyet Sam Stephenson készített. Ez a szabványos, nagyon jól átgondolt és megírt könyvtár nagy terhet vesz le mindazok válláról, akik a Web 2.0-t jellemző interaktivitást szeretnének az,oldalaikon implementálni. Ha már próbáltad használni ezt a könyvtárat akkor feltünhetett, hogy a dokumentáció nem a legerősebb oldala. Mint sok más hozzám hasonló fejlesztő, próbáltam a forráskódot olvasgatni és kísérletezni vele. Gondoltam jó dologl enne jegyzetelni miközben megismerem és ezt megosztani másokkal is. Ezenkívül figyelmedbe ajánlok egy nem hivatalos referenciát a könyvtár által szolgáltatott objektumokról, osztályokról, függvényekről és kiterjesztésekről. Azok a fejlesztők akik járatosak a Ruby programozási nyelvben, a példák és a referencia tanulmányozása közben észreveszik majd a hasonlóságot a Ruby sok beépített osztályával és a könyvtár által implementált kiterjesztésekkel.
A segédfüggvények
A könyvtár rengeteg előre definiált objektumot és segédfüggvényt tartalmaz. Ezen függvények nyilvánvaló célja, hogy sok felesleges gépeléstől és munkától mentse meg a fejlesztőt.
A $() függvény használata
A $() függyvény egy könnyen használható rövidítése a gyakran használt document.getElementById() DOM függvénynek. Az eredetihez hasonlóan a paraméterben átadott azonosítóval rendelkező elemmel tér vissza. De tovább is megy egy kicsit, így több azonosítót is át lehet adni neki paraméterként és ebben az esetben egy objektum tömbbel fog visszatérni, ami tartalmazza az összes kért elemet. A következő példa ezt mutatja be.
<HTML> <HEAD> <TITLE> Tesztoldal </TITLE> <script src="prototype-1.4.0.js"></script> <script> function test1() { var d = $('myDiv'); alert(d.innerHTML); } function test2() { var divs = $('myDiv','myOtherDiv'); for(i=0; i<divs.length; i++) { alert(divs[i].innerHTML); } } </script> </HEAD> <BODY> <input type="button" value=Test1 onclick="test1();">
<input type="button" value=Test2 onclick="test2();">
</BODY> </HTML>
Egy másik hasznos tulajdonsága ennek a függvénynek, hogy nem pusztán az azonosítót lehet neki átadni szövegként, hanem magát az elemet mint objektumot, ez pedig igen hasznos lehet azokban az esetekben amikor új függvényeket készítünk melyekben mindkét fajta paraméterezésre lehetőséget szeretnénk biztosítani.
Az $F() függvény használata
Az $F() függvény is egy hasznos rövidítés, bármilyen beviteli mező értékét képes visszaadni, akár egy lenyíló listáét is. A már az előzőekben leírtakhoz hasonlóan az azonosítót vagy magát az objektumot is át lehet adni paraméterként.
<script> function test3() { alert( $F('userName') ); } </script> <input type="text" id="userName" value="Joe Doe">
<input type="button" value=Test3 onclick="test3();">
Az $A() függvény használata
Az $A() függvény a kapott paramétert tömbbé konvertálja. Ez a függvény az Array osztály kiterjesztéseivel együtt használva sokkal egyszerűbbé teszi olyan függvények írását, melyekben változó számú paramétereket akarunk fogadni.
<script> function shoutOut(){ sayHi('Hello, ', 'Homer', 'Bart', 'Marge', 'Snowball'); } function sayHi(){ var names = $A(arguments).slice(1); var phrase = arguments[0]; for(i=0; i<names.length; i++) alert(phrase + names[i]); } </script> <input type="button" value="Say hi to everybody" onclick="shoutOut();" >
A $H() függvény használata
A $H() függvény bármilyen asszociatív tömböt egy Hash objektummá konvertál.
<script> function testHash() { var a = []; //az asszociatív tömb feltöltése a['first'] = 10; a['second'] = 20; a['third'] = 30; //konvertájuk var h = $H(a); alert(h.toQueryString()); //displays: first=10&second=20&third=30 } </script>
Az $R() függvény használata
Az $R() függvény pusztán csak egy rövidítése a new ObjectRange(lowerBound, upperBound, excludeBounds)-nek. Az ObjectRange osztály dokumentációjában megtalálhatod a bővebb leírást. De azért nézzünk meg gyorsan egy egyszerű példát ami megmutatja, hogyan kell végigiterálni az each metódus segítségével. Erről a metódusról pedig az Enumerable osztály dokumentációjában olvashatsz bővebben.
<script> function demoDollar_R(){ var range = $R(10, 20, false); range.each(function(value, index){ alert(value); }); } </script> <input type="button" value="Sample Count" onclick="demoDollar_R();" >
A Try.these() függvény használata
A Try.these() függvény akkor lehet hasznos számodra, ha több függvényhívást szeretnél egymás után végrehajtatni, mindaddig amíg az egyik sikeres nem lesz. Értelemszerűen több függvényt lehet neki paraméterként átadni és ezeket sorra elkezdi meghívni mindaddig amíg az egyik nem működik, és a függvény visszatérési értéke ennek visszadott értéke lesz. A következő példában használt xmlNode.text függvény csak bizonyos böngészők esetében működik, a xmlNode.textContent függvény pedig más böngészőkkel vezet sikerre. A Try.these() használatával azzal kapjuk vissza a megfelelő eredményt amely működött.
<script> function getXmlNodeValue(xmlNode){ return Try.these( function() {return xmlNode.text;}, function() {return xmlNode.textContent;) ); } </script>
Az Ajax objektum
Az eddig leírt segédfüggvények szépek és jók, de valljuk be, nem igazán rengetik meg a világot. Talán ezeket magad is megcsináltad és ott vannak már a saját szkriptjeidben. De ezek a függvények csak a jéghegy csúcsát jelentik. Biztos vagyok benne, hogy a prototype.js AJAX lehetőségei keltik fel majd igazán az érdeklődésedet. Csapjunk is bele, nézzük meg miként teszi könnyebbé az életedet a könyvtár ha AJAX használtára van szükséged. Az Ajax objektum egy előre definiált objetum amit a könyvtár hoz létre azért, hogy elfedje és egyszerűsítse a trükközést ami az AJAX funkcionalitáshoz szükséges. Az objektum több osztályt is tartalmaz amely AJAX logikát tartalmaz. Nézzünk meg párat ezekből.
Az Ajax.Request osztály
Ha nem használsz semmiféle könyvtárat akkor elég sok kódot kell írnod ahhoz, hogy létrehozz egy XMLHttpRequest objektumot és nyomonkövesd a folyamatokat aszinkron, majd feldolgozd a választ. Na és szerencsésnek mondhatod magad, ha csak egyfajta böngészővel foglalkoznod. Ennek segítésére a könyvtárban definiálva van az Ajax.Request osztály. Vegyünk egy példát, mondjuk van egy alkalmazásod ami képes kommunikálni a szerverrel a "http://yoursever/app/get_sales?empID=1234&year=1998" hivatkozáson keresztül és a választ a következő XML formában küldi vissza.
<?xml version="1.0" encoding="utf-8" ?> <ajax-response> <response type="object" id="productDetails"> <monthly-sales> <employee-sales> <employee-id>1234</employee-id> <year-month>1998-01</year-month> <sales>$8,115.36</sales> </employee-sales> <employee-sales> <employee-id>1234</employee-id> <year-month>1998-02</year-month> <sales>$11,147.51</sales> </employee-sales> </monthly-sales> </response> </ajax-response>
Az Ajax.Request objektum segítségével nagyon egyszerű a szerverhez eljuttatni a kérést és a kapott választ feldolgozni. A következő példa ezt mutatja be.
<script> function searchSales() { var empID = $F('lstEmployees'); var y = $F('lstYears'); var url = 'http://yoursever/app/get_sales'; var pars = 'empID=' + empID + '&year=' + y; var myAjax = new Ajax.Request( url, { method: 'get', parameters: pars, onComplete: showResponse }); } function showResponse(originalRequest) { //put returned XML in the textarea $('result').value = originalRequest.responseText; } </script> <select id="lstEmployees" size="10" onchange="searchSales()"> <option value="5">Buchanan, Steven</option> <option value="8">Callahan, Laura</option> <option value="1">Davolio, Nancy</option> </select> <select id="lstYears" size="3" onchange="searchSales()"> <option selected="selected" value="1996">1996</option> <option value="1997">1997</option> <option value="1998">1998</option> </select>
<textarea id=result cols=60 rows=10 ></textarea>
Az Ajax.Request objektumnak átadott paramétert. Ez {method: 'get', parameters: pars, onComplete: showResponse} egy névtelen objektumot reprezentál. Ez azt jelenti, hogy egy olyan objektumot adunk át amelynek a method tulajdonsága a 'get' szöveges értéket tartalmazza, a parameters tulajdonság a HTTP kérés paramétereit, az onComplete pedig a showResponse függvényre való hivatkozást tartalmazza. Ezeken kívül van még néhány olyan tulajdonság amit meg lehet adni, ilyen például az asynchronous, aminek az értéke true vagy false lehet és azt határozza meg, hogy az AJAX hívás a szerver felé aszinkron módon fog-e történni (az alapértelmezett érték a true). Összességében ez a paraméter határozza meg az AJAX hívás opcióit. A példánkban az első paraméterben átadott címet hívjuk meg HTTP GET paranccsal és a pars paraméterben megadott paraméterlistát kapja meg, majd az Ajax.Request objektum a showResponse függvényt fogja meghívni miután megérkezett a válasz a kérésünkre. Mint ahogy ismeretes, az XMLHttpRequest folyamatosan jelzi a HTTP kérés állapotát. Ez az állapot négy különböző esetet takar: Loading, Loaded, Interactive, vagy Complete. Megmondhatod az Ajax.Request objektumnak, hogy hívjon meg egy adott függvényt valamilyen állapot elérésekor, ezek közül a Complete a leggyakrabban használt. Ahhoz, hogy az objektum tudja milyen függvényt kell meghívnia az állapot elérésekor, egyszerűen az onXXXXX tulajdonságon keresztül lehet megadni számára, mint ahogy a fenti példában az onComplete szerepel. Ez a függvény egy paramétert fog megkapni, ami maga az XMLHttpRequest objektum lesz. Ezt az objektumot tudod arra használni, hogy kinyerd a visszakapott választ vagy éppen leellenőrizd a status tulajdonságot, ami a HTTP kérés válaszkódja. Van még két másik érdekes opció az eredmények feldolgozásához. Meg tudunk adni a onSuccess paraméterben egy függvényt amit sikeres AJAX hívás esetén fog meghívni, míg az onFailure tulajdonságon keresztül olyan függvényt, amit akkor hív meg, ha szerveroldali hiba történt. Az onXXXXX opciókhoz hasonlóan ezek is az XMLHttpRequest objektumot fogják megkapni egyetlen paraméterként. Az 1.4.0-s verzióban egy újfajta eseménykezelés került bevezetésre. Ha van olyan kódod amit mindig le kellene futtatni egy adott esemény kiváltódásakor, függetlenül attól, hogy melyik AJAX kérés váltotta azt ki, akkor az új Ajax.Responders objektumot tudod használni. Tegyük fel, hogy szeretnél valamiféle látványelemet használni arra, hogy a felhasználó felé jelezd azt, hogy az AJAX hívás folyamatban van. Ekkor két globális eseménykezelőt tudsz használni, az egyik megjeleníti az ikont az első hívás kezdetén, a másik pedig elrejtni amikor az utolsó válasz is megérkezett.
Na de lássuk a példát.
<script> var myGlobalHandlers = { onCreate: function(){ Element.show('systemWorking'); }, onComplete: function() { if(Ajax.activeRequestCount == 0){ Element.hide('systemWorking'); } } }; Ajax.Responders.register(myGlobalHandlers); </script>
Az eddigi példákban nem dolgoztuk fel a kapott XML választ, hanem csak egyszerűen beraktuk egy szövegdobozba. Valós környezetben először ki kell nyerni az értékes információt belőle majd néhány elemet az oldalon módosítani, vagy esetleg XSLT transzformáció segítségével HTML kimenetet produkálunk az oldal számára.
Erről bővebben az Ajax.Request és az options referenciákbál találhatsz.
Az Ajax.Updater osztály használata
Ha esetleg a szerver már HTML formában küldi a választ a kérésre, akkor a könyvtár Ajax.Updater osztályával könnyebbé teheti az életedet, hiszen ennek csak meg kell mondanod, hogy melyik elemet szeretnéd feltölteni az AJAX hívásra kapott HTML válasszal. De a példa beszédesebb, mint ahogy le tudnám írni.
<script> function getHTML() { var url = 'http://yourserver/app/getSomeHTML'; var pars = 'someParameter=ABC'; var myAjax = new Ajax.Updater( 'placeholder', url, { method: 'get', parameters: pars }); } </script> <input type=button value=GetHtml onclick="getHTML()">
Észre lehet venni, hogy a kód nagyon hasonló az eddigi példákban találhatókhoz az onComplete függvény megadásának kivételével illetve a konstruktorban található elemazonosítóval. Na de változtassunk egy kicsit a kódon, hogy megnézzük miként is lehet a szerveroldali hibákat lekezelni. Ehhez meg kell adnunk egy, a már fentebb leírt opciót, ez pedig az onFailure. Ezenkívül azt is meghatározzuk, hogy a megadott placeholder csak abban az esetben kerüljön feltöltésre, ha a művelet sikeres volt. Ehhez az elsőnek átadott elemazonosító paraméter helyett egy objektumot kell átadni két tulajdonsággal: success (akkor hívódik meg ha minden sikeres volt) és failure (ez pedig akkor ha gond volt). De mi most nem fogjuk használni az failure tulajdonságot, hanem az onFailure tulajdonságban megadjuk a reportError függvényt.
<script> function getHTML() { var url = 'http://yourserver/app/getSomeHTML'; var pars = 'someParameter=ABC'; var myAjax = new Ajax.Updater( {success: 'placeholder'}, url, { method: 'get', parameters: pars, onFailure: reportError }); } function reportError(request) { alert('Bocsi, ez nem jött össze.'); } </script> <input type=button value=GetHtml onclick="getHTML()">
De akkor sem kell pánikba esni, ha a szerver HTML formátum helyett egy JavaScript kódot ad válaszként, mert az Ajax.Updater objektum ebben az esetben kiértékeli azt. Ahhoz, hogy az objektum a választ JavaScriptként kezelje, egyszerűen a tulajdonságok listájához hozzá kell adni az evalScripts: true; paramétert utolsóként az objektum konstruktorában.
Kiterjesztések a JavaScript osztályokhoz
Az egyik módja annak, hogy a prototype.js könyvtár új funkciókat biztosít számunkra az, hogy kiterjeszti a már meglévő JavaScript osztályokat.
Kiterjesztések az Object osztályhoz
Metódus |
Típus |
Paraméter |
Leírás |
extend(destination, source)
|
Statikus
|
destination: bármilyen objektum, source: bármilyen objektum
|
Az örököltetést valósítja meg oly módon, hogy átmásolja a source összes tulajdonságát és metódusát a destination objektumba.
|
inspect(targetObj)
|
Statikus |
targetObj: bármilyen objektum
|
Szöveges, könnyen olvasható formában reprezentálja a targetObj objektumot. Ez adja meg az alapértelmezett visszatérési értékét a toString függvénynek, ha az adott objektumban nincs definiálva az inspect példánymetódus.
|
Kiterjesztések az Number osztályhoz
Metódus |
Típus |
Paraméter |
Leírás |
ToColorpart() |
Példány |
Nincs |
A számot hexadecimális formában adja vissza. Ez hasznos amikor az RGB komponenst a HTML reprezentációra akarjuk konvertálni. |
Succ() |
Példány |
Nincs |
A következő számot adja vissza, ez olyan esetben használható amikor iterátor van.
|
Times(iterator) |
Példány |
Iterator:egy Function(value,index) függvény objektum |
Meghívja az iterator függvényt folyamatosan átadva neki a value és index paramétereket, ami az iterátor jelenlegi értékét és a aktuális indexét tartalmazza.
|
Kiterjesztések a Function osztályhoz
Metódus |
Típus |
Paraméter |
Leírás |
Bind(object) |
Példány |
Object: az objektum amely tartalmazza a metódust |
Visszadja egy példányát a függvénynek a függvényt(= metódust) tartalmazó objektumból. A visszaadott függvénynek ugyanazon argumentumai lesznek, mint az eredetinek volt.
|
BindAsEventListener |
Példány |
Object: objektum ami tartalmazza a metódust
|
Visszadja egy példányát a függvénynek a függvényt(= metódust) tartalmazó objektumból. A visszaadott függvénynek az adott event objektum lesz a paramétere.
|
Kiterjesztészek a String osztályhoz
Metódus |
Típus |
Paraméter |
Leírás |
stripTags() |
példány |
nincs |
Visszaadja a szöveget HTML és XML tagok közül |
stripScripts() |
példány |
nincs |
Visszaadja a szöveget <script/> blokkok nélkül |
escapeHTML() |
példány |
nincs |
Visszaadja a szöveget a HTML karakterek eszképelése után |
unescapeHTML() |
példány |
nincs |
Az escapeHTML() fordítottja |
extractScripts() |
példány |
nincs |
Egy Array objektumot ad vissza, ami tartalmazza a szövegben található összes <script /> blokkot. |
evalScript() |
példány |
nincs |
Kiértékeli a szövegben az összes<script/> blokkot |
toQueryParams() |
példány |
nincs |
A paraméterlistát szétválasztja egy asszociatív tömbbe ami a paraméter neve által van indexelve. |
ParseQuery() |
példány |
nincs |
Ugyanaz, mint a toQueryParams(). |
toArray() |
példány |
nincs |
A szöveg karaktereit szétválasztja egy tömbbe. |
Camelize() |
példány |
nincs |
Egy kötöjellel elválasztott szöveget camelCase formára konvertál. Ez nagyon hasznos lehet, ha olyan kódot írunk ami stílus tulajdonságokat használ. |
Kiterjesztések az Array osztályhoz
Metódus |
Típus |
Paraméter |
Leírás |
Clear() |
példány |
Nincs |
Kiüríti a tömböt és visszaadja magát a tömböt.
|
First() |
példány |
Nincs |
Visszaadja a tömb első elemét |
Last() |
példány |
Nincs |
Visszaadja a tömp utolsó elemét |
Compact() |
példány |
Nincs |
Visszaadja a tömböt azon elemek nélkül melyekben null vagy undefined szerepel. Ez a metódus nem változtaja meg magát a tömböt. |
Flatten() |
példány |
Nincs |
Egy dimenziós tömböt ad vissza úgy, hogy rekurzívan végigmegy az elemeken és azok amelyek tömböt tartalmaznak, szintén belekerülnek a visszaadott tömbbe. |
without(value1 [, value2 [, .. valueN]]) |
példány |
value1 ... valueN: értékek amelyeket ki kell venni a tömbből |
Visszaadja a paraméterekben megadott értékek nélküli tömbböt. |
indexOf(value) |
példány |
value: az érték amit keresünk. |
Visszaadja a pozícióját annak az elemnek ami tartalmazza a megadott value értékét. Az eredmény -1 lesz ha a value nem található. |
Reverse([applyToSelf |
példány |
applyToSelf: azt jelöli, hogy magát a tömböt is meg kell-e fordítani. |
Megfordítja az elemek sorrendjét a tömbben és azt adja vissza. Ha nincs paraméter megadva vagy az értéke true, akkor magát a tömbböt is megfordítja. Egyéb esetben változatlan marad. |
Shift() |
példány |
Nincs |
Visszaadja az első elemet és kiveszi a tömbből, így annak mérete eggyel csökken |
Inspect() |
példány |
nincs |
Szövegesen formázott formában adja vissza a tömb elemeit. |
Kiterjesztések a dokumentum DOM osztályhoz
Metódus |
Típus |
Paraméterek |
Leírás |
getElementsByClassName(Classname[,paramentElement]) |
Példány |
className: a CSS osztály neve, parentElement: objektum vagy elemazonosító mely a keresett elemeket tartalmazhatja |
Visszaadja az összes olyan elemet amely kapcsolatban van a megadott CSS osztállyal. Ha nincs parentElement megadva, akkor az egész dokumentumban keres. |
A Prototype.js által definiált új objektumok és függvények
A másik út amin keresztül a a könyvtár segít neked, hogy sok olyan objektumot tartamaz amely egyrészt segíti az objektumorientált tervezést, másrészt pedig közös funkcionalitásokat tartalmaz.
A PeriodicalExecuter objektum
Az objektum arra szolgáltat logikát, hogy adott időközönként egy függvényt folyamatosan meg tudjunk hívni.
Metódus |
Típus |
Paraméterek |
Leírás |
[ctor](callback,interval) |
Konstruktor |
Callback: egy paraméter nélküli függvény, interval: másodpercek száma. |
Létrehozza egy példányát az objektumnak, ami a függvényt folyamatosan előhívja. |
Tulajdonság |
Típus |
Leírás |
Callback |
Function() |
A mehívandó függvény, nem fog semmilyen paramétert átadni neki. |
Frequency |
Number |
Az intervallum másodpercekben |
CurrentlyExecuting |
Boolean |
Azt jelszi, hogy a függvény fut-e |
Az Enumerable objektum
Az Enumerable objektum segítségével sokkal elegánsabb kódot lehet írni elemek iterálására egy listaszerű struktúrában. Sok egyéb objektum terjeszti ki az Enumerable objektumot.
Metódus |
Típus |
Paraméterek |
Leírás |
Each(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Az adott iterátor meghívja a függvényt átadva neki az első paraméterben az adott elemet a listában, a második paraméterben pedig az elem indexét. |
All([iterator]) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Ez a függvény arra jó, hogy tesztüljük az egész gyüjteményt az adott függvény használatával. Az all false értéket ad vissza, ha az iterator függvény false vagy null értéket ad vissza bármelyik elemre. Egyébként pedig true lesz a visszatérési értéke. Ha nincs iterátor megadva, akkor magán az elemen vizsgálja meg a false vagy null értéket. egy függvény |
Any(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Ez a függvény arra jó, hogy tesztüljük az egész gyüjteményt az adott függvény használatával. Az any true értéket ad vissza, ha az iterator függvény nem false vagy null értéket ad vissza bármelyik elemre.Egyébként pedig false lesz a visszatérési értéke. Ha nincs iterátor megadva, akkor magán az elemen vizsgálja meg hogy az értéke más-e mint false vagy null. |
Collect(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Meghívja az iterator függvényt minden egyes elemre és minden eredményt egy tömbben ad vissza a megfelelő sorrendben. |
Detect(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Meghívja az iterator függvényt minden egyes elemre és az első olyan elemmel fog visszatérni aminél az iterator függvény visszatérési értéke true (vagy pontosabban nem false). Ha nincs ilyen elem, akkor a detectnull értéket fog visszaadni. |
Entries() |
Példány |
nincs |
Ugyanaz, mint a toArray(). |
Find(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Ugyanaz, mint a detect() |
findAll(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Meghívja az iterator függvényt minden egyes elemre és egy tömbben visszaadja mindazokat, amelyeknél az iterátor függvény visszatérési értéke true volt. Ez a függvény a reject() ellentéte. |
Grep(pattern [,iterator]) |
Példány |
pattern: egy RegExp objektum ami az elemek kiválasztására használhatunk, iterator: egy függvény objektum Function(value,index) formában |
Az összes elemet megvizsgálja az átadott pattern ellenében. A függvény egy tömbben fogja visszaadni azokat az elemeket, melyek megfeleltek a reguláris kifejezésnek. Ha az iterator meg van adva, akkor a visszaadott tömb a hívás eredményeit fogja tartalmazni minden egyes elemre amit megfelelt a kifejezésnek. |
Include(obj) |
Példány |
obj: bármilyen objektum |
Megpróbálja megkeresni az adott objektumot a gyűjteményben. True lesz a visszatérési értéke ha megtalálta, egyébként pedig false. |
Inject(initialValue,iterator) |
Példány |
initialValue: bármilyen objektum ami inicializáló értékként felhasználható, iterator: egy függvény objektum Function(value,index) formában |
Összeköti az összes elemet az iterator függvény segítésével. Az iterátort az előző iteráció eredményével hívja meg az accumulator paraméterben. Az első iteráció az initialValue értékét veszi az accumulator paraméterben. A visszatérési érték az utolsó hívás eredménye lesz. |
Invoke(methodName [,arg1 [,arg2 [….]]) |
Példány |
methodName: a metódus nevet ami minde egyes elemre meg lesz hívva, arg1..argN: argumentumok, melyek a metódusnak át lesznek adva. |
A megadott metódust meghívja minden egyes elemre átadva neki az adott paramétereket (arg1 to argN), a visszatérési érték pedig a függvényhívások eredménye lesz egy tömbben. |
Map(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Ugyanaz, mint a collect() |
Max([iterator]) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
A legnagyobb értékű elemet adja vissza a gyűjteményben vagy a legnagyobb eredéményét az iterátorhívásoknak, ha az iterator meg volt adva. |
Min([iterator]) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
A legkisebb értékű elemet adja vissza a gyűjteményben vagy a legkisebb eredéményét az iterátorhívásoknak, ha az iterator meg volt adva. |
Partition([iterator]) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Egy tömbböt fog visszaadni amely másik két tömbböt tartalmaz. Az első az összes olyan elemet tartalmazza, melyen az iterátorhívás true eredményt produkált, a másikban pedig a többi elem lesz. Ha az iterator nem volt megadva, akkor az első tömbben azon elemek lesznek, melyek true értéket produkálnak, a másikban pedig értelemszerűen a többi elem lesz. |
Pluck(propertyName) |
Példány |
propertyName: a tulajdonság neve, melzet minden elemből ki kell olvasni. Név helyett tartalmazhatja a tulajdonság indexét is. |
Egy tömbben az adott tulajdonság értékeit adja vissza minden egyes elemből. |
Reject(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Meghívja az iterator függvényt minden egyes elemre és egy tömbben visszaadja mindazokat, amelyeknél az iterátor függvény visszatérési értéke false volt. Ez a függvény a findAll() ellentéte. |
Select(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Ugyanaz mint a findAll(). |
sortBy(iterator) |
Példány |
iterator: egy függvény objetum Function(value, index) formában |
Az elemeket sorbarendezve egy tömbben fogja visszaadni a függvényhívás eredményétől függően. |
ToArray() |
Példány |
nincs |
Egy tömbben adja vissza a gyűjtemény összes elemét. |
zip(collection1[,collection2 [,...collectionN[,transform]]]) |
Példány |
collection1 .. collectionN: enumerációk az egyesítéshez, transform: egy függvény objektum Function(value, index) formában |
Összevonja az adott gyűjteményeket az eredeti gyűjteménnyel. Az eredménye egy új tömb lesz, amiben az elemek száma megegyezik az eredetiével és minden egyes elem egy újabb tömb. Ha a transform függvény meg van adva, akkor a belső tömbbök a visszatérés előtt ezzel lesznek feldolgozva. Egy gyors példa: [1,2,3].zip([4,5,6], [7,8,9]).inspect() visszatérési értéke "[[1,4,7],[2,5,8],[3,6,9] ]" |
A Hash objektum
A Hash objektum egy hash struktúrát implementál, azaz Kulcs:Érték párosok gyűjteménye. Minden elem a Hash objektumban egy tümb két elemmel: az első a kulcs, a másik pedig az érték. Minden elemnek két tulajdonsága van: a key és a value.
Metódus |
Típus |
Paraméterek |
Leírás |
Keys() |
példány |
Nincs |
Egy tömbben visszaadja az elemek kulcsait. |
Values() |
példány |
Nincs |
Egy tömbben visszaadja az elemek értékeit |
Merget(otherHash) |
példány |
otherHash:Hash objektum |
Az adott has objektumot összevonja az átadott hash objektummal és egy új hash objektumot fog visszaadni. |
toQueryString() |
példány |
Nincs |
Az öszes elemet a hash objektumban szöveges formában fogja visszaadni, 'key1=value1&key2=value2&key3=value3' |
Inspect() |
példány |
nincs |
Szintén egy jól formázott szövegként adja vissza a hash kulcs:érték párosait. |
Az ObjectRange osztály
Az Enumerable osztályból származik.
Értékek sorozatát reprezentája alsó és felső határokkal.
Tulajdonság |
Típus |
Kind |
Leírás |
|||
Start |
(bármi) |
példány |
Az alsó határa a tartománynak |
|||
end |
(bármi) |
példány |
A felső határa a tartománynak |
|||
exclusive |
Boolean |
példány |
Azt határozza meg hogy a határok beleértendőek-e a tartományba. |
|||
Metódus |
Típus |
Paraméter |
Leírás |
|||
[ctor](start, end, exclusive) |
Konstruktor |
start: az alsó határ, end: a felső határ, exclusive: a határok benne lesznek a tartományban |
Egy tartományt hoz létre, kezdve a start paramétertől az end paraméter értékéig. Fontos megjegyezni, hogy a start és end objektumoknak ugyanolyan típusnak kell lennie és kell definiálniuk egy succ() metódust. |
|||
include(searchedValue) |
példány |
searchedValue: a keresett érték |
Megvizsgálja, hogy az adott értéket tartalmazza-e a tartomány. A visszatérési érték true vagy false lehet. |
A Class objektum
A Class objektum más osztályok deklarálásakor használatos a könyvtárban. Ennek az objektumnak a használatával egy osztály deklarációjánál azt érjük el, hogy támogatni fogja az initialize() metódust, amely konstruktorként működik.
Lássunk egy példát:
//deklaráljuk az osztályt// var MySampleClass = Class.create(); //implementáljuk magát az osztályt MySampleClass.prototype = { initialize: function(message) { this.message = message; }, showMessage: function(ajaxResponse) { alert(this.message); } }; //most pedig példányosítsuk// var myTalker = new MySampleClass('hi there.'); myTalker.showMessage(); //mutassuk meg az üzenetet///
Az Ajax.Base osztály
Ez az osztály szolgál alaposztályul a legtöbb osztályhoz az Ajax objektumban.
Metódus |
Típus |
Paraméterek |
Leírás |
setOptions(options) |
példány |
Option: ajax opció |
Beállítja a kívánt opciókat az ajax művelethet |
responseIsSuccess() |
példány |
Nincs |
True lesz a visszatérési értéke, ha az AJAX művelet sikerest volt, egyébként pedig false |
responseIsFailure() |
példány |
Nincs |
Ellentetje a responseIsSucces() metódusnak |
Az Ajax.Request osztály
Az ajax.base osztályból származik. Összefoglalja az AJAX műveleteket.
Tulajdonság |
Típus |
Kind |
leírás |
Events |
Array |
Statikus |
A lehetséges események/állapotok listája egy AJAX művelethez. A lista értékei: 'Uninitialized', 'Loading', 'Loaded', 'Interactive', és 'Complete.' |
Transport |
XMLHttpRequest |
Példány |
Az XMLHttpRequest objektum ami tartalmazz az AJAX műveletet |
url |
String |
Példány |
A kéréshez tartozó URL |
Metódus |
Típus |
Paraméterek |
Leírás |
[ctor](url, options) |
példány |
url: a hívandó url, options: AJAX opciók |
Létrehozza az adott objektum egy példányát amivel meg fogja hívni az adott url-t a megadott opciókkal. Az onCreate esemény ki fog váltódni a konstruktor hívásaközben. |
AJAX opciók
Metódus |
Típus |
Alapérték |
Leírás |
Method |
String |
’post’ |
A http kérés módja |
Parameters |
String |
” |
url-formázott listája az kérésben átadandó értékeknek |
Asynchronous |
Boolean |
True |
Azt jelzi, hogy az AJAX hívást asszinkron módon kell-e végezni |
postBody |
String |
|
Content passed to in the request's body in case of a HTTP POST |
RequestHeaders |
Array |
|
A hívásban átadandó http fejlécek listája. Az elemek számának párosnak kell lennie, minden páratlan elem egy fejléc elem nevét tartalmazza, az azt követő értéknek pedig az értéknekszöveges formában. Például:['myheader1', 'this is the value', 'myother-header', 'another value'] |
onXXXXXXXX |
Function(XMLHttpRequest) |
|
Egyedi függvény ami a megfelelő esemény/státusz elérésekor hívódik meg az AJAX hívás során. A függvény egy paramétert fog kapni, ami az XMLHttpRequest objektumot tartalmazza. |
onSucces |
Function(XMLHttpRequest) |
|
Egyedi függvény ami a az AJAX hívás sikeres befejezésekor hívódik meg. A függvény egy paramétert fog kapni, ami az XMLHttpRequest objektumot tartalmazza. |
onFailure |
Function(XMLHttpRequest) |
|
Egyedi függvény ami a az AJAX hívás sikertelen befejezésekor hívódik meg. A függvény egy paramétert fog kapni, ami az XMLHttpRequest objektumot tartalmazza. |
Insertion |
Function(Object, String) |
Null |
Olyan függvény amely a visszaadott szöveget beszúrja egy adott elembe. Két paramétere van, az elsőben a frissítendő elemet, mint objektumot kell átadni, míg a másodikban a szöveget. Csak az Ajax.Updater objektummal használható. |
evalScript |
Boolean |
False |
Azt határozza meg, hogy a válasz érkezésekor ki kell-e értékelni a szkript blokkot. Csak az Ajax.Updater objektummal használható. |
decay |
number |
1 |
Meghatározza a folyamatos lelassulást(növekedést) az Ajax.PeriodicalUpdater objektum frissítési gyakoriságában amikor az utolsó válasz azonos az előzőével. Például ha 2 a beállított érték és egy frissítés után azonos válasz érkezik az előzővel, akkor az objektum kétszer annyi ideig fog várni a következő frissítéssel. Ha ez újra megismétlődik, akkor legközelebb már négyszer annyi ideig vár és így tovább. |
Form függvények
A formok függvényei.
A Field objektum
Metódus |
Típus |
Paraméterek |
Leírás |
clear(field1 [, field2[, field3 [...]]]) |
Példány |
fieldN: a beviteli mező azonosítója vagy maga az mező |
Az összes átadott mező értékét kitörli. |
present(field1 [,field2 [, field3 [...]]]) |
Példány |
fieldN: a beviteli mező azonosítója vagy maga az mező |
true lesz a visszatérési értéke ha mindegyik mező tartalmaz valamilyen értéket(nem üres). |
focus(field) |
Példány |
fieldN: a beviteli mező azonosítója vagy maga az mező |
A fókuszt az adott mezőre állítja. |
select(field) |
Példány |
fieldN: a beviteli mező azonosítója vagy maga az mező |
Kijelöli az értéket a mezőben ha az támogatja a szövegkijelölést. |
activate(field) |
Példány |
fieldN: a beviteli mező azonosítója vagy maga az mező |
A fókuszt az adott mezőre állítja és kijelöli az értéket a mezőben ha az támogatja a szövegkijelölést. |
A form Objektum
Metódus |
Típus |
Paraméterek |
Leírás |
Serialize(form) |
példány |
form: az űrlap azonosítója vagy maga az űrlap |
a mezők neveit és azok értékeit egy urlformázott formában adja vissza, pl. 'field1=value1&field2=value2&field3=value3 |
findFirstElement(form) |
példány |
form: az űrlap azonosítója vagy maga az űrlap |
Visszaadja az első engedélyezett mezőt az űrlapon. |
getElements(form) |
példány |
form: az űrlap azonosítója vagy maga az űrlap |
Egy tömbben adja vissza az összes beviteli mezőt az űrlapon belül. |
getInputs(form [,typeName [, name]]) |
példány |
form: az űrlap azonosítója vagy maga az űrlap |
Egy tömböt ad vissza, ami tartalmazz az összes <input> elemet az űrlapon. Opcinálisan a lista szűrhető a megadott type vagy name paraméter segítségével. |
Disable(form) |
példány |
form: az űrlap azonosítója vagy maga az űrlap |
Letiltja az összes bevizeli mezőt az űrlapon belül. |
Enable(form) |
példány |
form: az űrlap azonosítója vagy maga az űrlap |
Engedélyezi az összes bevizeli mezőt az űrlapon belül. |
focusFirstElement(form) |
példány |
form: az űrlap azonosítója vagy maga az űrlap |
Activates the first visible, enabled input field in the form. |
Reset(form) |
példány |
form: az űrlap azonosítója vagy maga az űrlap |
Visszaállítja az eredeti értékeket az űrlapon. Ugyanazt mint a reset() metódos hívása a form objektumon. |
Form.Element osztály
Metódus |
Típus |
Paraméterek |
Leírás |
Serialize(element) |
Példány |
element: elemazonosító vagy maga az elem |
Az elemet egy név=érték páros formájában adja vissza, pl. 'elementName=elementValue' |
getValue(element) |
Példány |
element: elemazonosító vagy maga az elem |
Visszaadja az elem értékét |
A Form.Element.Serializers objektum
Az objektum pár olyan hasznos függvényt tartalmaz, amely segíti az űrlap elemek aktuális értékének kinyerését.
Metódus |
Típus |
Paraméterek |
Leírás |
inputSelector(element) |
példány |
element: objektum vagy az azonosítója egy olyan űrlap elemnek, melynek van checked tulajdonsága, ilyen például a radio button vagy a checkbox. |
Egy tömböt ad vissza az elem nevével és értékével, pl.['elementName','elementValue'] |
textarea(element) |
példány |
element: objektum vagy az azonosítója egy olyan űrlap elemnek, melynek van value tulajdonsága, ilyen például a textbox, button vagy a password. |
Egy tömböt ad vissza az elem nevével és értékével, pl.['elementName','elementValue'] |
select(element) |
példány |
element: objektum vagy az azonosítója egy <select> elemnek |
Egy tömböt ad vissza az elem nevével és az összes kiválasztott opció értékével vagy szövegével, pl. ['elementName', 'selOpt1 selOpt4 selOpt9'] |
Forrás anyagok
Források:
- http://www.prototypedoc.com/
- http://beta.bigmedium.com/bm~doc/prototype-151-api.pdf
- http://www.maxkiesler.com/index.php/search/results/2dbb93bd8aeff0d9feb5f0cf0f39631e/
Letölthető AJAX scriptek:
Letölthető függvény-könyvtárak:
- Prototype.js letöltése: http://www.prototypejs.org/
- Dojo letöltése: http://dojotoolkit.org/
- Rico függvénytár: http://openrico.org/downloads
Ajaxxal foglalkozó fórum: http://www.prog.hu/kereses/?expr=ajax&oc=20
Kapcsolódó irodalmak:
- Steve Holzner – Ajax for Dummies
- Nicholas C. Zakas & Jeremy McPeakand & Joe Fawcett – Professional Ajax
- Ryan Asleson and Nathaniel T. Schutta – Fundations of Ajax