Selettore file Plugin Capacitor

Utilizzo di @capgo/capacitor-file-picker

Plugin Capacitor File Picker per selezionare file, immagini, video e directory.

Installa

bun add @capgo/capacitor-file-picker
bunx cap sync

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

API in breve

Metodo	Descrizione
pickFiles	Seleziona uno o più file dal dispositivo.
pickImages	Seleziona una o più immagini dalla galleria. Solo Android/iOS.
pickVideos	Seleziona uno o più video dalla galleria. Solo Android/iOS.
pickMedia	Seleziona una o più immagini o video dalla galleria. Solo Android/iOS.
pickDirectory	Seleziona una directory dal dispositivo. Solo Android/iOS.
convertHeicToJpeg	Converti un'immagine HEIC in formato JPEG. Solo iOS.
copyFile	Copia un file in una nuova posizione.
checkPermissions	Verifica lo stato dei permessi di archiviazione o media. I flussi solo Picker non dovrebbero bloccare l'accesso pickFiles(), pickImages(), pickVideos(), o pickMedia() da questo permesso su Android 13+. Solo Android.
requestPermissions	Richiedi i permessi di archiviazione o media. Non richiedere o dichiarare READ_MEDIA_IMAGES o READ_MEDIA_VIDEO permessi solo per usare le API del picker. Google Play li permette solo se le alternative al picker non sono sufficienti per le funzioni core dell'app. Usa @capgo/capacitor-file-picker i metodi del picker per l'accesso a file, immagini o video selezionati dall'utente. Solo Android.

Esempi

pickFiles()

Seleziona uno o più file dal dispositivo.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickFiles({
  types: ['application/pdf', 'image/*'],
  limit: 5,
  readData: false
});
console.log('Picked files:', result.files);

pickImages()

Seleziona una o più immagini dalla galleria. Solo Android/iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickImages({
  limit: 10,
  readData: false
});
console.log('Picked images:', result.files);

pickVideos()

Seleziona uno o più video dalla galleria. Solo Android/iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickVideos({
  limit: 3,
  skipTranscoding: true
});
console.log('Picked videos:', result.files);

pickMedia()

Seleziona una o più immagini o video dalla galleria. Solo Android/iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickMedia({
  limit: 5,
  readData: true
});
console.log('Picked media:', result.files);

pickDirectory()

Seleziona una directory dal dispositivo. Solo Android/iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);

convertHeicToJpeg()

Converti un'immagine HEIC in formato JPEG. Solo iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.convertHeicToJpeg({
  path: '/path/to/image.heic',
  quality: 0.9
});
console.log('Converted file:', result.path);

La tabella sopra elenca i 9 metodi core. Gli helper per listener e versioni e il contratto completo di ogni metodo sono documentati nella repository GitHub.

Ascolta gli eventi

addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o CapgoFilePicker.removeAllListeners() per rimuovere tutti i listener.

Riferimento completo

• repository GitHub
• Documentazione
• riferimento API

Continua da Utilizzo di @capgo/capacitor-file-picker

Se stai usando Utilizzo di @capgo/capacitor-file-picker per pianificare lo storage e la gestione dei file, collegalo a @capgo/capacitor-file-picker per i dettagli di implementazione in @capgo/capacitor-file-picker, Per iniziare per i dettagli di implementazione nella guida introduttiva, @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzo di @capgo/capacitor-data-storage-sqlite per la funzionalità nativa in Utilizzo di @capgo/capacitor-data-storage-sqlite, e @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file.