node-webkit教程(5)Native UI API 之Frameless window

作者:玄魂

来源:nnode-webkit教程(5)Native UI API 之Frameless window

5.1 Frameless window 概述

Frameless window,是没有操作系统默认样式的边框的窗口,也就意味着最大、最小和关闭按钮也访问不到,同时默认情况下窗口不能被拖拽。

node webkit学习(2)基本结构和配置一文中,介绍frame属性时,给出了一个简单示例,本篇文章以该示例为基础进行扩展。

Frameless window的使用场景,通常是我们需要自定义标题栏,窗口边框样式和按钮的时候。

首先创建示例程序文件,framelessDemo.html和package.json。

framelessDemo.html代码如下:

  1. <html>
  2. <head>
  3. <title>frame less windowdemo</title>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5. </head>
  6. <body >
  7. <h1>frameless window 测试</h1>
  8. <script>
  9. var gui = require('nw.gui');
  10. </script>
  11. </body>
  12. </html>

package.json内容如下:

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

运行程序,效果如下:

2.5. node-webkit教程(5) Native UI API 之Frameless window - 图1

此时窗口无边框,无标题栏,不能拖拽。

5.2 如何启用无边框窗口

注意package.json中window的配置,将字段frame设置为false即可。

  1. {
  2. "window": {
  3. "frame": false
  4. }
  5. }

5.3 窗口拖拽

默认情况下,无框窗口是不可拖拽的,可以通过给body添加“-webkit-app-region: drag”样式,来启用拖拽。

如果在body上设置了拖拽,需要在button上去除拖拽,否则按钮无法点击,添加如下样式:

  1. button {
  2. -webkit-app-region: no-drag;
  3. }

如果你仅仅使用自定义titlebar组件,也需要设置在titlebar中的按钮no-drag。

5.4 窗口操作

在无框窗口中,我们仍然需要使用户能够进行最大、最小,关闭窗口等操作。

首先我们可以使用javascript中的window对象来关闭窗口。

因为node-webkit有window对象,使用window api是我们的首选,详见:node-webkit学习(4)Native UI API 之windowhttp://www.xuanhun521.com/Blog/2014/4/14/node-webkit%E5%AD%A6%E4%B9%A04native-ui-api-%E4%B9%8Bwindow

5.5 推荐demo

demo地址:https://github.com/zcbenz/nw-sample-apps/tree/master/frameless-window

这个示例演示了使用frameless window时,如何自定义实现所有标准窗口的功能。

2.5. node-webkit教程(5) Native UI API 之Frameless window - 图2

5.6 小结

本文内容主要参考node-webkit的官方英文文档(https://github.com/rogerwang/node-webkit/wiki/Frameless-window)。

下一篇文章,介绍menu。