AJAX-enabled Smarty plugins Part 2: ajax_form

Feb 21
2006 09:47 (AJAX, Development, JavaScript, PHP) · Русский (30,462 views)

In my previous post I’ve described several simple AJAX plugins. Now I’ll show how to use one of them — ajax_form — in real applications. I think this is the most powerful plugin therefor I’ll dwell on it more elaborately.

Most of Web-forms has variuos validation mechanisms. Simplest way is to process form on the server and parse result on client, where return data can be in following format:

true;User was registered successfully;http://example.com/login/ false;Please enter your name;Entered passwords doesn't match

Result string can be splitted on client and results can be shown in some part of page. Process function may looks like following (it’s part of smarty_ajax):

var SmartyAjax = {
  onSubmit: function(originalRequest) {
    var results = originalRequest.responseText.split(";");

    if (results[0] == "true") {
      SmartyAjax.Messages.set(results[1],
        SmartyAjax.Messages.MT_WARNING)
    } else {
      SmartyAjax.Messages.clear();
      SmartyAjax.Messages.setType(SmartyAjax.Messages.MT_ERROR);
      for (var i = 1; i < results.length; i++) {
        SmartyAjax.Messages.add(results[i]);
      }
    }
  }
}

This function uses several functions from SmartyAjax.Messages object which depends on following HTML elements:

<div id="messages">
  <p id="messages-title"></p>
  <ul id="messages-list"></ul>
</div>

To manage messages I’ve created Smarty template parts/warnings.tpl. You can use it in your PHP file in simple way:

// is messages contains warning (or error)
$t->assign('messages_warning', true);
// array of messages
$t->assign('messages', array('Please provide your account information'));

Another thing we need to examine is message which informs user about processing AJAX request. There is SmartyAjax.Process object in the sample which has two methods: hide() and show() which can be used to hide and display message. They are depends on HTML-element with id=”ajax-process”. It’s necessary to add “position: absolute” style because of this messages will be shown in top-right corner of screen independing on scroll position.

ajax_form is simple to use:

{ajax_form method="post" id="form_register"}
Any form-element can be placed here
{/ajax_form}

Possible parameters:

  • url - URL for AJAX-query (when no URL was specified current one will be used)
  • method - query method (by default get, can be get or post)
  • params - URL-encoded parameters
  • id - form ID
  • callback - JavaScript function which will be called when query will be completed

Example can be found here, and full sources can be downloaded here.

49 Responses to 'AJAX-enabled Smarty plugins Part 2: ajax_form'

Subscribe to comments with RSS or TrackBack to 'AJAX-enabled Smarty plugins Part 2: ajax_form'.

1
said on 2006-02-22 at 12.52 pm

Мне кажется, что такие вещи существенно облегчат написание кода многим программистам. По этому было бы не плохо развивать и далее связку Smarty+AJAX. Так держать!

2
erka
said on 2006-02-23 at 10.41 am

Есть вопросы:

  1. в либе используешь - originalRequest.responseText. вообще существуют ли какие-то предпочтения, когда лучше использовать originalRequest.responseText, а когда - originalRequest.responseXML
  2. столкнулся как-то с проблемой. может у кого время будет :) сам правда поленился искать почему-то. Вообще, есть страничка, а мы ходим через Ajax достать страничку с другого сервака. IE - чудно все делает, Mozilla/NetScape - решается установлением привелегий netscape.security.PrivilegeManager.enablePrivilege(”UniversalBrowserRead”);. Opera - молчит.

И еще. Прости Критик, что пишу не по теме, но все же. “Мне кажется, что такие вещи существенно облегчат написание кода многим программистам.” - что за фраза? что-то от нее несет каким-то популизмом или чем-то в этом роде.

3
said on 2006-02-23 at 10.57 am

1. Response can be a simple text string or an XML document DOM (Document Object Model). The two request object response properties you will use for working with a response are responseText and responseXML. The DOM object stored in responseXML is a completely accessible DOM that can be manipulated and traversed in the same way that your HTML document can be. The responseText property is used when a simple text string is sent by the server.

2. About cross-domain AJAX you can look at following:
http://benlog.com/articles/2006/02/14/cross-domain-ajax
http://benlog.com/articles/2006/02/15/cross-domain-ajax-2
http://getahead.ltd.uk/ajax/cross-domain-xhr

4
said on 2006-02-23 at 11.13 am

Erka, это никакой не популизм, а мое личное мнение. Мне кажется, что с помощью такой технологии проще, например, проверить вводимые данные на стороне клиента, да и работает шустренько.

А на счет того, что “облегчат написание кода многим программистам”, так все мы знаем, что программисты ЛЕНИВЫ, а вот заюзать “под себя” то, что не поленился сделать другой программист за нас всегда приятно :). Тем более, что довольно-таки полезная вещь.

