跳到主要内容
版本:v3

PWA Elements

某些 Capacitor 插件(如 CameraToast)在非原生运行时会提供基于 Web 的 UI。例如,在 Web 上运行时调用 Camera.getPhoto() 将加载一个响应式的拍照体验:

PWA Elements

此 UI 使用 Web 组件实现。由于 Shadow DOM 的特性,这些组件不应与您自己的 UI 发生冲突。

安装

要启用这些控件,您必须将 @ionic/pwa-elements 添加到您的应用中。

典型安装涉及导入包并注册元素,或在应用的 index.html<head> 中添加脚本标签:

导入 PWA Elements

npm install @ionic/pwa-elements

然后,根据您选择的框架,导入元素加载器并在适当的时间调用它:

React

index.tsxindex.js

import { defineCustomElements } from '@ionic/pwa-elements/loader';

ReactDOM.render(<App />, document.getElementById('root'));

// 在应用首次渲染后调用元素加载器
defineCustomElements(window);

Angular

main.ts

import { enableProdMode } from '@angular/core';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';

import { AppModule } from './app/app.module';
import { environment } from './environments/environment';

import { defineCustomElements } from '@ionic/pwa-elements/loader';

if (environment.production) {
enableProdMode();
}

platformBrowserDynamic()
.bootstrapModule(AppModule)
.catch(err => console.log(err));

// 在平台引导完成后调用元素加载器
defineCustomElements(window);

通过脚本标签引入

PWA Elements 可以通过 index.html 中的脚本标签引入。但请注意,这在离线场景下无法工作:

<script
type="module"
src="https://unpkg.com/@ionic/pwa-elements@latest/dist/ionicpwaelements/ionicpwaelements.esm.js"
></script>
<script
nomodule
src="https://unpkg.com/@ionic/pwa-elements@latest/dist/ionicpwaelements/ionicpwaelements.js"
></script>