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

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

XULRunner: класс XULElement

XULRunner

В Mozilla Application Framework, — современной реализацией которого является XULRunner, — класс XULElement представляет собой базовый элемент XUL, — XML-языка для описания пользовательского интерфейса (XML User Interface Language). Класс XULElement расширяет класс Element и реализует интерфейс nsIDOMXULElement.

Иначе говоря, в языке XUL каждый тег представляет объект XULElement. Примеры: элемент browser, элемент findbar.

Интерфейс nsIDOMXULElement предусматривает следующие свойства для всех XULElement-ов:

  • align (строка) — определяет как должны выравниваться дочерние элементы, в случае, когда размер блока превышает суммарный размер дочерних элементов. Если элемент имеет горизонтальную ориентацию, align задает выравнивание по вертикали. Если элемент имеет вертикальную ориентацию, align задает выравнивание по горизонтали. Может иметь следующие значения: start, center, end, stretch.
  • allowEvents (логическое значение) — если установлено в true, события будут передаваться дочерним элементам. В противном случае события будут передаваться только данному элементу.
  • boxObject (объект BoxObject, только для чтения) — содержит ссылку на контейнер, в котором содержится данный элемент (если есть контейнер).
  • builder (объект XULTemplateBuilder, только для чтения) — если содержимое элемента генерируется по некоему шаблону (template), то это свойство содержит ссылку на объект XPCOM, ответственный за формирование содержимого.
  • className (строка) — содержит значение атрибута "class", назначающий узлу XUL какой-то класс CSS.
  • collapsed (логическое значение) — если установлено в true, то элемент сворачивается и не отображается. Это эквивалентно стилю "visibility:collapse", назначенному с помощью CSS.
  • contextMenu (строка) — содержит идентификатор всплывающего элемента контекстного меню, которое обычно вызывается кликом правой кнопкой мыши на элементе.
  • controllers (объект Controllers, только для чтения) — объект списка контролёров, выполняющих команды, связанные с элементом.
  • database (объект RDFCompositeDataSource, только для чтения) — содержит ссылку на составной источник данных для данного элемента, который создается объединением всех источников данных, перечисленных в атрибуте "datasources" данного элемента. Если указанный атрибут не установлен, то свойство содержит значение null.
  • datasources (строка) — разделённый пробелами список URI источников данных для данного документа. Получает и устанавливает значение атрибута "datasources", упомянутого выше.
  • dir (строка) — направление размещения дочерних элементов. Может принимать одно из следующих значений: "normal" (слева направо или сверху вниз) либо "reverse" (в противоположном направлении).
  • flex (строка, интерпретируемая как целое число) — мера "упругости" элемента. Чем выше значение, тем больше визуального пространства занимает элемент по сравнению с соседними. Например, если у элемента A flex="1", а у соседнего с ним элемента B flex="2", то элемент A будет занимать вдвое меньшее пространство, чем элемент B. Если при этом элементы A и B являются единственными в контейнере, то A займёт треть пространства контейнера, а B — 2/3.
  • flexGroup (строка) — предусмотрено, но нереализовано.
  • height (строка, интерпретируемая как целое число) — предпочтительная высота элемента в пикселях. Реальная высота может отличаться от указанной по ряду причин (размер контейнера, размер содержимого, стили CSS и др.)
  • hidden (логическое значение) — является ли элемент скрытым. Если установлено в true, эквивалентно "display:none" в CSS.
  • id (строка) — уникальный идентификатор элемента. Очень полезен вместе с функцией getElementById(...).
  • left (строка, интерпретируемая как целое число) — позиция (в пикселях) левой границы элемента относительно левой границы стэка (stack). Стэком, в данном случае, называется элемент, который последовательно отрисовывает свои дочерние так, что каждый следующий помещается поверх предыдущего.
  • maxHeight (строка, интерпретируемая как целое число) — максимальная высота элемента в пикселях. Соответствует свойству "max-height" в CSS.
  • maxWidth (строка, интерпретируемая как целое число) — максимальная ширина элемента в пикселях. Соответствует свойству "max-width" в CSS.
  • menu (строка) — идентификатор всплывающего элемента, который должен показываться, когда пользователь кликает по элементу.
  • minHeight (строка, интерпретируемая как целое число) — минимальная высота элемента в пикселях. Соответствует свойству "min-height" в CSS.
  • minWidth (строка, интерпретируемая как целое число) — минимальная ширина элемента в пикселях. Соответствует свойству "min-width" в CSS.
  • observes (строка) — идентификатор элемента-транслятора (broadcaster), для которого данный элемент является элементом-наблюдателем (observer).
  • ordinal (строка, интерпретируемая как целое число) — позиция элемента среди других элементом с тем же родителем. По умолчанию равно 1 и элементы выстраиваются в порядке их написания в XML-коде. Свойство ordinal может изменить этот порядок.
  • orient (строка) — задает горизонтальную либо вертикальную ориентацию элемента. Соответственно может иметь только одно из двух значений: "horizontal" либо "vertical".
  • pack (строка) — определяет, как должны быть расположены дочерние элементы, если их суммарный размер меньше размера элемента. Может принимать одно из следующих значений: "start" (дочерние элементы прижимаются к началу данного), "center" (по центру), "end" (в конце).
  • persist (строка) — разделённый пробелами список атрибутов, значения которых должны сохраняться при закрытии окна. При последующем открытия окна значения этих атрибутов должны восстанавливаться в последних установленных значениях.
  • ref (строка) — URI ресурса RDF, указывающий на корневой узел RDF для начала генерации содержимого элемента. Смотрите также свойство "datasources".
  • resource (объект RDFResource, только для чтения) — ресурс RDF, чей URI доступен в свойстве ref.
  • statusText (строка) — задает текст, отображаемый в статусбаре окна, когда пользователь наводит мышку на элемент.
  • tooltip (строка) — идентификатор элемента, который будет всплывать как подсказка, когда пользователь наводит мышку на элемент.
  • tooltipText (строка) — строка всплывающей подсказки. Может быть использована вместо tooltip, когда подсказка является чисто текстовой.
  • top (строка, интерпретируемая как целое число) — позиция (в пикселях) верхней границы элемента относительно верхней границы стэка (stack). Смотрите также свойство left.
  • width (строка, интерпретируемая как целое число) — предпочтительная ширина элемента в пикселях. Реальная ширина может отличаться от указанной по ряду причин (размер контейнера, размер содержимого, стили CSS и др.)