5
said on 2006-03-15 at 5.58 pm

Можно ли как-то обойти проблему с кодировкой кирилицы без кодирования контента Ajax-сервером при его отдачы ? У меня в Опере все нормально, а IE выводит непонятніе символы

6
said on 2006-03-15 at 6.12 pm

Можете сказать, какую кодировку Вы используете и какая версия PHP установлена на сервере?

7
said on 2006-03-15 at 6.19 pm

Спасибо за ответ, Дмитрий!
Apache/1.3.31
PHP 4.2.2

Получаеться меняю тестовый Ваш шаблон about.tpl, добавляю туда рус. текст, при просмотре “About” с Вашего примера в Опере все нормально, а в ИЕ непонятные символы. Я думал iconv в Юникод перекодировать, но еще хуже :(
P.S: Может у меня что-то с ПХП?

8
said on 2006-03-15 at 6.30 pm

Нет, с PHP у Вас все в порядке :-) Во-первых, вы нашли небольшой баг в моих примерах. В page.tpl в строке

<meta http-equiv="Content-Type" content="text/html; charset={$lang.charset}" />

{$lang.charset} следует заменить на Вашу кодировку, например так:

<meta http-equiv="Content-Type" content="text/html; charset=windows-1251" />

Теперь русский отображается нормально, но AJAX-запросы возвращают текст в неправильной кодировке (по умолчанию UTF-8). Все, что нужно, это указать правильную кодировку страницы в response. Это можно сделать так (index.php):

function update_intro() {
  global $t;
  header('Content-Type: text/html; charset=windows-1251');
  $t->display('introduction/' . $_GET['page'] . '.tpl');
}

Я обновил примеры на сайте, теперь в about добавлена фраза на русском.

9
said on 2006-03-15 at 7.01 pm

Дмитрий, спасибо большое!
Все получилось ;)

10
said on 2006-03-15 at 7.03 pm

Всегда рад помочь :-)

11
said on 2006-03-16 at 3.48 am

Хорошие примеры. Будем использовать, и впоследствии расширять. Спасибо.

12
Sokol
said on 2006-03-21 at 2.12 pm

Меня заинтересовал вопрос об “responseText или responseXML”.
XML - хороший способ сохранить или передать структурированые данные, но есть еще одна альтернатива - JSON (Javascript Object Notation) http://www.json.org, советую посмотреть http://www.json.org/xml.html где сравниваются обе технологии.
JSON позволяет передавать переменные и даже целые обьекты из одного языка в другой, например:

PHP file

$fooArray = array('uname'=>'Sokol', 'uemail'=>'xxx@xxx.com');
print $json->encode($fooArray); // Convert php to json
// Output: {"uname":"Sokol", "uemail":"xxx@xxx.com"}

HTML file

var fooArray = eval('('+request.responseText+')');
alert('User name: '+fooArray.uname+' Email: '+fooArray.uemail);

В отличии от XML здесь не нужно ничего парсить и к тому же данные в JSON формате занимают меньше места чем в XML.
Надеюсь мои комментарии окажутся полезными.

13
said on 2006-03-21 at 2.18 pm

Большое спасибо за комментарий

Я уже давно присматриваюсь к этой технологии (в частности к ее реализации в Zend Framework - классу Zend_Json). Но все руки никак не дойдут хорошенько разобраться :-)

14
Mack
said on 2006-03-23 at 5.57 pm

Пользуемся технологией типа ajax с dklab.ru она куда гибче и кроссплатформенее , легче в понимании…
всё прекрасно отрабатывается удаленно и в Opera и в MSIE и в FireFox, сам 2 минуты назад проверил

15
said on 2006-03-23 at 7.03 pm

dklab действительно предложили интересный вариант использования технологии асинхронных запросов. Но я бы поспорил по поводу удобства использования, легкости понимания и особенно перспектив. Ведь до сих пор ни один браузер не имеет нормальной поддержки CSS, почему же многие стараются использовать эту технологию, а не таблицы? В общем это все флейм, в любом случае спасибо за ссылку.

16
Mack
said on 2006-03-24 at 10.36 am

Может это и флейм :) но…
Конечно AJAX поддерживают IBM, SUN и т.п. фирмы, что сразу за собой тянет развитие технологии… но честно говоря реализация dklab проще все же (может для меня и dklab : токо ), как говорят “всё гениальное просто”
по легкости…. ну не знаю, прочтя статью в конце я уже всему научился (потому что сам долгое время шел к этому (разрабатывал))… еще час потратил на js библиотечку и всё - у меня есть универсальный инструмент… простой и самое главное отлично работающий и самое главное кроссбраузерный!
И использовать надо то кому нравиться, можно использовать zend framework а можно писать свои классы, главное не зацикливать тогда прогресса не будет и т.п. Просто я смотрел много cms все сделаны почти одинаково, что огорчает, хотя есть масса путей реализации другой архитектуры к тому же более гибкой и простой…
т.е. всегда должна быть “конкуренция” и возможность выбора…
плохо то что у dklab нет хорошего маркетинга и рекламы..
на open source тяжело зарабатывать :\

