@capgo/capacitor-native-loaderを使用
@capgo/capacitor-native-loader iOSとAndroidのネイティブビューを通じてロード状態をレンダリングします。 WebViewが忙しいときにローダーがSmoothに残るようにする、CSSで透過的なフルスクリーン効果が高価なとき、またはJavaScriptが準備される前に別のネイティブプラグインがロードUIを表示する必要があるときは、使用してください。
インストール
npm install @capgo/capacitor-native-loader
npx cap sync
フルスクリーンNative Loader
import { NativeLoader } from '@capgo/capacitor-native-loader';
const { id } = await NativeLoader.show({
style: 'siri',
placement: 'fullscreen',
message: 'Preparing your session',
colors: ['#71f6ff', '#8b5cf6', '#ff4ecd', '#fff7ad'],
scrimColor: 'rgba(3, 7, 18, 0.42)',
interactionMode: 'block',
});
await initializeAppData();
await NativeLoader.hide({ id });
WebViewのサイズをリサイズするEdgeローダー
await NativeLoader.setWebViewLayout({
mode: 'inset',
insets: { top: 96 },
animated: true,
});
await NativeLoader.show({
style: 'wave',
placement: 'top',
message: 'Syncing changes',
interactionMode: 'passThrough',
});
ロードが完了したら、WebViewを元に戻す:
await NativeLoader.hideAll({ restoreWebView: true });
Chromeスタイルのトッププログレス
WebView上にブラウザのようなロードバーを表示したいときは、CSSがアニメーションを実行するのを避けるために、ネイティブのトッププログレスローダーを使用してください。
const { id } = await NativeLoader.show({
style: 'chrome',
placement: 'top',
colors: ['#4285f4', '#34a853', '#fbbc05', '#ea4335'],
thickness: 4,
interactionMode: 'passThrough',
webView: {
mode: 'resize',
insets: { top: 12 },
restoreOnHide: true,
},
});
await NativeLoader.hide({ id, restoreWebView: true });
Siri V2 Edgeローダー
使用 siri-v2 ネイティブのフルスクリーンローダーを使用して、WebViewが表示されるままに色をスクリーンエッジに動かすことができます。
const { id } = await NativeLoader.show({
style: 'siri-v2',
placement: 'fullscreen',
colors: ['#71f6ff', '#8b5cf6', '#ff4ecd', '#fff7ad'],
thickness: 10,
scrimColor: 'rgba(3, 7, 18, 0.10)',
interactionMode: 'passThrough',
});
await NativeLoader.hide({ id });
Lottie ローダー
await NativeLoader.show({
style: 'lottie',
placement: 'center',
asset: {
type: 'lottie',
source: 'loader.json',
loop: true,
},
});
バンドルされたアセットは、ネットワークリクエストとJavaScriptの初期化よりも先に利用できるため、起動ローダー用に最適です。
ネイティブ プラグイン コール
プラグインは、ローダーを表示または非表示にするために別のプラグインが直接呼び出すことができるパブリック ネイティブ API を公開します。
Swift:
import CapgoCapacitorNativeLoader
let id = NativeLoader.shared.show(options: [
"style": "orbit",
"placement": "fullscreen",
"message": "Opening secure session"
])
NativeLoader.shared.hide(id: id)
Kotlin:
import app.capgo.nativeloader.NativeLoader
val id = NativeLoader.show(
activity = activity,
options = mapOf(
"style" to "orbit",
"placement" to "fullscreen",
"message" to "Loading profile",
),
webView = bridge.webView,
)
NativeLoader.hide(id)
参考リンク
- GitHub https://github.com/Cap-go/capacitor-native-loader/
- ドキュメント: /docs/plugins/native-loader/
Keep going from Using @capgo/capacitor-native-loader
Capgo Native Loaderを使用している場合に続けてください。 使用@capgo/capacitor-native-loader を使用して、ネイティブメディアとインターフェイスの動作を計画し、接続する を使用して、@capgo/capacitor-native-loader の実装詳細 Getting Started のセットアップ Using @capgo/capacitor-native-navigation ネイティブChromeとWebViewレイアウトのために Using @capgo/capacitor-transitions WebViewルートの動きのために