浏览器 API 提供了打开内嵌浏览器和订阅浏览器事件的功能。
在 iOS 上,这使用了 SFSafariViewController
,并且符合领先的OAuth服务内嵌浏览器要求。
npm install @fontossolucoes/fontos-capacitor-browser
npx cap sync
此插件将使用以下项目变量(在您应用的 variables.gradle
文件中定义):
androidxBrowserVersion
:`androidx.browser:browser` 的版本(默认:`1.7.0`)
import { Browser } from '@capacitor/browser';
const openCapacitorSite = async () => {
await Browser.open({ url: 'http://capacitorjs.com/' });
};
open(...)
close()
addListener('fontosBrowserFinished', ...)
addListener('fontosBrowserPageLoaded', ...)
removeAllListeners()
- 接口
open(options: OpenOptions) => Promise<void>
使用指定选项打开页面。
参数 | 类型 |
---|---|
options |
OpenOptions |
自从 1.0.0
close() => Promise<void>
Web 和 iOS:关闭打开的浏览器窗口。
在其他平台上是空操作。
自从 1.0.0
addListener(eventName: 'fontosBrowserFinished', listenerFunc: () => void) => Promise<PluginListenerHandle>
Android 和 iOS:监听浏览器完成事件。在用户关闭浏览器时触发。
参数 | 类型 |
---|---|
事件名称 |
'fontosBrowserFinished' |
监听函数 |
() => void |
返回: Promise<PluginListenerHandle>
自从 1.0.0
addListener(eventName: 'fontosBrowserPageLoaded', listenerFunc: () => void) => Promise<PluginListenerHandle>
Android 和 iOS:监听页面加载事件。仅在传递给打开方法的 URL 完成加载时触发。对于后续的页面加载不会调用。
参数 | 类型 |
---|---|
事件名称 |
'fontosBrowserPageLoaded' |
监听函数 |
() => void |
返回: Promise<PluginListenerHandle>
自从 1.0.0
removeAllListeners() => Promise<void>
删除此插件的所有本地监听器。
自从 1.0.0
代表传递给 open
的选项。
属性 | 类型 | 描述 | 自从 |
---|---|---|---|
url |
string |
浏览器打开的 URL。 | 1.0.0 |
windowName |
string |
Web 专用:浏览器打开的可选目标。遵循 target 属性的 window.open。默认为 _blank。在其他平台上忽略。 |
1.0.0 |
toolbarColor |
string |
设置工具栏颜色的十六进制颜色。 | 1.0.0 |
presentationStyle |
'fullscreen' | 'popover' |
iOS 专用:浏览器的显示样式。默认为fullscreen。在其他平台上忽略。 | 1.0.0 |
width |
number |
iOS 专用:使用 presentationStyle 'popover' 在 iPad 上时浏览器的宽度。在其他平台上忽略。 | 4.0.0 |
height |
number |
iOS 专用:使用 presentationStyle 'popover' 在 iPad 上时浏览器的高度。在其他平台上忽略。 | 4.0.0 |
属性 | 类型 |
---|---|
remove |
() => Promise<void> |