Tabbrowser
This element is used for holding a set of read-only views of Web documents. Similar to the browser element, except that mutliple documents can be displayed, each in a separate tab. This element is implemented as a set of browser elements inside a tabbox.
この要素は一連の読み出し専用のウェブ文書の表示を保持するために利用される。複数の文書を別々のタブに表示できること以外は browser 要素と同様である。この要素は tabbox 要素内の一連の browser 要素として実装されている。
属性:
| autocompleteenabled | autocompletepopup | autoscroll | contentcontextmenu | contenttooltip |
| handleCtrlPageUpDown | onbookmarkgroup | onnewtab |
プロパティとメソッド:
属性:
XUL Element から継承:
align
allowevents
allownegativeassertions
class
coalesceduplicatearcs
collapsed
container
containment
context
contextmenu
datasources
debug
dir
empty
equalsize
flags
flex
height
hidden
id
insertafter
insertbefore
left
maxheight
maxwidth
menu
minheight
minwidth
mousethrough
observes
ordinal
orient
pack
persist
popup
position
ref
removeelement
sortDirection
sortResource
sortResource2
statustext
style
template
tooltip
tooltiptext
top
uri
wait-cursor
width
autocompleteenabled Firefox only
Type: boolean
Set to true to enable autocomplete of fields.
型 : boolean
true に設定すると、フィールドの自動補完が有効になる。
autocompletepopup
Type: id of popup element
The id of a popup element used to hold autocomplete results for the tabbrowser.
型 : id of popup element
タブブラウザの自動補完の結果を保持するのに使用されている popup 要素の id。
autoscroll Firefox only
Type: boolean
Set to false to disable autoscroll for this tabbrowser. If this attribute is set to true or omitted, autoscroll will be enabled or depending on the user preference 'general.autoScroll'.
型 : boolean
false に設定すると、この tabbrowser の autoscroll は無効になる。この属性を true に設定するか削除すると、 autoscroll は有効になるかまたはユーザ設定の 'general.autoScroll' に依存する。
contentcontextmenu
Type: id of a menupopup element
A reference to the context menu for the content area in the tabbrowser.
型 : id of a menupopup element
タブブラウザの内容エリアのコンテキストメニューの参照。
contenttooltip
Type: id of a tooltip element
A reference to the tooltip element to be used for the content area in the tabbrowser.
型 : id of a tooltip element
タブブラウザの内容エリアで使用される tooltip 要素の参照。
handleCtrlPageUpDown
Type: boolean
If set to true or omitted, the tabbrowser will switch to the next tab when the Control and Page Up or Page Down keys are pressed. If this attribute is set to false, these keys do not navigate between tabs.
型 : boolean
true に設定するか削除した場合、Control キーと Page Up または Page Down のキーを押すと次のタブに移動する。この属性を false に設定した場合、これらのキーによるタブ間の移動は行われない。
onbookmarkgroup Not in Firefox
Type: script code
This code executes when the user chooses the 'Bookmark This Group of Tabs' command.
型 : script code
ユーザが 'Bookmark This Group of Tabs' コマンドを選択したときに、このコードが実行される。
onnewtab Not in Firefox
Type: script code
This script will be called when the new tab button is clicked.
型 : script code
新規タブ作成ボタンをクリックしたときに、このスクリプトは呼ばれる。
プロパティとメソッド:
XUL Element から継承:
align
allowEvents
blur
boxObject
boxObject.element
boxObject.getLookAndFeelMetric
boxObject.height
boxObject.screenX
boxObject.screenY
boxObject.width
boxObject.x
boxObject.y
builder
className
click
collapsed
contextMenu
controllers
database
datasources
dir
doCommand
flex
focus
getElementsByAttribute
height
hidden
id
left
maxHeight
maxWidth
menu
minHeight
minWidth
observes
ordinal
orient
pack
persist
ref
resource
statusText
style
tooltip
tooltipText
top
width
Element から継承:
addEventListener
appendChild
attributes
childNodes
cloneNode
dispatchEvent
firstChild
getAttribute
getAttributeNS
getAttributeNode
getAttributeNodeNS
getElementsByTagName
getElementsByTagNameNS
hasAttribute
hasAttributeNS
hasAttributes
hasChildNodes
insertBefore
isSupported
lastChild
localName
namespaceURI
nextSibling
nodeName
nodeType
nodeValue
normalize
ownerDocument
parentNode
prefix
previousSibling
removeAttribute
removeAttributeNS
removeAttributeNode
removeChild
removeEventListener
replaceChild
setAttribute
setAttributeNS
setAttributeNode
setAttributeNodeNS
tagName
addProgressListener ( listener )
Return Type: no return value
Add a progress listener to the tabbrowser which will monitor loaded documents. The progress listener should implement the nsIWebProgressListener interface.
戻り値の型 : 戻り値なし
読み込んだ文書を監視するプログレスリスナを tabbrowser に追加する。プログレスリスナは nsIWebProgressListener インタフェイスを実装する必要がある。
addTab ( url )
Return Type: tab element
Displays a new tab loading the specified URL as the document. The row of tabs will appear if needed.
戻り値の型 : tab element
指定した URL を文書として読み込んだ新しいタブを表示する。必要であればタブ列が表示される。
appendGroup ( group ) Not in Firefox
Return Type: no return value
Add several new tabs to the end of the existing tabs. The argument should be an array of objects, one for each document to load. The objects may be defined in script and contain a 'URI' property for the URL of the page to load. A 'referrerURI' property may also be optionally used to set the referrer page.
戻り値の型 : 戻り値なし
既存のタブの末尾に新しいタブを追加する。引数はオブジェクトの配列であり、その一つ一つは読み込む文書である。オブジェクトはスクリプトで定義することができ、読み込むページの URL を示す 'URI' プロパティを持っている。オプションとして 'referrerURI' プロパティでリファラページを設定することもできる。
browsers
Type: nodelist of browser elements
Holds a list of the browser elements inside the tabbrowser.
型 : nodelist of browser elements
tabbrowser 要素内の browser 要素のリストを保持する。
canGoBack
Type: boolean
This read-only property is true if there is a page to go back to in the session history and the Back button should be enabled.
型 : boolean
セッション履歴に戻りのページがあり、「戻る (Back)」ボタンが有効になっているとき、この読み込み専用プロパティは true である。
canGoForward
Type: boolean
This read-only property is true if there is a page to go forward to in the session history and the Forward button should be enabled.
型 : boolean
セッション履歴に進むページがあり、「進む (Forward)」ボタンが有効になっているとき、この読み込み専用プロパティは true である。
contentDocument
Type: document
This read-only property contains the document object in the tabbrowser.
型 : document
この読み込み専用プロパティは、タブブラウザの文書オブジェクトを持つ。
contentTitle
Type: string
This read-only property contains the title of the document object in the tabbrowser.
型 : string
この読み込み専用プロパティは、タブブラウザの文書オブジェクトのタイトルを持つ。
contentViewerEdit
Type: nsIContentViewerEdit
This read-only property contains the nsIContentViewerEdit which handles clipboard operations on the document.
この読み込み専用プロパティは、文書のクリップボード操作を処理する nsIContentViewerEdit を持つ。
contentViewerFile
Type: nsIContentViewerFile
Reference to the nsIContentViewerFile interface for the document.
文書の nsIContentViewerFile インタフェースへの参照。
contentWindow
Type: window
This read-only property contains the window object in the tabbrowser.
型 : window
この読み込み専用プロパティは、タブブラウザの window オブジェクトを持つ。
currentURI
Type: string current URI
This read-only property contains the currently loaded URL. To change the URL, use the loadURI method.
型 : カレント URI の文字列
この読み込み専用プロパティは、現在読み込み済みの URL を持つ。 URL を変更するには、 loadURI メソッドを使用する。
docShell
Type: nsIDocShell
This read-only property contains the nsIDocShell object for the document.
型 : nsIDocShell
この読み込み専用プロパティは、文書の nsIDocShell オブジェクトを持つ。
documentCharsetInfo
Type: nsIDocumentCharsetInfo
This read-only property contains the nsIDocumentCharsetInfo object for the document which is used to handle which character set should be used to display the document.
この読み込み専用プロパティは、文書の nsIDocumentCharsetInfo オブジェクトを持つ。これは、文書を表示するにあたり、どの文字セットを使う必要があるのかを処理するのに用いられる。
getBrowserForTab ( tab )
Return Type: browser element
Returns a browser for specific tab element.
戻り値の型 : browser element
指定した tab 要素の browser 要素を返す。
goBack ( )
Return Type: no return value
Go back one page in the history.
戻り値の型 : 戻り値なし
履歴を 1 ページ戻る。
goBackGroup ( ) Not in Firefox
Return Type: no return value
Return to the previous group of tabs.
戻り値の型 : 戻り値なし
前のタブグループに戻す。
goForward ( )
Return Type: no return value
Go forward one page in the history.
戻り値の型 : 戻り値なし
履歴を 1 ページ進む。
goForwardGroup ( ) Not in Firefox
Return Type: no return value
Go forward to the next group of tabs.
戻り値の型 : 戻り値なし
次のタブグループに進む。
goHome ( )
Return Type: no return value
Load the user's home page into the tabbrowser.
戻り値の型 : 戻り値なし
ユーザのホームページをタブブラウザに読み込む。
gotoIndex ( index )
Return Type: no return value
Navigate to the page in the history with the given index. Use a positive number to go forward and a negative number to go back.
戻り値の型 : 戻り値なし
与えられたインデックスの履歴ページに移動する。正の値を与えると前進し、負の値を与えると戻る。
homePage
Type: string home page URL
This property holds the value of the user's home page setting.
型 : ホームページ URL の文字列
このプロパティは、ユーザのホームページ設定値を保持する。
loadGroup ( group ) Not in Firefox
Return Type: the first tab
Loads a group of pages into multiple tabs. They are either appended or replaced depending on the state of the preference 'browser.tabs.loadGroup'. The argument should be an array of objects, one for each document to load. The objects may be defined in script and contain a 'URI' property for the URL of the page to load. A 'referrerURI' property may also be optionally used to set the referrer page. This function returns a reference to the first tab loaded.
戻り値の型 : the first tab
複数のタブにページのグループを読み込む。 'browser.tabs.loadGroup' の設定状態に応じて、追加されたり置き換えられたりする。引数はオブジェクトの配列であり、その一つ一つは読み込む文書である。オブジェクトはスクリプトで定義することができ、読み込むページの URL を示す 'URI' プロパティを持っている。オプションとして 'referrerURI' プロパティでリファラページを設定することもできる。この関数は、読み込まれた最初の tab の参照を返す。
loadURI ( uri , referrer , charset )
Return Type: no return value
Load a URL into the document, with the given referrer and character set.
戻り値の型 : 戻り値なし
与えたリファラ (referrer)、文字セットで URL を文書に読み込む。
loadURIWithFlags ( uri , flags , referrer , charset )
Return Type: no return value
Load a URL into the document, with the specified load flags and the given referrer and character set. In addition to the flags allowed for the reloadWithFlags methods, the following flags are also valid:
- LOAD_FLAGS_IS_REFRESH: This flag is used when the URL is loaded because of a meta tag refresh or redirect.
- LOAD_FLAGS_IS_LINK: This flag is used when the URL is loaded because a user clicked on a link. The HTTP Referer header is set accordingly.
- LOAD_FLAGS_BYPASS_HISTORY: Do not add the URL to the session history.
- LOAD_FLAGS_REPLACE_HISTORY: Replace the current URL in the session history with a new one. This flag might be used for a redirect.
戻り値の型 : 戻り値なし
指定したロードフラグ、与えたリファラ (referrer)、文字セットで URL を文書に読み込む。reloadWithFlags メソッドに許されたフラグに加えて、以下のフラグも妥当です。
- LOAD_FLAGS_IS_REFRESH: meta タグの refresh や redirect のために URL が読み込まれるときに、このフラグは使用される。
- LOAD_FLAGS_IS_LINK: ユーザがリンクをクリックしたために URL が読み込まれるときに、このフラグは使用される。HTTP Referer ヘッダは自動的に設定される。
- LOAD_FLAGS_BYPASS_HISTORY: URL はセッション履歴に追加されない。
- LOAD_FLAGS_REPLACE_HISTORY: セッション履歴の現在の URL を新しいもので置き換える。このフラグはリダイレクトに対して用いられる。
markupDocumentViewer
Type: nsIMarkupDocumentViewer
This read-only property contains the nsIMarkupDocumentViewer which is responsible for drawing the document.
この読み込み専用プロパティは、文書の描画を担当する nsIMarkupDocumentViewer を持つ。
reload ( )
Reloads the document in the tabbrowser.
タブブラウザに文書を再読み込みする。
reloadAllTabs ( )
Return Type: no return value
Reloads the contents of all of the tabs.
戻り値の型 : 戻り値なし
全てのタブの内容を再読み込みする。
reloadTab ( tab )
Return Type: no return value
Reloads the contents of a specific tab.
戻り値の型 : 戻り値なし
指定したタブの内容を再読み込みする。
reloadWithFlags ( flags )
Return Type: no return value
Reloads the document in the tabbrowser with the given load flags. The flags listed below may be used, which are all constants of the webNavigation property (or the nsIWebNavigation interface). You may combine flags using a or symbol ( | )
- LOAD_FLAGS_NONE: No special flags. The document is loaded normally.
- LOAD_FLAGS_BYPASS_CACHE: Reload the page, ignoring if it is already in the cache. This is the flag used when the reload button is pressed while the Shift key is held down.
- LOAD_FLAGS_BYPASS_PROXY: Reload the page, ignoring the proxy server.
- LOAD_FLAGS_CHARSET_CHANGE: This flag is used if the document needs to be reloaded because the character set changed.
戻り値の型 : 戻り値なし
与えられたロードフラグでタブブラウザの文書を再読み込みする。以下にリストしたフラグを使うことができる。これらは全て、webNavigation プロパティ (あるいは nsIWebNavigation インタフェース) の定数である。論理和記号 ( | ) を使って、フラグを繋げることができる。
- LOAD_FLAGS_NONE: 特殊フラグなし。文書は普通に読み込まれる。
- LOAD_FLAGS_BYPASS_CACHE: キャッシュにすでにあるかどうかは無視して、ページを再読み込みする。Shift キーを押下したまま「再読み込み (Reload)」ボタンを押したときに使われるフラグである。
- LOAD_FLAGS_BYPASS_PROXY: プロキシサーバを無視して、ページを再読み込みする。
- LOAD_FLAGS_CHARSET_CHANGE: 文字セットが変更されたために文書が再読み込みされる必要があるときに、このフラグは使用される。
removeAllTabsBut ( tabElement )
Return Type: no return value
Removes all of the tab panels except for the one corresponding to the specified tab. If only one tab page is displayed, this method does nothing.
戻り値の型 : 戻り値なし
指定したタブに対応するパネルを除いて、全タブパネルを削除する。タブパネルが 1 つだけ表示されているときには、このメソッドは何も行わない。
removeCurrentTab ( )
Return Type: tab element
Removes the currently displayed tab page. If it is the only displayed tab, this method does nothing.
戻り値の型 : tab element
現在表示しているタブページを削除する。タブを 1 つだけ表示しているときには、このメソッドは何も行わない。
removeProgressListener ( listener )
Return Type: no return value
Remove a progress listener from the tabbrowser.
戻り値の型 : 戻り値なし
タブブラウザからプログレスリスナを削除する。
removeTab ( tabElement )
Return Type: no return value
Removes a specific tabbed page corresponding to the given tab element. If only one tab is displayed, this method does nothing. If needed, the row of tabs will collapse if only one tab remains.
戻り値の型 : 戻り値なし
渡した tab 要素に対応する特定のタブページを削除する。タブを 1 つだけ表示しているときには、このメソッドは何も行わない。必要であれば、タブを 1 つだけ残してタブ列が折りたたまれる。
replaceGroup ( group ) Not in Firefox
Return Type: array of session history objects
replaces existing tabs with a new set. If there were more tabs before, the additional ones are not removed. You can use the removeTab function to remove the existing tabs first if that is desired. The argument should be an array of objects, one for each document to load. The objects may be defined in script and contain a 'URI' property for the URL of the page to load. A 'referrerURI' property may also be optionally used to set the referrer page. This method returns an array of the session history objects for the tabs that were removed.
戻り値の型 : array of session history objects
既存のタブを新しいもので置き換える。元々のタブの数のほうが多ければ、余剰分は削除されない。必要であれば、 removeTab 関数を用いてあらかじめ既存のタブを削除することができる。引数はオブジェクトの配列であり、その一つ一つは読み込む文書である。オブジェクトはスクリプトで定義することができ、読み込むページの URL を示す 'URI' プロパティを持っている。オプションとして 'referrerURI' プロパティでリファラページを設定することもできる。このメソッドは、削除されたタブのセッション履歴オブジェクトの配列を返す。
securityUI
Type: nsISecureBrowserUI
The readonly property holds an object which may be used to determine the security level of the loaded document.
この読み込み専用プロパティは、読み込んだ文書のセキュリティレベルを決めるのに使われるオブジェクトを保持する。
selectedBrowser
Type: browser element
This readonly property returns the currently displayed browser element.
型 : browser element
この読み込み専用プロパティは、現在表示している browser 要素を返す。
selectedTab
Type: tab element
Holds the currently selected tab. You can modify this property to change the currently selected tab page.
型 : tab element
現在選択中のタブを保持する。このプロパティを変更することで、現在選択中のタブページを変更することができる。
sessionHistory
Type: nsISHistory
This read-only property contains the nsISHistory object which holds the session history.
型 : nsISHistory
この読み込み専用プロパティは、セッション履歴を保持する nsISHistory オブジェクトを持つ。
stop ( )
Return Type: no return value
Equivalent to pressing the Stop button, this method stops the currently loading document.
戻り値の型 : 戻り値なし
中止 (Stop) ボタンを押すのと等価である。このメソッドは現在読み込み中の文書を停止する。
tabContainer
Type: tabs element
Returns the tabs element that contains the tabs.
型 : tabs element
このタブを持つ tabs 要素を返す。
webBrowserFind
Type: nsIWebBrowserFind
This read-only property contains an nsIWebBrowserFind object which can be used to search for text in the document.
この読み込み専用プロパティは、文書内でテキストを検索するのに用いる nsIWebBrowserFind オブジェクトを持つ。
webNavigation
Type: nsIWebNavigation
This read-only property contains the nsIWebNavigation object for the document. Most of its methods are callable directly on the tabbrowser itself, such as goBack and goForward. It also contains the load constants used by reloadWithFlags and loadURIWithFlags.
型 : nsIWebNavigation
この読み込み専用プロパティは、文書の nsIWebNavigation オブジェクトを持つ。そのメソッドのほとんどは、goBack や goForward のようにタブブラウザ自身に直接呼ばれる。reloadWithFlags や loadURIWithFlags で用いられるロード定数も含んでいる。
webProgress
Type: nsIWebProgress
This read-only property contains an nsIWebProgress object which is used to monitor the progress of a document loading.
型 : nsIWebProgress
この読み込み専用プロパティは、文書の読み込みの進捗をモニタするのに使う nsIWebProgress オブジェクトを持つ。