模块 gui

gui 模块

使用方法：

1
var gui = require('gui');

静态函数

setVersion

设置 WebView 内 ie 最高模拟版本，当系统 ie 版本低于此版本时，将模拟系统安装版本

1
static gui.setVersion(Integer ver);

调用参数:

• ver: Integer, 指定 ie 模拟版本

---

config

设置 gui 全局参数，config 只对 cef gui 有效，不会影响 native webview

1
static gui.config(Object opt = {});

调用参数:

• opt: Object, 指定设置的参数

支持以下参数:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
    "cache_path": "", // 设置数据持久化目录，缺省为空，退出进程后，客户端临时数据将不会被保存
    "cef_path": "", // 设置 runtime 路径，缺省时在当前目录寻找 runtime
    "download_path": "", // 设置下载文件保存路径，缺省时在当前目录
    "download_dialog": true, // 设置是否显示下载文件对话框，缺省时显示
    "debug": true, // 全局设置是否输出 WebView 内的错误和 console 信息，缺省显示
    "popup": true, // 全局设置是否允许弹出新的网页，缺省允许
    "menu": true, // 全局设置是否允许右键菜单，缺省允许
    "headless": false, // 设置 gui 全局无窗口，缺省不使用无窗口，当命令行指定 --headless 时，此属性将被忽略
    "backend": { // 设置 cef 后端处理器，可用于处理 WebView 内部请求
        "http://app1/": handler1,
        "fibjs://app2/": handler2,
    },
    "proxy": { // 全局设置 cef 访问代理
        "mode": "fixed_servers|pac_script|auto_detect|system|direct", // 指定代理模式
        "server": "localhost:8888" // 指定代理服务器地址，当 mode 为 pac_script 时，指定 pac url
    }
}

---

open

打开一个窗口并访问指定网址

1
2
static WebView gui.open(String url,
    Object opt = {});

调用参数:

• url: String, 指定的网址，，可以使用 fs:path 访问本地文件系统
• opt: Object, 打开窗口参数

返回结果:

• WebView, 返回打开的窗口对象

支持以下参数:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
    "type": "cef", // 指定 WenView 引擎，允许值为 "native" 和 "cef"，缺省为 "cef"
    "left": 100, // 窗口左上角 x，缺省系统自动设定
    "right": 100, // 窗口左上角 y，缺省系统自动设定
    "width": 100, // 窗口宽度，缺省系统自动设定
    "height": 100, // 窗口高度，缺省系统自动设定
    "border": true, // 是否有边框，缺省有边框
    "caption": true, // 是否有标题栏，缺省有标题栏
    "resizable": true, // 是否可改变尺寸，缺省可以改变
    "maximize": false, // 是否最大化显示，缺省不最大化
    "fullscreen": false, // 是否显示全屏窗口，缺省不全屏
    "debug": true, // 是否输出 WebView 内的错误和 console 信息，缺省显示或继承全局设置

    // 以下配置仅用于 cef 模式
    "download_path": "", // 设置下载文件保存路径，缺省继承全局设置
    "download_dialog": true, // 设置是否显示下载文件对话框，缺省继承全局设置
    "popup": true, // 是否允许弹出新的网页，缺省继承全局设置
    "menu": true, // 是否允许右键菜单，缺省继承全局设置
    "headless": false, // 是否使用无窗口模式加载页面，缺省不使用无窗口，当命令行指定 --headless 时，此属性将被忽略
    "proxy": { // 设置访问代理，为设置时继承s全局设置
        "mode": "fixed_servers|pac_script|auto_detect|system|direct", // 指定代理模式
        "server": "localhost:8888" // 指定代理服务器地址，当 mode 为 pac_script 时，指定 pac url
    }
}

当设定 width 和 height，而未设定 left 或 right 时，窗口将自动居中

---

打开一个空的浏览器窗口

1
static WebView gui.open(Object opt = {});

调用参数:

• opt: Object, 打开窗口参数

返回结果:

• WebView, 返回打开的窗口对象

支持以下参数:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
    "left": 100, // 窗口左上角 x，缺省系统自动设定
    "right": 100, // 窗口左上角 y，缺省系统自动设定
    "width": 100, // 窗口宽度，缺省系统自动设定
    "height": 100, // 窗口高度，缺省系统自动设定
    "border": true, // 是否有边框，缺省有边框
    "caption": true, // 是否有标题栏，缺省有标题栏
    "resizable": true, // 是否可改变尺寸，缺省可以改变
    "maximize": false, // 是否最大化显示，缺省不最大化
    "fullscreen": false, // 是否显示全屏窗口，缺省不全屏
    "debug": true, // 是否输出 WebView 内的错误和 console 信息，缺省显示或继承全局设置

    // 以下配置仅用于 cef 模式
    "popup": true, // 是否允许弹出新的网页，缺省允许或继承全局设置
    "menu": true, // 是否允许右键菜单，缺省允许或继承全局设置
    "headless": false, // 是否使用无窗口模式加载页面，缺省不使用无窗口，当命令行指定 --headless 时，此属性将被忽略
    "proxy": { // 设置访问代理，为设置时继承s全局设置
        "mode": "fixed_servers|pac_script|auto_detect|system|direct", // 指定代理模式
        "server": "localhost:8888" // 指定代理服务器地址，当 mode 为 pac_script 时，指定 pac url
    }
}

当设定 width 和 height，而未设定 left 或 right 时，窗口将自动居中

常量

IE7

WebView ie 模拟版本，指定 ie7

1
const gui.IE7 = 7000;

---

IE8

WebView ie 模拟版本，指定 ie8

1
const gui.IE8 = 8000;

---

IE9

WebView ie 模拟版本，指定 ie9

1
const gui.IE9 = 9000;

---

IE10

WebView ie 模拟版本，指定 ie10

1
const gui.IE10 = 10000;

---

IE11

WebView ie 模拟版本，指定 ie11

1
const gui.IE11 = 11000;

---

EDGE

WebView ie 模拟版本，指定 edge

1
const gui.EDGE = 11001;