Skip to content
2010年10月4日 / island205

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

页面动作

页面动作可以把图标放在地址栏里面,但不是所有的页面地址栏都会显示该图标,只有特定的页面才会。几个例子:

  • 订阅该页的RSS源
  • 旁边显示该网页上的图片

下图中的RSS图标表示你可以订阅当前的页面的RSS源。

page-action

如果你想要不会消失的图标,请用浏览器动作吧。

Manifest

如下在manifest文件中注册你的页面动作

   1:  {
   2:    "name": "My extension",
   3:    ...
   4:    "page_action": {
   5:      "default_icon": "icons/foo.png", // required
   6:      "default_title": "Do action",    // optional; shown in tooltip
   7:      "default_popup": "popup.html"    // optional
   8:    },
   9:    ...
  10:  }
 

UI

像浏览器动作一样,页面动作也有图标、工具提示和popup,没有标记。然而页面动作的图标可以隐藏起来。你可以阅读浏览器动作UI获得更多有关图标、工具提示和popup的信息。

你可用show()hide()方法来显示和隐藏页面动作图标。默认情况下图标是隐藏的。你需要设置在那些标签下显示图标,直到标签关闭或者用户请求了新的URL(比如单击了某个链接)图标才会消失。

提示

遵循下面这些原则,展示更好的效果。

  • Do 扩展只针对部分网页的话,使用页面动作比较好
  • Don’t 扩展针对绝大部分网页的时候不要使用页面动作,请使用浏览器动作
  • Do 图标要比浏览器动作的图标稍微亮些,大部分Chrome的图标要比19pixels少小一点,要用边框的话,尽量做成模糊的阴影。
  • Don’t 图标不要频繁变化,以免误导用户

示例

examples/api/pageAction链接有页面动作的插件示例。更多的示例帮助或源码请到Samples去看。

API参考:chrome.pageAction

方法

hide

   1:  chrome.pageAction.hide(integer tabId)

隐藏页面图标

参数

tabId(integer)

你想修改的页面的Id。

setIcon

   1:  chrome.pageAction.setIcon(object details)

设置页面动作的图标。可以指定图片的路径或者画布元素的像数信息。但必须指定值。

参数

details(object)

  • tabId(integer):你想修改页面动作的标签的Id
  • imageData(optional ImageData):图片像数数据,必须是图片数据。(例如一个画布元素)
  • path(optional string):图片位于扩展下的相对路径
  • iconIndex(optional integer):已过时,指定在位于manifest中的icons向量的基值。

setPopup

   1:  chrome.pageAction.setPopup(object details)

 

 

 

 

配置用户点击按钮是可弹出的popup html文件。

参数

details(object)

  • tabId(integer):你想修改页面动作的标签的Id
  • popup(string):作为popup的html文件路径,若为””则是无popup

setTitle

   1:  chrome.pageAction.setTitle(object details)

 

设置页面动作的标题,在页面上显示一个工具提示。

参数

details(object)

  • tabId(integer):你想修改页面动作的标签的Id
  • title(string):工具提示字符串

show

   1:  chrome.pageAction.show(integer tabId)

显示页面动作。

参数

  • tabId(integer):你想修改页面动作的标签的Id

事件

onClicked

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

 

页面动作图标被点击是触发。但假若有popup页的话将不会触发此事件。

参数

主目录:http://www.cnblogs.com/island205/archive/2010/03/17/1688261.html

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

Advertisements

发表评论

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / 更改 )

Twitter picture

You are commenting using your Twitter account. Log Out / 更改 )

Facebook photo

You are commenting using your Facebook account. Log Out / 更改 )

Google+ photo

You are commenting using your Google+ account. Log Out / 更改 )

Connecting to %s

%d 博主赞过: