Използване на xajax

xajax е свободна библиотека под GNU Lesser General Public License. Всеки може да си я свали от следния адрес: http://www.xajaxproject.org/. Цялата документация на проекта се намира на същия адрес.

За създаване на апликация с xajax са нужни винаги 3 файла.

file.server.php
- файлът който играе ролята на сървър и обработва подадените данни във вид на функции

file.common.php
- файлът, който регистрира функциите и инклудира сървъра

action.php
- файлът, който показва информацията и задвижва всичко

Накратко да обясня примера, които ще разработим в този урок. Нека имаме едно текстово поле, в което искаме да въвеждаме даден език Bulgarian, English, German ..., но тъй като всеки би трябвало да въвежда винаги стандартни стойности, нашата система ще извежда препоръчителни езици, докато потрбителят въведе точния език.

Първийт файл textfile.php съдържа нашия HTML документ с текстовото поле.

CODE

1 2 3 4 5 6 7 8 9 10 11

<?PHP require("textfield.common.php"); $xajax->printJavascript('../ajax/'); ?> <table width="400" border="0" cellspacing="0" cellpadding="0">   <tr>     <td width="254"><input type="text" name="country" id="country"  onKeyUp="xajax_getCountries(document.getElementById('country').value);return false;"/>     <div id="myCountries" ></div>     </td>   </tr> </table>

В началото инклудираме свързващия файл textfield.common.php, който ще обясним по-долу. След това извикваме метода printJavaScript с параметър пътя до основната директория на xajax библиотеките, който извежда необходимите JavaScript функции за транспорта на данните. Но с тези функции няма нужда да се занимаваме.

Следва един HTML документ с едно текстово поле и един празен DIV елемент, в който по-късно ще се показват предложенията на езиците. Основното действие извършва функцията xajax_getCountries() при onKeyUp в текстовото поле. Т.е като пуснете клавиша, функцията ще изпрати определени данни към сървъра, при което ще се извърши някакво действие върху страницата. В нашия случай действието е зареждане на езици, който съвпадат с въведеното от потребителя, буква по буква. Важното тук е, че всяка функция, която сте създали и искате да извикате, трябва да напишете преди това xajax_. Това е просто стандарт.



Файлът textfield.common.php е най-простият по структура, но е един от най-важните, тъй като той прави връзката между клиента и сървъра.

CODE

1 2 3 4 5 6

<?PHP require_once ($DOCUMENT_ROOT."/ajax/xajax.inc.php"); $xajax = new xajax("textfield.server.php"); $xajax->registerFunction("getCountries"); ?>

В него се създава обект на класа xajax, като като параметър на конструктора се предава файлът, играещ ролята на сървър. Следващото, което се прави е регистрирането на функциите, който ще обработват данните. В нашия случай имаме само една функция и това е getCountries.