17
said on 2006-03-24 at 4.02 pm

Добрый день! Плагин просто супер! Спасибо!
Как можно пообщаться с Вами поподробнее!?
С уважением, Александр

18
David
said on 2006-03-30 at 5.00 pm

Very very nice job, I like it ! ;)

Could you post an example using the callback function ? I’m trying to call a javascript function after the request is completed but it’s called before ! I want to call a javascript function when form is completed without error to change page location, is it possible ?

Regards.

19
said on 2006-03-30 at 5.10 pm

Hello, David

You can look at chat sample in the article’s sources.
There is following construction in the template file chat.tpl:

<input type="button" value="Send" id="send" onclick="{ajax_call method="get" function="add_message" params_func="Chat.getParams" callback="Chat.onMessageSent"}">

Below this you can find JavaScript (unnecessary things are stripped out):

var Chat = {
  onMessageSent: function() {
    Field.clear("message");
    Field.focus("message");
  }
}

In this sample function onMessageSent will be called when request will be completed.

Plugin ajax_form does supports callback param too.

20
David
said on 2006-03-31 at 12.07 pm

Thanks, it works. I didn’t understand the callback function completely replaced your function “OnSubmit”.

21
David
said on 2006-04-01 at 7.16 pm

Do you thinks it’s possible to use callback with ajax_update too ? ;) I tried to add that (in the ajax_update plugin, etc) but the callback function is not called when completed… Did you tried too ?

22
Ayohmang
said on 2006-04-08 at 4.44 am

i look into ajax_update , onComplete: callback, i try to use callback too with ajax_update, but nothing triggerred after update complete, same question with David ..

23
said on 2006-08-16 at 4.07 am

[...] ・ajaxフォームの解説記事 Dmytro Shteflyuk’s Home » Blog Archive » AJAX-enabled Smarty plugins Part 2: ajax_form [...]

24
Alexander
said on 2006-11-19 at 11.03 pm

You know about XAJAX, it ‘ s a framework, who work with ajax applications
and have a link with Smarty, to answer the same prob;em, no?

25
said on 2006-11-20 at 12.49 am

Hi Alexander
I know XAJAX and used it a little, but I don’t know if it has Smarty bindings

26
Alexander
said on 2006-11-20 at 7.46 pm

Da, ya vchera prochetal ob etom, ya ne znakom s XAJAX, no sabirayus izuchat.
Menia interesuyet sviazivat Smarty s Ajax.
Nedavno scachal knigu Smarty PHP Template Programming and Applications.
Tam est tema ob kontrole obnavlenie shablona, dumaiu eto kak raz chto nada, php script.
Skazhite esli ya oshebayus.

27
Flaviy
said on 2006-11-30 at 8.56 pm

Привет document.write(”)
for (i=0; i’+window.history.previous+”)
}
document.write(”) в IE выводит одни undefined
Не знаешь че можно предпринять

28
Flaviy
said on 2006-11-30 at 8.57 pm

сорри document.write(”)
for (i=0; i’+window.history.previous+”)
}
document.write(”)

29
Flaviy
said on 2006-11-30 at 8.59 pm

скрипт не выводиться , но проблему изложил вроде ответь плз

30
said on 2006-12-02 at 9.50 am

2Flaviy: По ходу съелись тэги
Попробуй использовать &lt; вместо < и &gt; вместо >

Имеется в виду комментарий :-)

31
said on 2006-12-07 at 3.26 pm

Привет! Вопрос можно ли в инет эксплорере вывести журнал посещений с помощью JavaScript. типа window.history.previous. по форумам нашел только для нетскейпа.

33
Mihail
said on 2006-12-11 at 4.52 pm

Попробовал. Ничего не получается. Запрос вроде посылается, но до PHP точно не доходит….

34
Jek
said on 2006-12-18 at 10.26 am

Всё конечно интересно, но как заставить чат отображать записи по русски?
Буду очень благодарен за совет.

35
Linin
said on 2007-01-25 at 4.47 pm

Отличная вещь. Можно такой вопрос:
onComplete: callback -> возможно ли в функцию callback (напомню, что callback - функция JavaScript, которая будет выполнена по завершении запроса) передать объект originalRequest и уже в callback устроить “разбор полетов” с этим объектом? Заранее признателен за помощь.