Кроме того XULElement наследует следующие свойства класса Element: attributes, childNodes, firstChild, lastChild, localName, namespaceURI, nextSibling, nodeName, nodeType, nodeValue, ownerDocument, parentNode, prefix, previousSibling и tagName.

Интерфейс nsIDOMXULElement предусматривает следующие методы для всех XULElement-ов:

  • blur() (ничего не возвращает) — если фокус находится на данном элементе, вызов этого метода снимает фокус. Вызывает обработчик события "onblur".
  • click() (ничего не возвращает) — вызывает обработчик события "onclick" для данного элемента.
  • doCommand() (ничего не возвращает) — вызывает обработчик события "command" для данного элемента.
  • focus() (ничего не возвращает) — устанавливает фокус на данном элементе. Вызывает обработчик события "onfocus", если соответствующее элементу окно верхнего уровня является активным.
  • getElementsByAttribute(in DOMString name, in DOMString value) — возвращает список дочерних элементов (объект DOMNodeList), имеющих атрибуты с именем name и значением value.
  • getElementsByAttributeNS(in DOMString namespaceURI, in DOMString name, in DOMString value) — возвращает список дочерних элементов (объект DOMNodeList), имеющих атрибуты с именем name из пространства имен namespaceURI со значением value.

Кроме того XULElement наследует следующие методы класса Element: AddRef, appendChild, cloneNode, getAttribute, getAttributeNS, getAttributeNode, getAttributeNodeNS, getElementsByTagName, getElementsByTagNameNS, hasAttribute, hasAttributeNS, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, QueryInterface, Release, removeAttribute, removeAttributeNS, removeAttributeNode, removeChild, replaceChild, setAttribute, setAttributeNS, setAttributeNode и setAttributeNodeNS.

Автор: Дмитрий Скоробогатов, 18.04.2011


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

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

Последнее редактирование: 2011-04-18 11:20:19

Метки материала: xulrunner, xulelement, mozilla, программирование, dom, мозила, xul, mozilla application

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

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

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


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