[译].Google Chrome extensions(实验室).界面.浏览器动作

使用浏览器动作向Google Chrome的主界面的工具栏(地址栏的右边)添加一个图标,除去图标还可以添加工具提示,标记和一个弹出面板

如下图所示:一个多彩的图标和下面弹出的面板。

browser-action

如果你想创建一个图标不是一直显示的扩展,使用页面动作代替浏览器动作吧。

Manifest

挂载你的浏览器动作的扩展,manifest文件的代码如下:

   1:  {
   2:    "name": "My extension",
   3:    ...
   4:    "browser_action": {
   5:      "default_icon": "images/icon19.png", // required
   6:      "default_title": "Google Mail",      // optional; shown in tooltip
   7:      "popup": "popup.html"                // optional
   8:    },
   9:    ...
  10:  }

UI的组成

一个浏览器动作必须有一个图标,可以附加工具提示,提示标记以及弹出面板。

  1. 图标:浏览器动作的图标宽高最大值为19像素,更大的图片会被调节缩小,建议最好使用一张19像素的方型图标。两种方式设置你的图标:图片或者HTML5的画布元素。简单的扩展图片更方便些,当然也可以使用更动态有生气的UI——运用画布元素。图片可以是任何WebKit支持的格式,包括BMP、GIF、JPEG、ICOPNG等等。如何设置图标?一是在manifest文件brower_action中写入default_icon属性,而是调用seticon()函数。
  2. 工具提示:如何设置工具提示的内容?一是在manifestbrower_action中填入default_title值,二是调用settitle()函数。你可以指定特定的语言环境,更多细节点击我
  3. 标记:浏览器动作可以显示一个标记——在图标上面的小文本。标记适合于显示小部分的扩展状态信息。由于标记栏大小受限,所以至多只可以显示4个字符。设置文本或者文本颜色可以分别调用setBadgeText()setBadgeBackgroundColor()。
  4. 弹出面板:当浏览器动作的扩展有一个popup的话,点击图标popup就会出现,弹出面板包含你喜欢的HTML内容,而且根据内容自动调节自己的大小。为扩展添加popup,创建一个HTML文件包含你想显示的内容,然后在manifest中设置,brower_actionpopup属性中。

提示

想有个好的外观,请遵循这些准则:

  • Do 需要在绝大多数页面上使用扩展的话,请使用浏览器动作。
  • Don’t 假若适合确定的少部分页面关联,请用页面动作。
  • Do 尽量用大的彩色的图标占满这个19X19像素的空间。浏览器动作的图标要不页面动作的图标要大些。
  • Don’t 模仿Chrome的“扳手”和“页面”图标。这样在其他主题下可能不是很显眼,所以图标还是要做得显眼一点。
  • Do 使用透明背景的图标,很多人都使用主题,所以你的图标应该在各种主题下面都要表现良好。
  • Don’t 不要总是更换图标,对用户不友好。

例子

你可以找到一些简单的浏览器动作的扩展点击examples/api/browserAction,其他例子或者查看源码获得帮助,请看示例

API参考:chrome.browerAction

方法

setBadgeBackgroundColor

   1:  chrome.browserAction.setBadgeBackgroundColor(object details)

设置标记的背景颜色。

参数

detail(object)

        color(array of integer)

         一个长度为四的整数数组,整数范围为[0,255],组成标记的背景颜色的RGBA,例如:不透明的红色[255,0,0,255]

        tabId(可选的 integer)

        特殊的标签出现的时候改变颜色,当标签关闭的时候会被重置。

setBadageText

   1:  chrome.browserAction.setBadgeText(object details)

设置标记文本的颜色。

参数

detail(object)

        text(string)

        虽然任何长度的字符都可以赋值,但是只显示最多四个字符。

        tabId(可选的 integer)

特殊的标签出现的时候改变颜色,当标签关闭的时候会被重置。

setIcon

   1:  chrome.browserAction.setIcon(object details)

设置图标,图片地址或者画布数据,不可为空。

参数

detail(object)

        imageData(可选的 imageDate)

        像素数据,必须是一个图数据对象。(例如:画布元素)。

        path(可选的 string)

        图标URL

        tabId(可选的 integer)

        特殊的标签出现的时候限制,当标签关闭的时候会被重置。

setTitle

   1:  chrome.browserAction.setTitle(object details)

设置工具提示。

参数

detail(object)

       title(string)

      鼠标滑过图标的时候显示的文本。

       tabId(可选的 integer)

       特殊的标签出现的时候限制,当标签关闭的时候会被重置。

事件(Event)

onClicked

   1:  chrome.browserAction.onClicked.addListener(function(Tab tab) {...});

 

图标被点击的时候触发动作

参数

tab(tab

目录:http://www.cnblogs.com/island205/articles/1688261.html

原文链接:http://code.google.com/chrome/extensions/browserAction.html

posted @ 2010-03-22 03:13  island205  阅读(2930)  评论(0编辑  收藏  举报