Chrome扩展开发教程(八)Bookmarks(书签操作)

我们可以用chrome.bookmarks模块来对书签做创建、组织等操作。

       bookmarks.png

Manifest

要对书签进行操作,必须要再Manifest文件中设置允许调用书签接口(bookmarks API)。一般像下面这样写:

{

  "name": "My extension",

  ...

  "permissions": [

    "bookmarks"

  ],

  ...

}

书签对象和属性

书 签以树形机构组织,节点或是一个书签或者是个文件夹(可以包含多个书签)。每个节点都是一个BookmarkTreeNode对象。 BookmarkTreeNode对象在接口中会常常用到。比如我们调用create()来创建书签的时候,我们要传递一个这个新节点的父节点 (parentId属性),另外还可以传递index(兄弟节点中的排序,0开始), title(标题), url(地址)。


例子

下面代码调用create()创建了一个书签文件夹取名“Extension bookmarks”,第一个参数是个json格式的对象,第二个参数定义了一个函数,这个函数将在创建完书签后调用。

    chrome.bookmarks.create({'parentId': bookmarkBar.id,
                             'title': 'Extension bookmarks'},
                            function(newFolder) {
      console.log("added folder: " + newFolder.title);
    });

下面的例子里创建了一个指向这份开发文档的书签。这代码里面没有定义回调函数(callback function).

    chrome.bookmarks.create({'parentId': extensionsFolderId,
                             'title': 'Extensions doc',
                             'url': 'http://code.google.com/chrome/extensions'});

更多操作书签的例子可见在basic bookmarks sample找到。

有关BookmarkTreeNode对象的完整定义以及所有的书签函数可以点击这里查看,这部分的内容计划放到最后翻译。

本文翻译自http://code.google.com/chrome/extensions/bookmarks.html

来源:http://dev.chromechina.com/thread-2811-1-1.html

加支付宝好友偷能量挖...


评论(0)网络
阅读(92)喜欢(0)JavaScript/Ajax开发技巧