36
Linin
said on 2007-01-25 at 5.45 pm

Спасибо. Ступил. В сигнатуре самой функции callback нужно написать просто
callback (originalRequest)
{
… код…
responseXml = originalRequest.responseXML;
… код …
}
, а не callback(SmartyAjax.originalRequest)
{
… код …
}

37
Mihail
said on 2007-02-01 at 1.32 am

Спасибо за отличный плагин.
Делаю сайт с использованием вашего плагина (добавил пару ф-ций, обновил Prototype до 1.5.0) и Rico 1.1.2 (http://openrico.org/rico/). Как только добавляю rico.js к страницам, ajax_form перестает работать. Processing… появляется, а запрос не идет.

Буду признателен за помощь.

38
Linin
said on 2007-02-06 at 10.07 am

Интересно, а данные из тега отправляются? Мне лично не получается передать файл на сервер.

39
Linin
said on 2007-02-06 at 10.10 am

Сорри, добавление к комментарию выше. Я имел в виду тег:

<input type="file" name="nameFile" value="" />
40
Guido Smit
said on 2007-02-12 at 2.14 pm

I like this initiative, much easier than xajax.
I tried it, but ran into a problem:

When using a pulldown, the value does not get posted back.
e.g.: [...options...]

{literal}
var getmaand = {
params: function() {
return {
showmonth: $F(”showmonth”)
}
}
}
{/literal}

Checking my php with print_r($_GET) and print_r($_POST) the month does not return.

Please advise.

41
said on 2007-02-22 at 1.04 am

Sorry, I never worked with Rico :-(

42
said on 2007-02-22 at 1.09 am

Linin, файлы невозможно загрузить, используя технологию AJAX. Для этого можно воспользоваться отправкой формы в скрытый iframe, более подробно описано здесь.

43
said on 2007-06-06 at 11.19 pm

Is there any way to incorporate $_FILE for file upload support?

44
said on 2007-08-31 at 3.10 pm

Hello Dmytro,

I’m trying to use ajax_form with the callback to change to nextpage.php if the form is OK.
The callback is called, but allways, also if the form is NOT good.
I did not understand the solution you gave to David, since that is from the chat example.
Can you help ?

I have:

function finishfunc()
{
    document.form_register.action = "nextpage.php";
    document.form_register.submit();
    return false// Is this required??
}

var finishcallback = finishfunc;

and

{ajax_form method="post" id="form_register" callback='finishcallback'}
...
{/ajax_form}

Thanks, Alexander

45
Valerij
said on 2008-01-22 at 8.37 pm

а можно прикрутить к mootools smarty ?

46
Raul
said on 2008-01-27 at 4.16 pm

Очень бы пригодилось,если бы объяснили как сделать автоматический запрос данных при смене опций в теге … а как продолжение как составить цепочку зависимых

47
Raul
said on 2008-01-27 at 4.17 pm

я имел ввиду тег select

48
AL
said on 2008-05-03 at 11.14 pm

Кто-нить может объяснить нормально, как в любой цивилизованной документации к любому плагину (например, к тому же Smarty), как использовать эти плагины?
Если полностью скачать архив и запустить - работает… Но как только начинаешь приспосабливать к своему проекту, ничего не пашет. Вообще ничего!
1. Какие файлы из Smarty нужно заменить?
2. В какие каталоги какие файлы нужно добавить?
3. Где и какие пути должны быть прописаны?
4. Где можно скачать каждый из, с позволения сказать - плагин, по отдельности?
5. Как вообще его устанавливать?
И много других вопросов. Такое ошущение, что те, кто тут обсуждают это дополнение месяц сидели, это всё писаль, а тут просто продолжают обсуждать… А где начало?
Понятно, что тут мне никто ничего не должен, но тем не менее… Возможно плагин и хорош, во всяко случае необходим однозначно, но как он приподносится - ужас!!!

49
Grassus
said on 2008-09-26 at 12.58 pm

как нужно обрабатывать параметры params
шаблон

{ajax_form method="post" id="form_register" params="opt=save"}

php-файл

if (!isset($_REQUEST['opt']))
  {$opt = 'view';}
else
  {$opt = $_REQUEST['opt'];}

у меня не передается параметр в php файл
пробывал и $_REQUEST, $_POST, $_GET

Post a comment

You can use simple HTML-formatting tags (like <a>, <ul> and others). To format your code sample use <code lang="php">$a = "hello";</code> (allowed languages are ruby, php, yaml, html, csharp, javascript). Also you could use <code>$a = "hello";</code> and its syntax would not be highlighted. If you are not using <code> tag, replace < sign with &lt;.

Submit Comment

 
Copyright © 2005 - 2008, Dmytro Shteflyuk