[译].Google Chrome extensions（实验室）.界面.页面动作
2010-04-01 22:22
190 查看
页面动作
页面动作可以把图标放在地址栏里面，但不是所有的页面地址栏都会显示该图标，只有特定的页面才会。几个例子：
订阅该页的RSS源
旁边显示该网页上的图片
下图中的RSS图标表示你可以订阅当前的页面的RSS源。
如果你想要不会消失的图标，请用浏览器动作吧。
Manifest
如下在manifest文件中注册你的页面动作
[code]"name":"Myextension",
[/code]
UI
像浏览器动作一样，页面动作也有图标、工具提示和popup，没有标记。然而页面动作的图标可以隐藏起来。你可以阅读浏览器动作UI获得更多有关图标、工具提示和popup的信息。
你可用show()和hide()方法来显示和隐藏页面动作图标。默认情况下图标是隐藏的。你需要设置在那些标签下显示图标，直到标签关闭或者用户请求了新的URL（比如单击了某个链接）图标才会消失。
提示
遵循下面这些原则，展示更好的效果。
Do扩展只针对部分网页的话，使用页面动作比较好
Don't扩展针对绝大部分网页的时候不要使用页面动作，请使用浏览器动作。
Do图标要比浏览器动作的图标稍微亮些，大部分Chrome的图标要比19pixels少小一点，要用边框的话，尽量做成模糊的阴影。
Don't图标不要频繁变化，以免误导用户
示例
examples/api/pageAction链接有页面动作的插件示例。更多的示例帮助或源码请到Samples去看。
API参考：chrome.pageAction
方法
hide
隐藏页面图标
参数
tabId(integer)
你想修改的页面的Id。
页面动作可以把图标放在地址栏里面，但不是所有的页面地址栏都会显示该图标，只有特定的页面才会。几个例子：
订阅该页的RSS源
旁边显示该网页上的图片
下图中的RSS图标表示你可以订阅当前的页面的RSS源。
如果你想要不会消失的图标，请用
Manifest
如下在manifest文件中注册你的页面动作
{[code]"name":"Myextension",
...
"page_action":{"default_icon":"icons/foo.png",//required
"default_title":"Doaction",//optional;shownintooltip
"default_popup":"popup.html"//optional
},
...
}
[/code]
UI
像浏览器动作一样，页面动作也有图标、工具提示和popup，没有标记。然而页面动作的图标可以隐藏起来。你可以阅读
你可用show()和hide()方法来显示和隐藏页面动作图标。默认情况下图标是隐藏的。你需要设置在那些标签下显示图标，直到标签关闭或者用户请求了新的URL（比如单击了某个链接）图标才会消失。
提示
遵循下面这些原则，展示更好的效果。
Do扩展只针对部分网页的话，使用页面动作比较好
Don't扩展针对绝大部分网页的时候不要使用页面动作，请使用
Do图标要比浏览器动作的图标稍微亮些，大部分Chrome的图标要比19pixels少小一点，要用边框的话，尽量做成模糊的阴影。
Don't图标不要频繁变化，以免误导用户
示例
API参考：chrome.pageAction
方法
hide
chrome.pageAction.hide(integertabId)
隐藏页面图标
参数
tabId(integer)
你想修改的页面的Id。
setIcon
chrome.pageAction.setIcon(objectdetails)
设置页面动作的图标。可以指定图片的路径或者画布元素的像数信息。但必须指定值。
参数
details（object）
tabId(integer):你想修改页面动作的标签的Id
imageData（optionalImageData）：图片像数数据，必须是图片数据。（例如一个画布元素）
path（optionalstring）：图片位于扩展下的相对路径
iconIndex（optionalinteger）：已过时，指定在位于manifest中的icons向量的基值。
setPopup
chrome.pageAction.setPopup(objectdetails)
配置用户点击按钮是可弹出的popuphtml文件。
参数
details（object）
tabId(integer):你想修改页面动作的标签的Id
popup(string):作为popup的html文件路径，若为””则是无popup
setTitle
chrome.pageAction.setTitle(objectdetails)
设置页面动作的标题，在页面上显示一个工具提示。
参数
details(object)
tabId(integer):你想修改页面动作的标签的Id
title(string):工具提示字符串
show
chrome.pageAction.show(integertabId)
显示页面动作。
参数
tabId(integer):你想修改页面动作的标签的Id
事件
onClicked
chrome.pageAction.onClicked.addListener(function(Tabtab){...});页面动作图标被点击是触发。但假若有popup页的话将不会触发此事件。
参数
tab(
