选择器:
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")
}