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

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

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

(Если вы не понимаете, о чем эта страница, прочтите статью "Начало работы с XULRunner")

Содержание

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

Этот элемент задает фрейм, который предназначен для отображения веб-документа. Он похож на iframe, но имеет небольшие отличия: он ведет собственную историю просмотров страниц и имеет дополнительные методы для управления текущей отображаемой страницей.

Большинство свойств и методов браузера используются редко и могут быть вызваны только с адресов "chrome://". С других адресов для использования доступны объекты отображаемого документа и истории переходов.

Атрибуты
autocompleteenabled, autocompletepopup, autoscroll, disablehistory, disablesecurity, homepage, showcaret, src, type
Свойства
accessibleType, canGoBack, canGoForward, contentDocument, contentPrincipal, contentTitle, contentViewerEdit, contentViewerFile, contentWindow, currentURI, docShell, documentCharsetInfo, homePage, markupDocumentViewer, preferences, securityUI, sessionHistory, webBrowserFind, webNavigation, webProgress
Методы
addProgressListener, goBack, goForward, goHome, gotoIndex, loadURI, loadURIWithFlags, reload, reloadWithFlags, removeProgressListener, stop, swapDocShells

Пример

Сайт Mozilla внутри элемента groupbox
<!-- показывает сайт Mozilla внутри элемента groupbox -->
<groupbox flex="1">
  <caption label="Mozilla homepage"/>
  <browser type="content" src="http://www.mozilla.org" flex="1"/>
</groupbox>

Атрибуты

Унаследованные от 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
autocompleteenabled
Тип: boolean
Если установлен в true, включает автозаполнение полей.
autocompletepopup
Тип: id элемента типа popup
Идентификатор id элемента popup, используемого для хранения вариантов автозаполнения для элементов форм.
Как включить автозаполнение (для форм) в элементе browser.
autoscroll
Тип: boolean
Если установить в false, отключает автопрокрутку для данного браузера. Если этот атрибут установлен в true, автопрокрутка будет включена, если опущен, то наличие автопрокрутки будет определяться пользовательской настройкой general.autoScroll.
disablehistory
Тип: boolean
Если установлен в false, будет показана кнопка со стрелкой, открывающая выпадающее меню со всеми доступными результатами. Значением по умолчанию является true, скрывающее выпадающее меню.
disablesecurity
Тип: boolean
Установка этого атрибута в true отключает безопасность UI данного браузера. Установка этого атрибута в off включает безопасность.
homepage
Тип: URL домашней страницы
Этот атрибут позволяет вам задать домашнюю страницу для элемента "browser". Он никак не связан с пользовательской домашней страницей в браузере. Для последнего случая существует удобное свойство, в котором хранится домашняя страница. Вы можете переключаться на заданную домашнюю страницу с помощью метода goHome().
showcaret
Тип: boolean
Этот атрибут включает/отключает показ курсора вставки в области контента. Значение по умолчанию: false.
src
Тип: URL
URL контента, отображаемого в элементе browser.
type
Тип: одно из нижеперечисленных значений
Тип браузера, который может быть использован для задания прав доступа документа, загружаемого в браузер. Если этот аргумент не задан, загружаемый документ будет иметь такие же права доступа, как окно, содержащее данный элемент browser.
  • content: Браузер для контента. Загружаемый в браузер контент не будет иметь доступа "chrome" к содержащим его элементам.
  • content-primary: Основной браузер для контента. Контент, который загружается в браузер, не будет иметь прав доступа "chrome" к содержащим его элементам. Это может быть, например, веб-браузер для показа веб-страниц. Доступ к окну с основным контентом можно легко получить с помощью window.content.
  • content-targetable: Один браузер для контента среди многих. Контент, который будет загружаться в браузер, не будет иметь прав доступа "chrome" к содержащим его элементам. Для элементов browser это значение является предпочтительным в тех приложениях, которые будут использовать несколько браузеров с одинаковыми привилегиями одновременно.
  • chrome: (поведение по умолчанию) Браузер предназначен для загрузки привилегированного контента с использованием URI "chrome://". Не используйте это значение для контента из веба, так как можете получить серьезные проблемы с безопасностью!

