开发者文档
sogouExplorer.pageAction

sogouExplorer.pageAction.* 对应Chrome扩展的 chrome.pageAction.* (请参考 http://code.google.com/chrome/extensions/pageAction.html )

page actions可以用来把icon放置在地址栏上。page sctions可以对当前页面产生作用,但并不一定对所有页面都有效。

如果你希望扩展的icon永远都可见,那么请使用SogouExplorer.browserAction

API参考:sogouExplorer.pageAction

方法

hide

sogouExplorer.pageAction.hide(integer tabId)

隐藏page action。
 
参数 
tabId( integer ) 
  指定产生作用的标签页的ID。


setIcon

sogouExplorer.pageAction.setIcon(object details)

设置page action的icon。对于这个icon,既可以设置它的路径,也可以通过html5的canvas标签来设置。这两种方法必须要
使用其中的一种。
 
参数 
details( object ) 
  tabId( integer ) 
    指定产生作用的标签页的ID。
  imageData( 可选 ImageData ) 
    图片的像素参数,必须是ImageData这个object。
    (可以参考canvas这个标签)。
  path( 可选 string ) 
    图片的相对路径。
  iconIndex( 可选 integer ) 
    不推荐使用。指定要显示的icons的顺序。


setPopup

sogouExplorer.pageAction.setPopup(object details)

设置一个html文档,当用户点击page action的icon的时候,这个html将会以popup的方式显示出来。
 
参数 
details( object ) 
  tabId( integer ) 
    指定产生作用的标签页的ID。
  popup( string ) 
    html文档的路径。如果设置成空值,那么将不会有任何东西显示出来。
  width( integer ) 
    popup窗口的宽度
  height( integer ) 
    popup窗口的高度


setTitle

sogouExplorer.pageAction.setTitle(object details)

设置page action的title。这个title将会在鼠标悬浮在icon上方的时候以tooltip的方式显示出来。
 
参数 
details( object ) 
  tabId( integer ) 
    指定产生作用的标签页的ID。
  title( string ) 
    title的文字。


show

sogouExplorer.pageAction.show(integer tabId)

显示page action。每当标签页被选中的时候page action就会显示出来。
 
参数 
tabId( integer ) 
  指定产生作用的标签页的ID。


事件

onClicked

sogouExplorer.pageAction.onClicked.addListener(function(Tab tab) {...});

每当page action被点击的时候这个方法将会被触发。如果page action含有popup,那么这个方法将不会被触发。
 
参数 
tab( Tab ) 
  详见Tab。