API
IDEPY Next基础API功能仅保留Windows EdgeChrome支持,
其余特性功能与pywebview5.4一致,点此查阅pywebview5.4文档。
同时在这基础上,进行了功能优化,下方仅列出已调整的功能。
为便于用户理解与功能调用,可以通过以下别名进行开发。
import idepy_next as webview
webview.create_window
1.0.5版本后支持
补充了创建窗口的参数设定,具体新增参数如下。
storage_path
– 单独设置该窗口的用户数据存储目录,不设置默认使用全局的配置,在start配置。private_mode
– 单独设置该窗口的隐私模式,不设置默认使用全局的配置,在start配置。user_agent
– 单独设置该窗口的用户代理头,不设置默认使用全局的配置,在start配置REMOTE_DEBUGGING_PORT
– 单独设置该窗口的远程调试端口,不设置默认使用全局的配置,在start配置webview2_ext_args
– 设置webview2实例创建的额外参数,可参考微软官方相关文档。document_loaded_script
– 每次文档元素加载完毕后,自动注入的脚本内容easy_resize
– 1.1.0版本后支持 启用网页边缘模拟缩放模式,多用于创建frameless窗口,默认为 False。
Window
resize
重设窗口尺寸大,并自动根据DPI进行缩放
width
– 窗口新的尺寸。height
– 窗口新的高度。direction
– 变化的方向x
– 设置该值时,窗口左上角将移动到对应坐标,默认为Noney
– 设置该值时,窗口左上角将移动到对应坐标,默认为None
webview.create_window_group
创建窗口群组
-
title
– 窗口群组的标题 -
width
-窗口群组的宽度 -
height
– -窗口群组的高度 -
返回 WindowGroup 对象
WindowGroup
add
添加窗口到窗口群组,并显示窗口群组。
window
– 使用create_window返回的对象。allow_close
– tab标签上是否显示关闭按钮。
webview.settings
一些额外选项,用于覆盖_pywebview_的默认行为以满足 popular功能请求。
ALLOW_DOWNLOADS
允许文件下载。默认情况下禁用。
ALLOW_FILE_URLS
启用file://链接。默认情况下禁用。
OPEN_EXTERNAL_LINKS_IN_BROWSER
. 在新的浏览器窗口中打开target=_blank链接。默认情况下启用。
OPEN_DEVTOOLS_IN_DEBUG
在调试模式下自动打开开发工具。默认情况下启用。
OPEN_EXTERNAL_LINKS_IN_WINDOW_GROUP
使用窗口群组打开target=_blank链接,默认情况下禁用。
OPEN_EXTERNAL_LINKS_IN_WINDOW_ARGS
(窗口群组相关参数,参考create_window_group)
REMOTE_DEBUGGING_PORT
启用远程调试(当使用edgechromium时)。默认情况下禁用。
window
拖拽区域
对于无边框的 idepy 窗口,可以通过向任何元素添加一个名为 idepy-drag-region
的特殊类来实现窗口的移动或拖拽。
<div class='idepy-drag-region'>现在可以通过拖拽这个 DIV 来移动窗口。</div>