mozilla

toolbox

toolbar のコンテナ。これは box の一種ですが、デフォルトで垂直指向です。toolbartoolbox 内に置かれると、その左上端に grippy が表示されます。ユーザは grippy をクリックして toolbar を折り畳みます。複数の toolbar が同じ toolbox 内に置かれたときは、それらがすべて同じ行内に折り畳まれます。Firefox ブラウザは grippy を持っていないため、toolbar を折り畳んだり展開したりすることはできません。

Gecko 2.0 note
(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) では、外部ツールバーのサポートが追加されました。これは、toolbox の子要素ではないツールバーです。あなたのツールバーを管理する目的で外部ツールバーを toolbox に関連付けるには、ツールバーに toolboxid プロパティを設定してください。toolbox に関連付けられた外部ツールバーは、toolbar の externalToolbars プロパティにより提供される要素の配列に列挙されます。

詳しい情報が XUL チュートリアルにあります。

toolbox 内のツールバーが変更されたことを検知したい場合は、Toolbar カスタマイズイベントを参照してください。

プロパティ
accessible, customToolbarCount, externalToolbars, palette, toolbarset
メソッド
appendCustomToolbar, collapseToolbar, expandToolbar

toolbox.png

<?xml version="1.0"?>
<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>
<window id="yourwindow" xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" title="toolbox example" width="300">
  <toolbox>
    <toolbar>
      <toolbarbutton label="Back"/>
      <toolbarbutton label="Forward"/>
      <toolbarbutton label="Home"/>
    </toolbar>
    <toolbar>
      <toolbarbutton label="Stop"/>
      <toolbarbutton label="Reload"/>
    </toolbar>
  </toolbox>
  <textbox multiline="true" value="We have two toolbars inside of one toolbox above." width="20"/>
</window>

属性

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, 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

プロパティ

accessible
型: nsIAccessible
要素の accessibility object を返す。
customToolbarCount
Firefox のみ
型: 整数型
toolbox に含まれる現在のカスタム toolbar の数
externalToolbars
Type: array of elements
An array of external toolbars; that is, toolbar elements that should be considered to be members of this toolbox, even if they are not actually children of the toolbox.
palette
Firefox のみ
型: 要素
toolbox 内の toolbarpalette
toolbarset
Firefox のみ
型: 要素
toolbox 内の toolbarset

メソッド

XUL 要素からの継承
blur, click, doCommand, focus, getElementsByAttribute getElementsByAttributeNS

DOM 要素からの継承
addEventListener(), appendChild(), compareDocumentPosition, dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), getFeature, getUserData, hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isEqualNode, isSameNode, isSupported(), lookupNamespaceURI, lookupPrefix, normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS(), setUserData

appendCustomToolbar( name, currentset )
Firefox のみ
戻り値の型: element
toolbox に与えられた name の カスタム toolbar を追加します。デフォルトでは、二番目の引数に、追加する toolbar 項目のカンマで区切られた id のリストが提供されます。このメソッドは作成されたツールバーの DOM 要素を返します。
collapseToolbar( toolbar )
※ Firefox では使用不可
戻り値の型: 戻り値無し
与えられた toolbar を折り畳みます。これは toolbox 内に含まれていなければなりません。
expandToolbar( toolbar )
※ Firefox では使用不可
戻り値の型: 戻り値無し
指定した toolbar を展開します。これは toolbox 内に含まれていなければなりません。

関連項目

要素
toolbar, toolbarbutton, toolbargrippy, toolbaritem, toolbarpalette, toolbarseparator, toolbarset, toolbarspacer, toolbarspring
インタフェース
nsIAccessibleProvider

 

ドキュメントのタグと貢献者

Contributors to this page: Marsf, Mgjbot
最終更新者: Marsf,