chrome扩展开发之旅 第三篇 - wilson's blog

第三章目录

• 3.1 CSS简述

• 3.2 Browser Actions

• 3.3 右键菜单

• 3.4 桌面提醒

• 3.5 omnibox

• 3.6 Page Actions

3.1 CSS简述

这部分对于前端的人来说是基础。就不说了

3.2 Browser Action

图标设置

chrome一般会选择19像素的图片显示在工具栏，但若用户使用视网膜屏幕的计算机，chrome则会选择38像
素的图片。两种图片并非都要指定，指定一个，浏览器页会自动拉伸图片适应显示需要，但是可能会很难看。

  "browser_action": {      "default_icon": {          "19": "images/icon19_0.png",  //键值名19与38并不指代像素，只是作者自己为了标示          "38": "images/icon38_0.png"   //chrome会自动识别像素，并予以选用      }    }

动态更改图标的方法
chrome.browserAction.setIcon(details,callback)

details的类型为对象，可以包含以下三种属性，分别是imagesData，path和tabId。

• imagesData说明
  imagesData的值既可以是imagesData也可以是对象。

{size:imagesData}
imagesData是指图片的像素数据，可以通过HTML的canvas标签获取。

• path说明
  path的值既可以是字符串也可以是对象，如果是对象，结构为{size：imagePath}

• tabId说明
  tabId的值限定了图标将在浏览哪个标签页时被更改。

• callback回调函数没有可接收的结果

popup页面

当用户点击扩展图标时，弹出的页面被成为popup页面。

popup页面更多的用来展示结构，而并非处理数据。因为关闭popup页面等于关闭了相应的标签页。页面不会
继续运行，等再次打开popup页面时，所有的Dom与js空间遍历都会重新创建。

如果需要实时处理数据，则需要创建一个在后端一直运行的页面或者脚本(同时记得在manifest.json的
background域来声明)

几个注意项：

• 给出页面尺寸

• 不要模仿Chrome的原生UI

• 使用带有滚动条的DIV容器

• 设计一个更好的滚动条样式

• 屏蔽右键菜单

• 使用外部引用脚本

• 不要在popup页面的js空间变量中保存数据

标题和badge

将鼠标移至扩展图片上，等待片刻就会显示扩展的title。
设置方式如下

  "browser_action": {      "default_title": "Turtle"  },

动态设置方法

chrome.browserAction.setTitle({title: 'This is a new title'});

badge常用来显示我们未阅读的数量等等，比如邮件，微博等。

设置方式

  chrome.browserAction.setBadgeBackgroundColor({color: '#0000ff'});  chrome.browserAction.setBadgeText({text: 'dog'});

注：背景颜色也可以用使用rgba。

2.3 右键菜单

首先，在manifest.json中的permissions域中声明contextMenus权限。

  "permissions": [    "contextMenus"  ]

第二步，设置右键菜单项上显示的扩展图标

  "icon": {    "16": "icon16.png"  }

三种操作方法：

• chrome.contextMenus.create()

• chrome.contextMenus.update()

• chrome.contextMenus.remove()
  举例如下:

    chrome.contextMenus.create({    type: 'normal',  //类型有normal,radio,checkbox,separator    title: 'menu A',    id: 'a', //标识每个选项    parentId: 'e',  //标示父级选项    contexts: ['link'] //完整的取值还有all,page,frame,selection,link,editable,           //image,video,audio,launcher。表示右键菜单显示的时机    });

update可以动态更改菜单属性，只需要指定需要更改的菜单id和所需要修改的属性即可，remove方法可以删
除指定的菜单栏选项。

3.4 桌面提醒

manifest部分

  "permissions": [    "notifications"  ];//manifest.json中声明  "web_accessible_resources": [  "icon48.png"  ]  //对于桌面窗口中显示的图片，需要先行声明

js部分

  var notification = webkitNotiofications.createNotiofication(    'icon48.png',    'Notiofication Demo',    'Merry Christmas'    ); //建立一个提醒  notification.show();//创建之后不会立即显示，需要调用show

4种事件

• ondisplay

• onerror

• onclose

• onclick
  除此之外，还可以通过notification.cancel()主动关闭提醒窗口

omnibox

什么是omnibox呢，就是chrome 的地址栏，其实这是一个多功能输入框，google称之为omnibox。Google
已经将omnibox的权限开放了。

"omnibox": { "keyword": "hamster"} //首先在manifest.json声明并指定keyword

omnibox有4种事件

• chrome.omnibox.onInputStarted

• chrome.omnibox.onInputChanged

• chrome.omnibox.onInputEntered

• chrome.omnibox.onInputCancelled

Page Actions

Page Actions 与BrowserAction非常相似，除了没有badge意外，后者拥有的方法前者都有。另一个区别
在于，前者图标并非一直显示。所有前者可以自由控制显示或者隐藏，如下。

  chrome.pageAction.show(tabId);  chrome.pageAction.hide(tabId);

制作实时查询美元价格的扩展

js代码部分

  function httpRequest(url, callback){      var xhr = new XMLHttpRequest();      xhr.open("GET", url, true);      xhr.onreadystatechange = function() {          if (xhr.readyState == 4) {  callback(xhr.responseText);          }      }      xhr.send();  }  function updateAmount(amount, exchange){      amount = Number(amount);      if(isNaN(amount) || !amount){          exchange([{  'content': '$1 = ￥'+price,  'description': '$1 = ￥'+price          },{  'content': '￥1 = $'+(1/price).toFixed(6),  'description': '￥1 = $'+(1/price).toFixed(6)          }]);      }      else{          exchange([{  'content': '$'+amount+' = ￥'+(amount*price).toFixed(2),  'description': '$'+amount+' = ￥'+(amount*price).toFixed(2)          },{  'content': '￥'+amount+' = $'+(amount/price).toFixed(6),  'description': '￥'+amount+' = $'+(amount/price).toFixed(6)          }]);      }  }  function gotoYahoo(text, disposition){      window.open('http://finance.yahoo.com/q?s=USDCNY=X');  }  var url = 'http://query.yahooapis.com/v1/public/yql?q=select%20Rate%20from%20yahoo.finance.xchange%20where%20pair%20in%20(%22USDCNY%22)&env=store://datatables.org/alltableswithkeys&format=json';  var price;  httpRequest(url, function(r){      price = JSON.parse(r);      price = price.query.results.rate.Rate;      price = Number(price);  });  chrome.omnibox.setDefaultSuggestion({'description':'Find current USD price.'});  chrome.omnibox.onInputChanged.addListener(updateAmount);  chrome.omnibox.onInputEntered.addListener(gotoYahoo);

manifest部分

  {      "manifest_version": 2,      "name": "USD Price",      "version": "1.0",      "description": "查询美元当日价格",      "background": {          "scripts": [  "js/background.js"          ]      },      "icons": {          "16": "images/icon16.png"      },      "omnibox": {          "keyword": "usd"      },      "permissions": [          "*://query.yahooapis.com/*"      ]  }

图片请自行选用。
扩展使用方法：载入扩展之后，在浏览器地址栏输入"usd"，然后按空格键或者Tab键就可以使用了。