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)

  1. 隐藏page action。
  2.  
  3. 参数 
  4. tabId( integer ) 
  5.   指定产生作用的标签页的ID。

setIcon

sogouExplorer.pageAction.setIcon(object details)

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

setPopup

sogouExplorer.pageAction.setPopup(object details)

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

setTitle

sogouExplorer.pageAction.setTitle(object details)

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

show

sogouExplorer.pageAction.show(integer tabId)

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

事件

onClicked

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

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