Добавил:
Upload Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
Ajax_v_deystvii.pdf
Скачиваний:
34
Добавлен:
05.03.2016
Размер:
5.83 Mб
Скачать

508 Часть IV. Ajax в примерах

скольку и применение преобразования, и обновление пользовательского интерфейса представляется одной строкой кода. Относительно того, какая из реализаций эффективнее — решать вам.

Итак, объект xSLTHelper готов, и у нас есть понятный, простой метод API, в который включены все действия, связанные с XSLTпреобразованиями. Данный вспомогательный объект наверняка будет'очень полезным и точно будет стоить тех усилий, которые мы в него вложили.

Атеперь вернемся к "живому" поиску и попытаемся получить компонент

спростой структурой.

т

12.6.2. Компонент "живого" поиска

Ну вот, в заднем кармане у нас припрятана удобная поддержка XSLT, и теперь мы реализуем сценарий "живого" поиска в виде компонента, который должен удовлетворять требованиям, обсуждавшимся в разделах о реструктуризации других глав. Нам требуется хороший API, возможность настройки при наличии необходимого числа значений по умолчанию, малозаметность для HTML-страницы, содержащей компонент, а также возможность использования на одной странице нескольких экземпляров компонента. Итак, разработаем понятное объектно-ориентированное решение, основным принципом которого будет инкапсуляция каждой ответственности в отдельный метод. Одна ответственность — один метод. Запомним этот принцип и начнем, как обычно, — с построения.

С точки зрения состояния структура "живого" поиска должна отслеживать больше элементов, чем любой другой написанный нами компонент. Она должна знать, где взять документы XML и XSL, какое поле инициирует поиск, какой URL страницы нужно использовать для поддержки закладок. В общем, соответствующий конструктор будет более громоздким, чем конструкторы, описанные в предыдущих главах. Тем не менее мы все равно сможем им управлять. Итак, посмотрим, как выглядит конструктор "живого" поиска.

function LiveSearch( pageURL, loohupField, xmlURL,

xsltURL, options ) { this.pageURL = pageURL; this.lookupField = lookupField; this.xmlURL = xmlURL;

this.xsltURL = xsltURL; this.setOptions{options);

//

О Настроить компонент

v a r

oThis - t h i s ;

l o o k u p F i e l d . f o r m . o n s u b m i b • f u n c t i o n ( ) { o T h i s . d o S e a r c h ( ) ; r e t u r n f a l s e ; } ;

// Перейти к предыдущему поиску t h i s . i n i t i a l i z e ( ) ;

}

Первые четыре аргумента конструктора были названы выше: URL страницы, поле поиска и URL двух документов. Последним параметром является уже привычный параметр options, используемый для настройки конфигура-

Глава 12. "Живой" поиск с использованием XSLT 509

ции компонента. Аргумент options передается методу setQptions(), который обеспечивает значения по умолчанию для всех настраиваемых данных О. Рассмотрим кратко этот метод.

setOptions: function(options) { this.options — options;

if ( !this.options.loadinglmage ) this.options.loadinglmage = 'images/loading.gif';

if ( !this.options.bookmarkContainerld ) this.options.bookmarkContainerld = 'bookmark1;

if { !this.options.resultsContainerld ) this.options.resultsContainerld - 'results';

if { !this.options.bookmarkText ) this.options-bookmarkText = 'Bookmark Search';

>'

В данном примере метод setOptions {) не настолько лаконичен, как в компоненте TextSuggest (см. главу 10), когда с помощью метода extend() библиотеки Prototype мы получили аккуратное и компактное выражение. Тем не менее сейчас метод выполняет те же действия и предоставляет значения по умолчанию для изображения, отображаемого в процессе загрузки, идентификатора элемента, содержащего закладку, идентификатора элемента, содержащего результаты, и, наконец, текста сгенерированной закладки. Как и в прошлый раз, если в объекте options были переданы значения этих свойств,* они заменяют указанные значения по умолчанию. Полученный в результате объект options представляет собой смешанный набор значений по умолчанию и значений, заданных пользователем. Затем данные опции используются в соответствующих местах сценария для настройки конфигурации компонента.

Разобравшись с настройкой конфигурации и значениями по умолчанию, вернемся к конструктору и напомним две ненавязчивые строки кода:

var oThis = this; lookupField.form.onsubmit = function(){

oThis.doSearch{); return false; };

Напомним, что в первоначальном варианте сценарий модифицировал HTML-страницу, помещая в форму поиска обработчик событий onsubmit.

<form name="Forml" onsubmit="GrabNumber();return false;">

Поскольку мы пытаемся сделать компоненты максимально ненавязчивыми (по крайней мере, с точки зрения того, сколько HTML-кода нужно изменить для использования компонента), две приведенные выше строки кода конструктора предлагают те же функциональные возможности, что и упомянутая модификация HTML-страницы. С точки зрения именования отличие заключается в переименовании GrabNumberO в более универсальный вариант doSearch(), причем doSearch() — это метод нашего компонента, а не глобальная функция. Кстати, посмотрим, как реализован метод doSearcht):

doSearch:

function{) {

if (

XSLTHelper.isXSLTSupported() )

 

this.doAjaxSearch();

else

this.submitTheFormt);

},

 

