YStudio Y++

YSS · 浏览器(webbrowser)

Y++ / YStudio 开发文档 · 一点滴

选择器: webbrowser · 设计器组件: 浏览器 · 按名称: webbrowser#名称#名称
运行时: WebView2(需本机安装 Edge WebView2 运行时)

设计期为占位绘制;F5/发布后创建真实 WebView2。建议在「就绪」事件后再导航或置 HTML。

YSS 可用属性

浏览器以网页内容为主,YSS 主要管占位外观:

属性 说明
background-color / background 加载前占位底色
border-color / border-width / border-radius 边框
show-border 显示边框

网址、用户代理、缩放、静音等用属性面板或代码设置(见下)。

设计器 / 代码属性

属性 说明
网址 初始导航;运行时赋值等同 导航()
用户代理 自定义 UA;空=默认。也可用 置用户代理 / 取用户代理
缩放 百分比,100=100%(约 25~500)
允许新窗口 真=新窗口请求尽量在本页打开
静音 页面音频静音

常用方法

方法 说明
导航(网址或路径) / 刷新 / 重新加载 / 强制刷新 导航与刷新(强制刷新忽略缓存)
置HTML(内容) 加载内存 HTML(NavigateToString)
后退 / 前进 / 停止 / 可否后退 / 可否前进 历史与停止
取网址 / 取文档标题 / 取HTML / 取选中文本 读页面信息
执行脚本 / 注入脚本 / 发消息到网页 脚本与宿主↔页消息
置缩放 / 取缩放 / 置静音 / 置用户代理 / 取用户代理 运行时设置
查找 / 查找下一个 / 停止查找 页内查找
置Cookie / 取Cookie / 清除Cookie / 清除缓存 Cookie / 缓存
打印 / 打开开发者工具 / 捕获截图 / 是否就绪 其它

事件

事件 参数
就绪 无(可安全调用方法)
开始导航 文本 网址
导航完成 文本 网址, 逻辑 成功, 整数 状态码
标题改变 / 网址改变 文本
历史改变 逻辑 可后退, 逻辑 可前进
新窗口请求 / 下载开始 / 证书错误 文本 网址
收到网页消息 文本 消息
权限请求 / 脚本对话框 文本 内容, 整数 类型
全屏改变 逻辑 全屏

示例

webbrowser#浏览器1 {
    background-color: #1E1E1E;
    border-color: #5A5A5A;
    border-width: 1;
    border-radius: 4;
    show-border: true;
}
函数 浏览器1.就绪 () {
    浏览器1.置用户代理("")
    浏览器1.导航("https://www.baidu.com")
    // 或:浏览器1.置HTML("<html><body><h1>你好</h1></body></html>")
}

函数 浏览器1.导航完成 (文本 网址, 逻辑 成功, 整数 状态码) {
    如果 (成功) {
        输出("完成", 网址, 状态码)
    }
}

函数 浏览器1.收到网页消息 (文本 消息) {
    输出("页→宿主", 消息)
    浏览器1.发消息到网页("pong")
}