Свойства

Свойства, унаследованные от XULElement:
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
accessibleType
Тип: integer
Значение, указывающее тип объекта доступности для рассматриваемого элемента.
canGoBack
Тип: boolean
Это свойство доступно только для чтения и имеет значение true, если в истории сессии существует страница, на которую можно вернуться с помощью кнопки "Back" ("На предыдущую страницу").
canGoForward
Тип: boolean
Это свойство доступно только для чтения и имеет значение true, если в истории сессии существует страница, на которую можно перейти с помощью кнопки "Forward" ("На следующую страницу").
contentDocument
Тип: document
Доступное только для чтения свойство, содержащее объект документа, загруженного в элемент.
contentPrincipal
Тип: nsIPrincipal
Это свойство доступно только для чтения и содержит данные о доверителе загруженного в браузер контента, который предоставляет информацию в контексте безопасности.
contentTitle
Тип: string
Это свойство доступно только для чтения и содержит заголовок (title) объекта документа, загруженного в браузер.
contentViewerEdit
Тип: nsIContentViewerEdit
Это свойство доступно только для чтения и содержит объект nsIContentViewerEdit, который управляет операциями с буфером обмена для данного документа.
contentViewerFile
Тип: nsIContentViewerFile
Ссылка на интерфейс nsIContentViewerFile для загруженного документа.
contentWindow
currentURI
Тип: nsIURI
Это свойство доступно только для чтения и содержит текущий загруженный URL. Для изменения этого URL используйте метод loadURI().
docShell
Тип: nsIDocShell
Это свойство доступно только для чтения и содержит объект nsIDocShell для данного документа.
documentCharsetInfo
Тип: nsIDocumentCharsetInfo
Это свойство доступно только для чтения и содержит объект nsIDocumentCharsetInfo для загруженного документа. Он используется для работы с кодировкой отображаемого документа.
homePage
Тип: строка URL домашней страницы
Значением этого свойства является домашняя страница пользователя, установленная в настройках.
markupDocumentViewer
Тип: nsIMarkupDocumentViewer
Это свойство доступно только для чтения и содержит объект nsIMarkupDocumentViewer, который ответственен за отображение документа.
preferences
Тип: nsIPrefService
Это свойство доступно только для чтения и содержит объект nsIPref для получения и установления пользовательских настроек.
securityUI
Тип: nsISecureBrowserUI
Это свойство доступно только для чтения и хранит объект, который может быть использован для определения уровня безопасности загруженного документа.
sessionHistory
Тип: nsISHistory
Это свойство доступно только для чтения и содержит объект nsISHistory, который хранит историю сессии.
webBrowserFind
Тип: nsIWebBrowserFind
Это свойство доступно только для чтения и содержит объект nsIWebBrowserFind, который может быть использован для поиска текста в документа.
webNavigation
Тип: nsIWebNavigation
Это свойство доступно только для чтения и содержит объект nsIWebNavigation для загруженного документа. Большинство его методов могут быть вызваны методами самого элемента браузера, как, например, goBack() и goForward(). Кроме того, объект навигации содержит константы загрузки, используемые в reloadWithFlags() и loadURIWithFlags().
webProgress
Тип: nsIWebProgress
Это свойство доступно только для чтения и содержит объект nsIWebProgress, который используется для отслеживания прогресса загрузки документа.

Методы

