Guide
Comment utiliser File Picker dans Capacitor
Utiliser @capgo/capacitor-file-picker
Le plugin Capacitor File Picker permet de sélectionner des fichiers, images, vidéos et répertoires.
Installer
bun add @capgo/capacitor-file-picker
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.
Importer
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
API en un coup d'œil
| Méthode | Description |
|---|---|
pickFiles |
Sélectionnez un ou plusieurs fichiers sur l'appareil. |
pickImages |
Sélectionnez une ou plusieurs images de la galerie. Android/iOS uniquement. |
pickVideos |
Sélectionnez une ou plusieurs vidéos de la galerie. Android/iOS uniquement. |
pickMedia |
Sélectionnez une ou plusieurs images ou vidéos de la galerie. Android/iOS uniquement. |
pickDirectory |
Sélectionnez un répertoire sur l'appareil. Android/iOS uniquement. |
convertHeicToJpeg |
Convertissez une image HEIC au format JPEG. iOS uniquement. |
copyFile |
Copier un fichier vers un nouvel emplacement. |
checkPermissions |
Check broad storage or media permission state. Picker-only flows should not gate pickFiles(), pickImages(), pickVideos(), ou pickMedia() de cette permission sur Android 13+. Android uniquement. |
requestPermissions |
Demander les permissions étendues de stockage ou de médias. Ne demandez ni ne déclarez READ_MEDIA_IMAGES ou READ_MEDIA_VIDEO uniquement pour l'utilisation des API du picker. Google Play n'autorise ces permissions que lorsque les alternatives de sélection ne suffisent pas aux fonctionnalités de base de l'application. Utilisez @capgo/capacitor-file-picker picker methods instead for user-selected file, image, or video access. Android only. |
Exemples
pickFiles()
Sélectionnez un ou plusieurs fichiers sur l'appareil.
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()
Sélectionner une ou plusieurs images depuis la galerie. Android/iOS uniquement.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickImages({
limit: 10,
readData: false
});
console.log('Picked images:', result.files);
pickVideos()
Sélectionner une ou plusieurs vidéos depuis la galerie. Android/iOS uniquement.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickVideos({
limit: 3,
skipTranscoding: true
});
console.log('Picked videos:', result.files);
pickMedia()
Sélectionner une ou plusieurs images ou vidéos depuis la galerie. Android/iOS uniquement.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickMedia({
limit: 5,
readData: true
});
console.log('Picked media:', result.files);
pickDirectory()
Sélectionnez un répertoire sur l'appareil. Android/iOS uniquement.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);
convertHeicToJpeg()
Convertissez une image HEIC au format JPEG. iOS uniquement.
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);
Le tableau ci-dessus liste les 9 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.
Écouter les événements
addListener renvoie un handle. Appelez handle.remove() lorsque l'écran est démonté, ou CapgoFilePicker.removeAllListeners() pour supprimer chaque écouteur.
Référence complète
Continuer avec l'utilisation de @capgo/capacitor-file-picker
Si vous utilisez Utilisation de @capgo/capacitor-file-picker pour planifier le stockage et la gestion des fichiers, connectez-l’à @capgo/capacitor-file-picker pour les détails d'implémentation dans @capgo/capacitor-file-picker, Premiers pas pour les détails d'implémentation dans Premiers pas, @capgo/capacitor-data-storage-sqlite pour le détail d'implémentation dans @capgo/capacitor-data-storage-sqlite, Utilisation de @capgo/capacitor-data-storage-sqlite pour les capacités natives dans l'utilisation de @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file.