作者：玄魂

出处：http://www.cnblogs.com/xuanhun/

目录

  • 9.1 Tray简介
  • 9.2 tray的属性
  • 9.3 tray 的构造函数
  • 9.4 初始化一个tray
  • 9.5 删除tray
  • 9.6 小结

9.1 Tray简介

Tray在不同的平台下的展现形式不一样，通常以一个ICON的形式展现在操作系统状态通知的位置。在Mac下称之为Status Item，GTK环境下称为Status Icon，windows叫系统托盘。

新建tray.html 和package.json作为本文的示例程序。

tray.html内容如下：

  1. <html>
  2. <head>
  3. <title>trayDemo</title>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5. </head>
  6. <body >
  7. <h1>Tray 测试</h1>
  8. <script>
  9.     // Load native UI library
  10.     var gui = require('nw.gui');
  11. </script>
  12. </body>
  13. </html>

package.json内容如下：

  1. {
  2.     "name": "tray-demo",
  3.     "main": "tray.html",
  4.     "nodejs":true,
  5.     "window": {
  6.         "title": "trayDemo",
  7.         "toolbar": true,
  8.         "width": 800,
  9.         "height": 600,
  10.         "resizable":true,
  11.         "show_in_taskbar":true,
  12.         "frame":true,
  13.         "kiosk":false,
  14.         "icon": "2655716405282662783.png"
  15.     },
  16.     "webkit":{
  17.         "plugin":true
  18.     }
  19. }

9.2 tray的属性

Tray包含title、tooltip、icon、menu、alticon五个属性。

title属性只在mac系统下有效，会和icon图标一起显示在状态栏。

tooltip是当鼠标移动到tray上方时显示的提示语，在所有平台下都有效。

icon是tray显示在托盘中的图标。

menu是托盘中的菜单，是一个 gui.Menu对象（参考：node-webkit教程6native-ui-api-之menu菜单）。

alticon只有在mac下起作用，配置切换效果icon图标。

9.3 tray 的构造函数

  1. new Tray(option)

option中用来初始化tray的属性值，但是只能配置title, tooltip, icon 和menu四个属性。如：

  1. var tray = new gui.Tray({ title: 'Tray', icon: 'img/icon.png' });

所有的属性都可以通过对象直接获取或赋值，如：

  1. tray.menu = menu;

9.4 初始化一个tray

现在我们修改tray.html：

  1. <script>
  2.     var isShowWindow = true;
  3.     // Load native UI library
  4.     var gui = require('nw.gui');
  5.     var win = gui.Window.get();
  6.     var tray = new gui.Tray({ title: '玄魂的软件', icon: '2655716405282662783.png' });
  7.     tray.tooltip = '点此打开';
  8.     //添加一个菜单
  9.     var menu = new gui.Menu();
  10.     menu.append(new gui.MenuItem({ type: 'checkbox', label: '选择我' }));
  11.     tray.menu = menu;
  12.     //click事件
  13.     tray.on('click', function() {
  14.         if(isShowWindow)
  15.         {
  16.             win.hide();
  17.             isShowWindow = false;
  18.         }
  19.         else
  20.         {
  21.             win.show();
  22.             isShowWindow = true;
  23.         }
  24.     });
  25. </script>

运行效果如下：

2.9. node-webkit教程(9) native api 之Tray(托盘) - 图1

2.9. node-webkit教程(9) native api 之Tray(托盘) - 图2

点击托盘中的图标程序的窗体会相应的隐藏或者显示。

9.5 删除tray

很可惜的是，现在还没有办法临时隐藏Tray，只能删除它。

在删除需要调用remove方法，然后设置为null。如：

  1. tray.remove();
  3. tray = null;

9.6 小结

本文内容主要参考node-webkit的官方英文文档，做了适当的调整（https://github.com/rogerwang/node-webkit/wiki/Tray）。

下一篇文章，介绍Tray。