XUL:toolbar
出典: MDC
« XUL リファレンス HOME [ 例 | 属性 | プロパティ | メソッド | 関連項目 ]
一般的なボタンの行を含むコンテナ。これは box の一種で、デフォルトで水平指向です。toolbar が toolbox に置かれている場合、grippy で折り畳むことができます。toolbar は常に id 属性を持たなければなりません。Firefox がツールバーのカスタマイズをサポートしているのに対して、Mozilla ブラウザはサポートしていません。
chromeclass-toolbar クラスは、window を window.open メソッドで開いた時、そのウィンドウの toolbar フラグに視覚的に依存したツールバーを作成するために使用されます。
詳しい情報が XUL チュートリアルにあります。
- 属性
- currentset, customindex, customizable, defaultset, grippyhidden, grippytooltiptext, mode, toolbarname
- メソッド
- insertItem
- スタイルクラス
- chromeclass-toolbar
[編集] 例
<toolbox>
<toolbar id="nav-toolbar">
<toolbarbutton id="nav-users" accesskey="U" label="Users"/>
<toolbarbutton id="nav-groups" accesskey="p" label="Groups"/>
<toolbarbutton id="nav-events" accesskey="E" label="Events" disabled="true"/>
</toolbar>
</toolbox>
[編集] 属性
|
XUL 要素からの継承 |
- currentset
- Firefox のみ
- 型: カンマで区切られた string
- toolbar 上に表示された現在の項目のリスト。これは、ユーザが toolbar をカスタマイズしたときに調整されます。この属性の値は、カンマで区切られた toolbarpalette の項目 ID のリストに、次の文字列のいずれかを加えたものです: "
separator", "spring", "spacer"。
- customindex
- Firefox のみ
- 型: integer
- この値は、カスタムツールバーのリストの、toolbar の index です。値はツールバーカスタマイズダイアログによって自動的に更新されます。
- customizable
- Firefox のみ
- 型: boolean
- toolbar 上のこの属性を
trueに設定すると、ツールバーをカスタマイズすることができます。これにより、ボタンの配置がセッションをまたいで持続されます。
- defaultset
- Firefox のみ
- 型: 項目 id のカンマで区切られたリスト
- toolbar 上に表示される項目のデフォルトの配置。この属性には toolbarpalette からの項目 ID のカンマで区切られたリストを設定します。例えば、
back-button,forward-button,print-buttonのようにします。
- grippyhidden
- Firefox では使用不可
- 型: boolean
-
trueに設定すると grippy が隠されます。デフォルト値のfalseに設定すると grippy が現れます。
- grippytooltiptext
- Firefox では不可
- 型: string
- toolbar が畳まれている時に、その grippy の tooltip に表示するテキスト。grippy のラベル付けに使用されるため、ユーザは、どのツールバーがこれを提供しているかを知ることができます。
- mode
- Firefox のみ
- 型: 下記の値のいずれか一つ
- toolbar 上の toolbarbutton の表示の仕方。
-
icons: アイコンのみを表示。 -
text: テキストのみを表示。 -
full: アイコンとテキストの両方を表示。
- toolbarname
- Firefox のみ
- 型: string
- toolbar の名前。ツールバーメニューの表示/非表示のリストに記載されます。
[編集] プロパティ
|
XUL 要素からの継承 DOM 要素からの継承 |
- accessibleType
- 型: integer
- 要素の accessibility オブジェクトの種類を示す値。
- currentSet
- Firefox のみ
- 型: strings のカンマで区切られたリスト
- 現在 toolbar 上にある項目の ID のカンマで区切られたリストを保持します。スペースおよび区切り、伸縮自在のスペースは、ID の代わりにそれぞれ次の文字列が使用されます: "
spacer", "separator", "spring"。空の toolbar のcurrentSet値は"__empty"です。
- このプロパティを設定することによって、項目の現在の配置を変更できます。このプロパティを設定すると currentset 属性が自動的に更新されないので注意してください。
- firstPermanentChild
- Firefox のみ
- 型: element
- toolbar の最初の永続的な子要素。永続的な子要素は、カスタマイズ不可で toolbar 上に残る要素です。この項目は、toolbarpalette 内で永続的でなくても、直接 toolbar 内に置かれます。
- lastPermanentChild
- Firefox のみ
- 型: element
- toolbar の最後の永続的な子要素。永続的な子要素は、カスタマイズ不可で toolbar 上に残る要素です。この項目は、toolbarpalette 内で永続的でなくても、直接 toolbar 内に置かれます。
- toolbarName
- Firefox のみ
- 型: string
- toolbar の名前。
[編集] メソッド
- insertItem( id, beforeNode, wrapper, beforePermanent )
- Firefox のみ
- 戻り値の型: element
- 与えられた id を持つ項目を toolbar に追加します。新しい項目は二番目の引数に与えられた項目の前に追加されます。二番目の引数が
nullにもかかわらず beforePermanent 引数がtrueの場合、項目は toolbar の先頭、最初の永続的項目の前に追加されます。逆に beforePermanent 引数がfalseの場合、新しい項目は toolbar の末尾に追加されます。三番目の引数は、他の要素の新しい項目を折り返すために使用します。通常、最後の引数は主にカスタマイズダイアログが使用するためnullです。
id は toolbar の toolbarpalette 内の要素に一致しなければなりません。一部の特別な id は特別なスペース項目を作成するために使用されます:
-
separator: 区切り。垂直線として描画されます。 -
spacer: 固定幅のスペース。 -
spring: 伸縮自在のスペース。
メソッドは作成した項目の DOM 要素を返します。
[編集] スタイルクラス
- chromeclass-toolbar
- このクラスを使用した場合、window.open メソッドの
toolbarオプションに no を設定してウィンドウを開くと toolbar が隠されます。そうでない場合、このツールバーのオプションは無視され、常に toolbar が表示されます。
[編集] 関連項目
- 要素
- toolbarbutton, toolbargrippy, toolbaritem, toolbarpalette, toolbarseparator, toolbarset, toolbarspacer, toolbarspring, toolbox
- インタフェース
- nsIAccessibleProvider