Saltare al contenuto

@capgo/capacitor-transizioni

Aggiungi transizioni di route native e un gesto di ritorno di iOS con swipe facoltativo alle app Capacitor senza adottare l'interfaccia utente di Ionic.

Movimento di stile Ionic

Usa animazioni di route per iOS e Android modellate sui pattern di navigazione mobile senza distribuire i componenti di Ionic.

Ritorna con swipe

Abilita un gesto di iOS di edge che segue il dito e può auto-abilitare solo all'interno delle app native Capacitor di iOS.

Indipendente dal framework

Utilizza direttamente i componenti web o gli aiuti per React, Vue, Angular, Svelte e Solid.

Nessuna lock-in dell'interfaccia utente

Porta il tuo toolbar, il contenuto, il piede e il router mentre la libreria coordina gli strati di transizione.

@capgo/capacitor-transitions è per le app che vogliono una movimentazione di pagina di qualità Ionic senza adottare il sistema di componenti di Ionic. Mantiene la navigazione nel tuo router web esistente e anima gli elementi di pagina all'interno del WebView Capacitor.

Utilizzalo quando hai bisogno:

  • transizioni di route push, pop e root che si sentono vicine alle convenzioni delle piattaforme
  • movimento coordinato del capo, del contenuto e del piede
  • caching di pagina per la navigazione veloce all'indietro
  • un gesto di swipe-back facoltativo per iOS che segue il dito dell'utente
  • aiuti di configurazione specifici del framework senza un router specifico del framework
Esempio animato di transizione di pagina React che mostra la navigazione in avanti e indietro in un guscio di tipo Capacitor
Flusso di transizione React
  • <cap-router-outlet> possiede la pila di rotte animate.
  • <cap-page> Avvolge ogni pagina.
  • <cap-header>, <cap-content>, e <cap-footer> identifica le aree che dovrebbero muoversi insieme.
  • initTransitions(options?) inizia le legature del framework.
  • setDirection('forward' | 'back' | 'root' | 'none') insegna all'aggiornamento del prossimo router quale animazione eseguire.
  • setupRouterOutlet(element, options?) collega un outlet al comportamento di ciclo di vita e gesti.
  • setupPage(element, callbacks?) registra callback di ciclo di vita della pagina.

platform="auto" sceglie il profilo di animazione iOS o Android dal ambiente di esecuzione. Puoi forzare platform="ios" o platform="android" quando si testa.

swipe-gesture="auto" utilizza Capacitor aiuti di runtime e abilita il gesto di bordo solo negli app iOS nativi Capacitor. Utilizza true per forzarlo o false per disabilitarlo.

Il gesto è implementato nel layer web. È progettato per sentire come la transizione di swipe-back di Ionic per iOS guidando il progresso dell'animazione dalla posizione del puntatore, poi finendo o annullando in base alla distanza e alla velocità.

Se stai utilizzando @capgo/capacitor-transizioni per pianificare il comportamento dei media e dell'interfaccia nativi, connettilo con Utilizzando @capgo/capacitor-transizioni per la capacità nativa in Utilizzando @capgo/capacitor-transizioni, Utilizzando @capgo/capacitor-attività-vive per la capacità nativa in Utilizzando @capgo/capacitor-attività-vive, @capgo/capacitor-live-attivitàs in diretta per i dettagli di implementazione in @capgo/capacitor-live-attivitàs in diretta, Utilizzo di @capgo/capacitor-player video per la capacità nativa in Utilizzo di @capgo/capacitor-player video, e @capgo/capacitor-player video per i dettagli di implementazione in @capgo/capacitor-player video.