На главную | Публикации | Форумы

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

Сервисы

Избранные доки

Метки (все метки)

internet, it, интернет, интернет сеть, информационные технологии, ит, по, программное обеспечение, сайт, софт

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

Дополнительно

мониторы, движок, Битрикс, хостинг, сайты, мобильные, электроника, видеокарта, СКС, AXIS

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

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

Этот элемент задает фрейм, который предназначен для отображения веб-документа. Он похож на 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 -->
<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.

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

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

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

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

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