Унаследованные методы:
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()
addProgressListener( listener, notifyMask )
Возвращаемое значение: не возвращает значения
Устанавливает браузеру слушателя прогресса, который будет отслеживать загрузку документов. Слушатель прогресса должен реализовывать интерфейс nsIWebProgressListener. Смотрите информацию о флагах NOTIFY_ для nsIWebProgress.
goBack()
Возвращаемое значение: не возвращает значения
Вернуться на предыдущую страницу согласно истории.
goForward()
Возвращаемое значение: не возвращает значения
Переход на одну страницу вперед по истории загрузок страниц.
goHome()
Возвращаемое значение: не возвращает значения
Загружает в браузер домашнюю страницу пользователя.
gotoIndex( index )
Возвращаемое значение: не возвращает значения
Направляет на страницу, которая сохранена в истории с данным индексом. Используйте положительное число, для перехода вперед и отрицательное число для перехода назад.
loadURI( uri, referrer, charset )
Возвращаемое значение: не возвращает значения
По данному URL загружает документ с указанием реферрера и кодировки.
Первый аргумент должен быть строкой, а не объектом nsIURI. Для получения строки из nsIURI используйте nsIURI.spec или nsIURI.asciiSpec.
loadURIWithFlags( uri, flags, referrer, charset, postData )
Возвращаемое значение: не возвращает значения
Загружает документ с заданного URL используя специальные флаги загрузки и передавая реферрера, кодировку и POST-данные. В дополнению к флагам, разрешенным в методе reloadWithFlags(), можно использовать также следующие флаги:
  • LOAD_FLAGS_IS_REFRESH: Этот флаг используется тогда, когда URL загружается по причине того, что имеется мета-тег, задающий обновление страницы или редирект.
  • LOAD_FLAGS_IS_LINK: Этот флаг используется когда пользователь кликает на ссылку для загрузки URL. Соответственно этому устанавливается HTTP-заголовок "Referer".
  • LOAD_FLAGS_BYPASS_HISTORY: Не добавлять данный URL в историю сессии.
  • LOAD_FLAGS_REPLACE_HISTORY: Заменяет текущий URL в истории сессии на какой-то новый. Этот флаг может быть использован при редиректе.

(Более подробную информацию о параметрах referrer и postData смотрите здесь: nsIWebNavigation.loadURI().)

reload()
Возвращаемое значение: не возвращает значения
Перезагружает документ в браузере.
reloadWithFlags( flags )
Возвращаемое значение: не возвращает значения
Перезагружает документ в браузере с использованием заданных флагов загрузки. Флаги, которые могут быть использованы, перечислены ниже. Все они являются константами свойства webNavigation (или интерфейса nsIWebNavigation). Вы можете комбинировать флаги с помощью символа ( | ).
  • LOAD_FLAGS_NONE: Нет специально флага. Документ загружается обычным порядком.
  • LOAD_FLAGS_BYPASS_CACHE: Перезагрузить страницу игнорируя ее возможное наличие в кэше. Этот флаг используется в том случае, когда при нажатой и удерживаемой клавише "Shift" нажата кнопка "Обновить".
  • LOAD_FLAGS_BYPASS_PROXY: Перезагрузить страницу игнорируя прокси-сервер.
  • LOAD_FLAGS_CHARSET_CHANGE: Этот флаг используется в случае, когда документ должен быть перезагружен из-за изменения кодировки.
removeProgressListener( listener )
Возвращаемое значение: не возвращает значения
Удаляет из браузера обработчик прогресса загрузки.
stop()
Возвращаемое значение: не возвращает значения
Эквивалент нажатию кнопки "Stop" ("Остановить загрузку страницы"). Этот метод прекращает загрузку текущего документа.
swapDocShells( otherBrowser )
Возвращаемое значение: не возвращает значения
Заменить содержимое, историю и текущее состояние данного элемента browser из другого браузера. Во время замены в обоих браузерах возбуждаются события "pagehide" и "pageshow". Этот метод может быть использован для перемещения браузера из одного окна в другой или для открытия браузера в новом окне.
Замечание: Оба браузера должны быть либо самостоятельными браузерами, либо встроенными в tabbrowser. Вы не должны их путать.

Еще по теме

Интерфейс
nsIAccessibleProvider

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


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

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

Последнее редактирование: 2011-04-18 12:43:26

Метки материала: xulrunner, xul, browser, mozilla, программирование, разработка по, мозила, теги, xml, it, браузер, dom, информационные технологии, тег, язык разметки, xulelement

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

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

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


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