sogouExplorer.browserAction.基本上对应于chrome.browserAction.，其目的是在搜狗浏览器的“工具栏”上放置图标、文字、badge等信息，用户可以通过点击“工具栏”上的按钮来使用扩展的功能。

搜狗高速浏览器的工具栏 Image:toolbar.png

API参考： sogouExplorer.browserAction

方法

setBadgeBackgroundColor

sogouExplorer.browserAction.setBadgeBackgroundColor(object details)

  1.  设置工具栏上badge的背景颜色
  2.  
  3.  参数  
  4.  details( object )    
  5.    color( array of integer )
  6.      这个数组由4个数字组成，分别代表颜色中的RGBA，数字的范围在[0, 255]之间。每当指定了一个数组之后，badge的背
  7.      景色就会随之改变。例子：[255, 0, 0, 255]代表不透明的红色。
  8.    tabId ( 可选 integer )      
  9.      设置了这个可选参数之后，所有对于扩展图标的操作只有在指定的tab标签页被选中的时候才会被执行。而且当这个标签页
  10.      被关闭的时候，会恢复到之前的状态。

setBadgeText

sogouExplorer.browserAction.setBadgeText(object details)

  1.  设置工具栏上badge的文字
  2.  
  3.  参数 
  4.  details( object )  
  5.    text( string )      
  6.      所要显示的文字
  7.     tabId ( 可选 integer )      
  8.      设置了这个可选参数之后，所有对于扩展图标的操作只有在指定的tab标签页被选中的时候才会被执行。而且当这个标签页
  9.      被关闭的时候，会恢复到之前的状态。

setIcon

sogouExplorer.browserAction.setIcon(object details)

  1.  设置工具栏上的icon。
  2.  对于这个icon，既可以设置它的路径，也可以通过html5的canvas标签来设置。这两种方法必须要使用其中的一种。
  3.  
  4.  参数 
  5.  details( object )  
  6.    imageData( 可选 ImageData )      
  7.      图片的像素参数，必须是ImageData这个object。
  8.       (可以参考canvas这个标签)
  9.    path( 可选 string ) 
  10.      所要显示的图片的相对路径。    
  11.     tabId ( 可选 integer )      
  12.      设置了这个可选参数之后，所有对于扩展图标的操作只有在指定的tab标签页被选中的时候才会被执行。而且当这个标签页
  13.      被关闭的时候，会恢复到之前的状态。

setPopup

sogouExplorer.browserAction.setPopup(object details)

  1.  设置一个html页面，这个页面会在每次点击扩展图标的时候通过popup的方式显示出来。 
  2.  ！！！注意，当设置popup页面时，popup的宽和高必须要给出，否则无法设置成功。！！！
  3.  
  4.  参数 
  5.  details( object )  
  6.    popup( string )      
  7.       需要显示的html页面。如果设置为空，那么将不会有任何东西显示出来。如果设置为"!"，左键点击扩展时会弹出右键
  8.       菜单。
  9.    width( integer) 
  10.       popup页面的宽
  11.    height 
  12.       popup页面的高 ！！！注意，当设置popup页面时，popup的宽和高必须要给出，否则无法设置成功。！！！
  13.    tabId ( 可选 integer )      
  14.      设置了这个可选参数之后，所有对于扩展图标的操作只有在指定的tab标签页被选中的时候才会被执行。而且当这个标签页
  15.      被关闭的时候，会恢复到之前的状态。

showPopup

sogouExplorer.browserAction.showPopup()

  1.  打开扩展的popup，只能在ContextMenu点击时调用。

setTitle

sogouExplorer.browserAction.setTitle(object details)

  1.  设置扩展的名称，在工具栏上，鼠标在扩展图标上悬浮时，名称会显示在tooltip的第一行。  
  2.  
  3.  参数 
  4.  details( object )  
  5.    title( string )      
  6.       需要被显示出来的名称。
  7.     tabId ( 可选 integer )      
  8.      设置了这个可选参数之后，所有对于扩展图标的操作只有在指定的tab标签页被选中的时候才会被执行。而且当这个标签页
  9.      被关闭的时候，会恢复到之前的状态。

setDescription

sogouExplorer.browserAction.setDescription(object details) 

  1.  设置扩展的描述文字，在工具栏上，鼠标在扩展图标上悬浮时，描述文字会显示在tooltip的第二行

事件

onClicked

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

  1.  每当扩展被点击的时候，就会触发给定的方法。如果设置有popup，那么这个事件将不会被触发。
  2.  
  3.  参数 
  4.  tab( Tab ) 
  5.    标签页的信息。