我们可以用chrome.bookmarks模块来对书签做创建、组织等操作。
要对书签进行操作,必须要再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
由ChromeChina翻译,欢迎到dev.交流Chrome扩展开发技术。
|