--- title: fuelIBrowserTab slug: Toolkit_API/FUEL/fuelIBrowserTab tags: - FUEL - Interfaces - XPCOM - XPCOM API Reference translation_of: Mozilla/Tech/Toolkit_API/FUEL/fuelIBrowserTab ---

FUEL の BrowserTab オブジェクトは、ブラウザ内のタブを記述します。

メソッドの概要

void load(in nsIURI aURI)

void focus()

void close()

void moveBefore(in fuelIBrowserTab aBefore)

void moveToEnd()

プロパティ

プロパティ	型	説明
`uri`	`readonly attribute nsIURI`	このタブの現在の URI。
`index`	`readonly attribute PRInt32`	ブラウザウィンドウ内のこのタブの現在のインデックス。
`window`	`readonly attribute fuelIWindow`	このタブを有するブラウザウィンドウ。
`document`	`readonly attribute nsIDOMHTMLDocument`	ブラウザタブの内容ドキュメント【訳注: 原文は "content document"】。DOM リファレンスの Document オブジェクトを参照。
`events`	`readonly attribute fuelIEvents`	ブラウザタブに対するイベントオブジェクト。 "load" をサポート。

メソッド

load()

このブラウザタブに新しい URI を読み込む。

void load(
  in nsIURI aURI
);

引数

aURI: ブラウザタブに読み込む URI。

focus()

このブラウザタブにフォーカスを移し、前面に表示する。

void focus();

引数

なし。

close()

ブラウザタブを閉じる。スクリプトによって閉じる操作が中止される場合、実際には閉じない。

void close()

引数

None.

moveBefore()

このブラウザタブを同じウィンドウ内の別のブラウザタブの前の位置に移動する。

void moveBefore(
  in fuelIBrowserTab aBefore
);

引数

aBefore: 移動するタブの前にある移動先のタブ。

moveToEnd()

このブラウザタブを同じウィンドウの末尾へ移動する。

void moveToEnd();

引数

なし。

例

ウィンドウ内のタブに対して操作を繰り返す

この例は、現在アクティブなブラウザウィンドウ内のすべてのタブに対する操作を行い、各タブに対してアラートを表示します。

var activeWin = Application.activeWindow;

// アクティブなブラウザウィンドウ内に開かれた各タブを調べる
activeWin.tabs.forEach( function(tab) {
  alert(tab.uri.spec);
});

タブ内の Web コンテンツにアクセスする

この例は、アクティブなタブから HTML コンテンツを取得します。

// アクティブなタブの内容ドキュメントへアクセスする
alert(activeWin.activeTab.document.body.innerHTML);

新しいタブを開いてコンテンツを挿入する

この例は、アクティブなウィンドウ内に新しいタブを作成し、そのタブに何らかの HTML コンテンツを挿入します。

// 文字列から nsURI を生成するヘルパー
function url(spec) {
  var ios = Components.classes["@mozilla.org/network/io-service;1"].getService(Components.interfaces.nsIIOService);
  return ios.newURI(spec, null, null);
}

// 新しいタブを開き、内容を変更する
newTab = Application.activeWindow.open(url("about:blank"));
newTab.events.addListener("load", function() { newTab.document.body.innerHTML = "<H1>HelloWorld</H1>"; });