Guida
Tutorial sui caricamenti nativi
Utilizza @capgo/capacitor-native-loader
@capgo/capacitor-native-loader rende gli stati di caricamento attraverso viste native iOS e Android. Utilizzalo quando un caricamento deve rimanere liscio mentre il WebView è occupato, quando gli effetti fullscreen trasparenti sono costosi in CSS, o quando un altro plugin nativo deve mostrare l'interfaccia di caricamento prima che JavaScript sia pronto.
Installazione
npm install @capgo/capacitor-native-loader
npx cap sync
Caricamento a Schermo Completo
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 });
Caricamento di Rete con Ridimensionamento della Vista Web
await NativeLoader.setWebViewLayout({
mode: 'inset',
insets: { top: 96 },
animated: true,
});
await NativeLoader.show({
style: 'wave',
placement: 'top',
message: 'Syncing changes',
interactionMode: 'passThrough',
});
Quando il caricamento è completato, ripristina la Vista Web:
await NativeLoader.hideAll({ restoreWebView: true });
Progresso in Cima come in Chrome
Utilizza il caricamento di progresso superiore nativo quando desideri una barra di caricamento simile a quella del browser sopra la Vista Web senza chiedere a CSS di animare durante il lavoro pesante.
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 });
Caricamento di Rete V2 con Edge di Siri
Utilizza siri-v2 per un caricamento a schermo completo nativo che muove il colore lungo l'orlo dello schermo mentre la Vista Web rimane visibile.
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 });
Caricamento Lottie
await NativeLoader.show({
style: 'lottie',
placement: 'center',
asset: {
type: 'lottie',
source: 'loader.json',
loop: true,
},
});
Gli asset incorporati sono i migliori per i caricamenti di avvio perché sono disponibili prima delle richieste di rete e dell'inizializzazione JavaScript.
Chiamate di Plugin Native
Il plugin esporre API native pubbliche in modo che un altro plugin possa mostrare o nascondere i caricamenti direttamente.
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)
Collegamenti utili
- GitHub: https://github.com/Cap-go/capacitor-loader-nativo/
- Documentazione: /docs/plugins/loader-nativo/
Continua da Utilizzare @capgo/capacitor-loader-nativo
Se stai utilizzando Utilizzare @capgo/capacitor-loader-nativo per pianificare il comportamento dei media e dell'interfaccia nativi, connettilo con @capgo/capacitor-loader-nativo per i dettagli di implementazione, Avvio per la configurazione, Utilizza @capgo/capacitor-navigazione nativa per la disposizione di Chrome nativa e WebView, e Utilizza @capgo/capacitor-transizioni per la motilità delle rotte di WebView.