首页 > 代码库 > chrome插件编写之新版hello world

chrome插件编写之新版hello world

   编写chrome插件之前,需要熟悉一下相应的chrome插件开发环境。从编写hello world开始,参考阅读官方的教程,是一个不错的选择。这里主要是基于chrome的官方教程,稍稍做了一些修改和扩充,总结成了如下的几个部分。

    在chrome中编写插件和写网页应用基本一致,采用的是javascript+css+html的方式。所以对于用过chrome浏览器审阅过一些网页的源码,写过网页或者脚本的人而言,编写chrome的插件感觉到还是比较熟悉的。

一、chrome插件和用户的几种交互方式

   比较常见的插件形式是:

   1.browser action:即在浏览器的右上角有一个新增的显示插件图标的按钮,用户点击该按钮即可以触发插件的应用逻辑;

   2.backgroud javascript:这种情况下插件没有对应的图标和按钮,在chrome启动时,插件运行在自己的单独的背景线程中。与用户的交互方式通常是在某些相关网页加载完之后,通过javascript对该网页进行修改,将插件逻辑嵌入到页面html代码中。

   3.page action:这种插件形式在需要时在浏览器地址栏中弹出一个图标。

   更多:见Developer‘s Guide - Google Chrome

二、通过browser action实现hello world

2.1 程序的文件清单

   先来看看hello world插件的文件清单,如下图所示。其中icon.png用于图标的显示,manifest.json是chrome 插件的基本配置文件,popup.html用于下拉菜单的构建,popup.js是和popup.html对应的js文件。

   

 

 

 

 

2.2 manifest.json文件

{"manifest_version":2,"name":"one-click hello_world","description":"my first chrome extension-browser action","version":"1.0","permissions":[    "https://*/*",    "http://*/*"    ],"browser_action":{    "default_icon":"icon.png",    "default_popup":"popup.html"    }}

   manifest.json是chrome插件的配置文件,其基本内容如上所示。"manifest_version"字段默认设置为2。permissions字段设置了插件的基本权限,即具有访问所有http链接的权限。browser_action字段中default_icon和default_popup分别和之前的icon.png,popup.html文件相对应。

2.3 popup.html

<!doctype html><html>  <head>    <title>Hello World</title>    <style>      body {        min-width: 100px;        overflow-x: hidden;      }      img {        margin: 5px;        border: 2px solid black;        vertical-align: middle;        width: 75px;        height: 75px;      }    </style>    <!--      - JavaScript and HTML must be in separate files: see our Content Security      - Policy documentation[1] for details and explanation.      -      - [1]: http://developer.chrome.com/extensions/contentSecurityPolicy.html     -->  </head>  <body>  <p id="p1">Hello World-1</p>  <p id="p2">Hello World-2</p>  <script src="http://www.mamicode.com/popup.js"></script>  </body></html>

   popup.html中有两个分别为p1和p2的标签,其中p1标签中原有的内容是Hello World-1,p2标签中原有的内容是Hello World-2。在popup.js中通过代码将标签1的内容修改为了Hello New World。

2.4 popup.js

document.getElementById("p1").innerHTML="Hello New World"

2.5 将插件安装到chrome浏览器中

2.5.1进入extension页面扩展程序

2.5.2勾选开发者模式

2.5.3将包含源码的目录直接拖入extension页面,完成安装。点击重新加载可以更新。

2.5.4运行,并看到了popup.html页面的正确显示且被popup.js所修改

三、通过backgroud javascript实现hello world!

目标:打开http://www.baidu.com/时,弹出hello world的提示框

3.1文件清单

3.2manifest.json文件

{"manifest_version":2,"name":"one-click hello_world","description":"my first chrome extension-background","version":"1.0","permissions":[    "tabs",    "https://*/*",    "http://*/*"    ],"background": {    "scripts": ["bg.js"],    "persistent": false  }}

   permission字段中,新增“tabs”属性,后面需要通过tab来获得当前页面的url。background字段中指明了需要在后台运行的bg.js

3.3 bg.js

console.log("background")chrome.tabs.onUpdated.addListener(function(tabId , info) {    if (info.status == "complete") {        chrome.tabs.query({‘active‘: true, ‘lastFocusedWindow‘: true}, function (tabs) {            var url = tabs[0].url;            console.log(url)            if(url=="http://www.baidu.com/"){                chrome.tabs.executeScript(null,{code:‘alert("Hello World!")‘});            }        });    }});

   bg.js中注册了tabs的监听器,在当前页面加载完整之后检查当前页面链接是否是http://www.baidu.com/,并执行相应操作。

3.4 执行后的效果

四、通过page action实现hello world!

4.1 目标

   访问http://www.baidu.com,在地址栏的右侧出现page action的图标,点击弹出html页面

4.2文件清单

4.3manifest.json

{"manifest_version":2,"name":"one-click hello_world","description":"my first chrome extension-background","version":"1.0","permissions":[    "tabs",    "http://*/*"    ],"background": {    "scripts": ["bg.js"],    "persistent": false},"page_action": {    "default_name": "Hello world",    "default_icon": "marker.png",    "default_popup": "popup.html"    }}

   新增了page_action字段,指定了page action的图标和下拉html。

4.4 bg.js

console.log("background")chrome.tabs.onUpdated.addListener(function(tabId , info) {    if (info.status == "complete") {        chrome.tabs.query({‘active‘: true, ‘lastFocusedWindow‘: true}, function (tabs) {            var url = tabs[0].url;            console.log(url)            if(url=="http://www.baidu.com/"){                chrome.pageAction.show(tabs[0].id)            }        });    }});

   page action默认不做显示,当页面url=="http://www.baidu.com/",通过api chrome.pageAction.show显示page action

4.5 访问http://www.baidu.com,查看运行效果

4.6page action和browser action的对比

   page action适用于插件仅针对少数页面的情况,browser action则主要适用于插件对大部分页面都有效的情况。就能够实现的功能而言是基本一致的。二者对比可以进一步参见[4]

六、参考材料

[1]Getting Started: Building a Chrome Extension - Google Chrome

[2]How can I get the URL for a Google Chrome tab? - Stack Overflow

[3]Chrome extensions : How to know when a tab has finished loading, from the background page - Stack Overflow

[4]chrome.pageAction - Google Chrome

[5]Sample Extensions - Google Chrome

chrome插件编写之新版hello world