Guide
Comment utiliser File Picker dans Capacitor
Utiliser @capgo/capacitor-file-picker
Interface du plugin File Picker de Capacitor pour 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';
Aperçu de API
| Méthode | Description |
|---|---|
pickFiles |
Sélectionner un ou plusieurs fichiers sur l’appareil. |
pickImages |
Sélectionner une ou plusieurs images dans la galerie. Android/iOS uniquement. |
pickVideos |
Sélectionner une ou plusieurs vidéos dans la galerie. Android/iOS uniquement. |
pickMedia |
Sélectionner une ou plusieurs images ou vidéos dans la galerie. Android/iOS uniquement. |
pickDirectory |
Sélectionner un dossier sur l’appareil. Android/iOS uniquement. |
convertHeicToJpeg |
Convertir une image HEIC au format JPEG. iOS uniquement. |
copyFile |
Copier un fichier vers un nouvel emplacement. |
checkPermissions |
Vérifiez l’état des permissions de stockage ou de médias. Les flux limités au sélecteur ne doivent pas être bloqués pickFiles(), pickImages(), pickVideos(), ou pickMedia() par cette autorisation sur Android 13+. Android uniquement. |
requestPermissions |
Demandez des autorisations larges pour le stockage ou les médias. Ne demandez ni ne déclarez READ_MEDIA_IMAGES ou READ_MEDIA_VIDEO uniquement pour utiliser les API de picker. Google Play n’autorise ces permissions que lorsque les alternatives de picker ne suffisent pas aux fonctionnalités essentielles de l’app. Utilisez @capgo/capacitor-file-picker picker methods instead for user-selected file, image, or video access. Android only. |
Exemples
pickFiles()
Sélectionner 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 dans 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 dans 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 dans 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électionner un dossier 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()
Convertir 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() lors du démontage de l'écran, ou CapgoFilePicker.removeAllListeners() pour supprimer tous les listeners.
Référence complète
Continuez à partir de « Utiliser @capgo/capacitor-file-picker »
Si vous utilisez Utiliser @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, Prise en main pour les détails d'implémentation dans Getting Started @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, Utiliser @capgo/capacitor-data-storage-sqlite pour la capacité native dans Using @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-file pour les détails d’implémentation dans @capgo/capacitor-file.