510 Часть IV. Ajax в примерах

Наш "разумный" компонент знает, что он должен убедиться в поддержке XSLT, а лишь затем пытаться выполнить XSLT-обработку, поэтому метод поиска использует написанный ранее API xsLTHelper и определяет, использовать ли XSLT-обработку или активизировать стандартную отправку формы. Действительно, довольно разумно. Клиент может просто вызывать метод doSearch(), не задумываясь о тонкостях использования XSLT. Обо всем позаботимся мы. Поэтому сейчас подробно рассмотрим два варианта поиска. Поскольку отправка формы проще, начнем именно с нее.

submitTheForm: function() {

var sesrchForm = this.lookupField.form; searchForm.onsubrait « function() { return true; }; searchForm.submit(); t

Ь

Указанный метод находит с помощью поля поиска ссылку на соответствующую форму и изменяет ее обработчик событий onsubmit на функцию, возвращающую значения true. Это позволяет явно возвращать запрос поиска на сервер. Затем метод вызывает метод submit () "родной" формы HTML, который инициирует традиционную отправку формы. В данном сценарии компонент предполагает наличие в форме соответствующего атрибута действия; также считается, что результат действия возвращает соответствующую страницу с результатами поиска.

Далее рассмотрим реализацию поиска средствами Ajax.

doAj axSearch:

function()

{

//

О Показать

изображение в процессе загрузки

 

t h i s . s h o w L o a d i n g l m a g e ( ) ;

 

v a r s e a r c h U r l =

t h i s . a p p e n d T o U r l ( this.xmlURL, ' q 1 ,

//

© Сформировать URL операции поиска

 

 

 

t h i s . l o o k u p F i e l d . v a l u e ) ;

// © Выполнить XSLT-обработку

 

new XSLTHelpertsearchUrl, t h i s . x s l t U R L ) . l o a d V i e w (

 

 

t h i s . o p t i o n s . r e s u l t s C o n t a i n e r l d ) ;

//

О Обновить

закладку

 

 

t h i s . u p d a t e B o o k m a r k ( ) ;

Ь

Метод doAj axSearch () выполняет те же действия, что и первоначальный вариант нашего сценария, однако теперь каждый этап обработки помещен в отдельный метод, отвечающий за свою часть работы. Вы можете возразить и сказать, что данный метод имеет четыре ответственности. Но на самом деле ответственность одна: поиск. Однако она состоит из четырех частей, каждая из которых формулируется как ответственность. Рассмотрим их.

О Показать изображение в процессе загрузки. Поиск начинается с вызова метода, демонстрирующего изображение "идет загрузка". Используемое изображение определяется объектом опций.

Глава 12. "Живой" поиск с использованием XSLT

511

showLoadinglmage: function() {

var newlmg = document.createElement('img1); newlmg.setAttrlbute('src', this.options.loadingImage ); document.getElementById( this.options.resultsContainerld).appendChild(newlmg);

},

0Сформировать URL операции поиска. URL операции поиска формируется

сиспользованием атрибута xmlURL, который был передан в момент создания с параметром q=, к которому присоединено значение, находящееся в текущий момент в поле поиска. Объединение (конкатенация) выполняется методом, проверяющим URL на существование предыдущей строки запроса (таким образом гарантируется использование правильных разделителей параметров).

appendToUrl: function(url, name, value) {

var

separator = '?';

if

(url.indexOf(separator) > 0; ) separator = '&';

return url + separator + name + '=' + value;

},

 

© Выполнить XSLT-обработку и обновить пользовательский интерфейс.

Поскольку мы предусмотрительно вынесли в отдельный метод задачу XSLT-обработки на стороне клиента, данная внешне сложная ответственность выполняется посредством единственной строки кода.

new XSLTHelper(searchUrl,

this.xsltURL).loadView(this.options.resultsContainerld);

О Обновить закладку. После того как пользователь инициировал поиск, необходимо обновить закладку. Данная ответственность выполняется с помощью метода updateBookmark().

updateBookmark: function()

{

v a r

c o n t a i n e r • document . getElementByldt

 

t h i s . o p t i o n s . b o o k m a r k C o n t a i n e r l d ) ;

v a r

bookmarkURL =

t h i s . a p p e n d T o U r l (

 

this . pageURL,

' q 1 ,

t h i s . l o o k u p F i e l d . v a l u e ) ;

if ( c o n t a i n e r )

 

 

 

container . innerHTML = '<a href^" 1 +

 

bookmarkURL +

'" > ' + t h i s . o p t i o n s . b o o k m a r k T e x t + ' < / a > ' ;

}

 

 

 

Этот метод берет из объекта опций элемент container и текст закладки. URL сгенерированной закладки представляет собой значение, переданное конструктору в форме аргумента pageURL. К этому указателю добавляется параметр q= со значением текущего поиска. Согласно всем полученным значениям обновляется свойство innerHTML контейнера и получается соответствующий URL.

Если закладка была записана и использована для возврата на страницу, пользователь переходит на страницу с параметром q=someValue. Но что инициирует поиск, чтобы мы получили требуемый результат? Напомним, что в последней строке конструктора вызывался метод t h i s . i n i t i a l i z e ( ) ; . Мы

Соседние файлы в предмете [НЕСОРТИРОВАННОЕ]