Секция <scriptdescription> определяет скрипты, используемые для динамического формирования адреса страницы, отображаемой при выборе некоторой команды. Описания скриптов находятся в секции <script>, которая имеет следующие атрибуты:

• name — название скрипта, используемое в дальнейшем при описании меню;

• url — адрес скрипта. Если скрипт используется для динамического формирования адреса страницы, адрес будет сформирован на основе этого атрибута и параметров, описанных далее. Если же скрипт используется для динамического определения доступности команд меню, атрибут url определяет подстроку, которая должна найтись в адресе текущего документа для того, чтобы команда была доступна;

• param — параметры скрипта, которые добавляются к атрибуту url в виде пары name=value для передачи по методу get. Существуют предопределенные значения параметров, которые могут использоваться для динамической подстановки:

$text — текст, набранный в поле ввода Яндекс. Бара;

$url — адрес текущего документа или параметр url скрипта подсветки;

$domain — домен текущего документа;

$title — заголовок текущего документа;

$same(x) — значение параметра такое же, как значение параметра x скрипта текущего документа. Например, если адрес текущего документа имеет видто использование

<param name="youpar" value="$same(mypar)" /> добавит к динамически формируемому адресу часть "&youpar=tr6".

Секция <refinementdescription> — описание раскрывающегося списка (комбобокса) с уточнениями к строке запроса. Каждый элемент списка описывается тегом <refinement>, имеющим атрибут name — название элемента списка. Кроме того, этот тег может иметь дополнительные параметры (<param name="xxx" value="yyy" />).

Секция <menudescription> — определение кнопок и меню Яндекс. Бара:

menu — название и тип элемента;

item — определяет пункты ниспадающего меню — название и ссылка для перехода. Яндекс. Баром поддерживаются меню произвольной вложенности;

title — название элемента. Если этот параметр отсутствует, то пункт меню отображается в виде горизонтальной линии-разделителя;

url — если этот параметр отсутствует, но далее идет описание вложенных элементов, то это пункт, вызывающий выпадающее меню следующего уровня. Если же параметр присутствует, то это элемент, при нажатии на который браузер пойдет по указанной ссылке. В качестве значений параметра url могут использоваться не только прямые статические ссылки вида http://www.site.com(url начинается с http:// или с https://), но и имена скриптов из предыдущей секции с соответствующей подстановкой параметров и даже вызовы методов javascript встроенного в Explorer интерпретатора (url начинается с javascript:).

icon — порядковый номер картинки в ресурсах Яндекс. Бара.

Некоторые функциональные возможности Яндекс. Бара, общие для всех конфигураций, реализованы в виде подключаемых модулей. Их использование может вами регулироваться. На текущий момент в состав плагина входят четыре регулируемых модуля — менеджер подсветки, веб-индикатор, личные закладки и личные письма. Яндекс. Бар разработан таким образом, что к нему могут быть подключены и иные модули, которые будут разработаны в будущем.

Если вы внимательно прочитали описание инструментальной панели, то можете сопоставить ее кнопки и перечисленные модули. За исключением первого — Менеджера подсветки. Этот модуль помогает работать с документами, найденными поисковыми системами Яндекса, — http://www.yandex.ru, http://ya.ru, а также с программами персонального поиска — Яndex.Siteи Яndex.CD. Суть работы модуля заключается в том, что происходит обработка найденных документов, при которой в них выделяются — подсвечиваются — слова из поискового запроса (рис. 4.4).

В поисковой системе http://www.yandex.ru/можно увидеть подсвеченный документ, если, находясь на странице с результатами поиска, перейти по ссылке Сохраненная копия. Найденные слова выделяются в подсвеченном документе оранжевым фоном. В программах Яndex.Serverи Яndex.Publisherспособы перехода к подсвеченному документу и выделения найденных слов зависят от настроек, сделанных администратором веб-сервера или издателем диска. По умолчанию найденные слова выделяются с помощью красных стрелочек с обеих сторон.

Специальной кнопки на инструментальной панели для управления этим модулем нет, поскольку он либо работает, либо не работает, а настроить его можно в меню плагина (пункт Подключаемые модули | Менеджер подсветки) или на странице Яндекса http://bar.yandex.ru/help/highlighter.xhtml.

Настройка модуля заключается в выборе кнопок, которые могут отображаться на панели, и места их размещения. Эти кнопки появляются в Яндекс. Баре при переходе на веб-страницу с подсвеченным документом. Кнопки означают: