Интернет, компьютеры, софт и прочий Hi-Tech

Подписаться через RSS2Email.ru

XUL-элемент "findbar"

Содержание

  1. Пример
  2. Атрибуты
  3. Свойства
  4. Методы

Добавлено в Gecko 1.9 (Firefox 3)

Виджет "findbar" (панель поиска по документу) был добавлен в инструментарий Gecko 1.9 и стал доступен для любых XUL-приложений, включая расширения.

Вот как, например, выглядит стандартная панель поиска в Firefox 3.5 для платформы Mac:

Панель поиска по документу findbar

Вы можете прикрепить панель поиска к нужному элементу браузера установив атрибут browserid элемента findbar в значение идентификатора (id) соответствующего элемента browser, который должен быть описан до элемента findbar. Можно также присвоить свойству browser элемента findbar сам элемент browser в качестве значения.

Атрибуты
browserid, findnextaccesskey, findpreviousaccesskey, highlightaccesskey, matchcaseaccesskey
Свойства
browser, findMode
Методы
close, onFindAgainCommand, open, startFind, toggleHighlight

Пример

<browser type="content-primary" flex="1" id="content" src="about:blank"/>
<findbar id="FindToolbar" browserid="content"/>

Атрибуты

Унаследованные от элементов XUL
align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, noinitialfocus, observes, ordinal, orient, pack, persist, popup, position, preference-editable, querytype, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width
browserid
Тип: string (строка)
Идентификатор элемента браузера, к которому присоединяется данный findbar. Этот атрибут используется только в том случае, когда панель поиска является конструктивным элементом документа XUL. В скрипте вам следует использовать свойство browser, чтобы задать браузер или получить к нему доступ.
findnextaccesskey
Тип: string (строка)
Клавиша доступа для кнопки "Искать следующий" ("Find Next") на тулбаре панели поиска.
findpreviousaccesskey
Тип: string (строка)
Клавиша доступа для кнопки "Искать предыдущий" ("Find Previous") на тулбаре панели поиска.
highlightaccesskey
Тип: string (строка)
Клавиша доступа для кнопки "Подсветить" ("Highlight") на тулбаре панели поиска.
matchcaseaccesskey
Тип: string (строка)
Клавиша доступа для чекбокса "Учитывать регистр" ("Match case") на панели поиска.

Свойства

Унаследованные свойства
align, attributes, allowEvents, baseURI, boxObject, builder, childElementCount, childNodes, children, className, clientHeight, clientLeft, clientTop, clientWidth, collapsed, contextMenu, controllers, database, datasources, dir, firstChild, firstElementChild, flex, height, hidden, id, lastChild, lastElementChild, left, localName, maxHeight, maxWidth, menu, minHeight, minWidth, namespaceURI, nextElementSibling, nextSibling, nodeName, nodeType, nodeValue, observes, ordinal, orient, ownerDocument, pack, parentNode, persist, prefix, previousElementSibling, previousSibling, ref, resource, scrollHeight, scrollLeft, scrollTop, scrollWidth, statusText, style, tagName, textContent, tooltip, tooltipText, top, width
browser
Тип: элемент browser
Позволяет вам устанавливать и получать доступ к элементу browser для которого назначена данная панель поиска.
findMode
Тип: integer (целое)
Только для чтения. Используемый режим поиска. Возможные значения:
  • FIND_NORMAL (0): обычный поиск
  • FIND_TYPEAHEAD (1): поиск с опережением
  • FIND_LINKS (2): поиск ссылки

Методы

Унаследованные методы
addEventListener(), appendChild(), blur(), click(), cloneNode(), compareDocumentPosition(), dispatchEvent(), doCommand(), focus(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getBoundingClientRect(), getClientRects(), getElementsByAttribute(), getElementsByAttributeNS(), getElementsByClassName(), getElementsByTagName(), getElementsByTagNameNS(), getFeature(), getUserData(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isDefaultNamespace(), isEqualNode(), isSameNode(), isSupported(), lookupNamespaceURI(), lookupPrefix(), normalize(), querySelector(), querySelectorAll(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS(), setUserData()
close()
Возвращаемый тип: не возвращает значения
Закрывает сообщение или панель поиска и скрывает соответствующие им notificationbox или findbar.
open( mode )
Возвращаемый тип: не возвращает значения
Открывает панель поиска в указанном режиме. Параметр может принимать одно из следующих значений: FIND_NORMAL, FIND_TYPEAHEAD или FIND_LINKS. Если вы не указываете режим, будет использован последний из использованных в данной панели режимов. Если при этом панель поиска не использовалась ранее, то по умолчанию будет применен режим FIND_NORMAL.
onFindAgainCommand( findPrevious )
Возвращаемый тип: не возвращает значения
Вызов этого метода осуществляет в вашем приложении команды "найти следующий" ("find next") и "найти предыдущий" ("find previous"). В качестве параметра вы должны указать "false" чтобы осуществить операцию "найти предыдущий", или "true" чтобы осуществить "найти следующий".
startFind( mode )
Возвращаемый тип: не возвращает значения
Вызов этого метода подает вашему приложению команду "искать" ("find"). Она открывает панель поиска, устанавливает фокус на редактируемое поле для ввода искомого выражения и выделяет ее содержимое. При первом вызове метода для данной панели поиска в ней будет мигать курсор привлекая к себе внимание. Параметр "mode" (режим) может принимать одно из значений: FIND_NORMAL, FIND_TYPEAHEAD или FIND_LINKS. Если вы не указали этот параметр, метод применит последний из использованных в данной панели поиска режимов. Если данная панель до этого ни разу не использовалась, по умолчанию будет применен FIND_NORMAL.
toggleHighlight( highlight )
Возвращаемый тип: не возвращает значения
Переключает подсветку найденных в тексте слов и выражений между "on" (включено) и "off" (выключено). Если установить параметр в false, то подсветка будет отключена. Если в true - включена.

Перевод с английского: Дмитрий Скоробогатов, 06.01.2011. Оригинал находится по адресу https://developer.mozilla.org/En/XUL/Findbar.


Предыдущие публикации:

Биржа долевых инвестиций SIMEX.

Последнее редактирование: 2011-01-21 22:59:17

Метки материала: xul, findbar, приложение, xulrunner, программирование, разработка по, интерфейс, мозила, xml

Оставьте, пожалуйста, свой комментарий к публикации

Представиться как     Антибот:
   

Просьба не постить мусор. Если вы хотите потестить xBB, воспользуйтесь кнопкой предварительного просмотра на панели инструментов xBBEditor-а.


© 2007-2017, Дмитрий Скоробогатов.
Разрешается воспроизводить, распространять и/или изменять материалы сайта
в соответствии с условиями GNU Free Documentation License,
версии 1.2 или любой более поздней версии, опубликованной FSF,
если только иное не указано в самих материалах.