Manipulating bookmarks using Places

この記事は Firefox 3 の新機能について述べています

ブックマークサービスの初期化

他の多くのインタフェースと同様に、ブックマークサービスを利用するには、まず以下のようにしてアクセスを取得する必要があります。

var bmsvc = Components.classes["@mozilla.org/browser/nav-bookmarks-service;1"]
                      .getService(Components.interfaces.nsINavBookmarksService);

ブックマークフォルダの新規作成

新しいブックマークフォルダの作成は createFolder() メソッドを使って行います。例えば、ブックマークメニューに新しいフォルダを作成するには、以下のように記述します。

var menuFolder = bmsvc.bookmarksMenuFolder; // ブックマークメニューフォルダ
var newFolderId = bmsvc.createFolder(menuFolder, "Folder name here", -1);

このコードでは、ブックマークメニューフォルダを特定し、それからそのフォルダに「Folder name here」という名前の新しいフォルダを作成しています。フォルダを挿入するインデックスとして -1 を指定することで、ブックマークのリストの最後にフォルダが置かれます。

このコードのうち、bookmarksMenuFolder を toolbarFolder に変更すれば、ブックマークツールバー上に簡単に新しいフォルダを挿入できます。

ブックマークの新規作成

新しいブックマーク作成には insertBookmark() を使用します。ブックマークの URI は nsIURI オブジェクトを使って指定する必要があります。

var ios = Components.classes["@mozilla.org/network/io-service;1"]
                    .getService(Components.interfaces.nsIIOService);
var uri = ios.newURI("http://google.com/", null, null);
var newBkmkId = bmsvc.insertBookmark(newFolderId, uri, -1, "");

この例では、IO サービスをインスタンス化し、それを使って Google の Web サイトを参照する nsIURI を作成した上で、insertBookmark() を呼び出して Google のブックマークを作成し、それを newFolderId によって参照されているブックマークフォルダの最後に配置しています。

ブックマークアイテムの検索

サイトの URI を知っていて、それを指しているすべてのブックマークを検索したい場合は、getBookmarkIdsForURI() メソッドを使います。

var ios = Components.classes["@mozilla.org/network/io-service;1"]
                    .getService(Components.interfaces.nsIIOService);
var uri = ios.newURI("http://google.com/", null, null);
var bookmarksArray = bmsvc.getBookmarkIdsForURI(uri, {});

このコードを実行すると、bookmarksArray という配列には、指定した URI (この場合は "http://google.com") を参照しているすべてのブックマークの ID が含まれます。

既存アイテムの操作

既存のブックマークやブックマークフォルダに変更を加えるために使える便利なメソッドがいくつもあります。この章ではそのうちのいくつかを取り上げます。

bmsvc.setItemTitle(newBkmkId, "New title");

var thisTitle = bmsvc.getItemTitle(newBkmkId);
alert(thisTitle);

var thisURI = bmsvc.getBookmarkURI(newBkmkId);
alert(thisURI.spec);

uri = ios.newURI("http://mozilla.com/", null, null);
bmsvc.changeBookmarkURI(newBkmkId, uri);

ある URI がブックマークされているかどうかの確認

例えば、既にブックマークされているサイトに対して新しいブックマークを作成するのを避けたい場合など、特定の URI が既にブックマークされているかどうかを確認するには、isBookmarked() メソッドを使います。

var ios = Components.classes["@mozilla.org/network/io-service;1"]
                    .getService(Components.interfaces.nsIIOService);
var uri = ios.newURI("http://mozilla.com/", null, null);
if (!bmsvc.isBookmarked(uri)) {
  bmsvc.insertBookmark(bmsvc.toolbarFolder, uri, -1, "Mozilla");
}

この例では、ユーザが既に Mozillla の Web サイトをブックマークしていないかどうかを確認し、もしされていない場合は作成して、ブックマークツールバー上に追加しています。

あるアイテムを含むフォルダの検索

あるアイテムが含まれるフォルダを知りたい場合は (これは getBookmarkIdsForURI() を使って特定の URI のブックマークを探した後などに特に便利な機能でしょう)、getFolderIdForItem() メソッドを使います。

var parentFolderId = bmsvc.getFolderIdForItem(newBkmkId);

関連記事

• nsINavBookmarksService
• nsINavBookmarkObserver
• Places