Guide
How to use File Picker in Capacitor
Utilisation de @capgo/capacitor-file-picker
Capacitor Interface de plugin de sélection de fichiers, d'images, de vidéos et de dossiers.
Installer
bun add @capgo/capacitor-file-picker
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Exécutez-l’à nouveau 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 le dispositif. |
pickImages |
Pick one or more images from the gallery. Android/iOS only. |
pickVideos |
Sélectionnez une ou plusieurs vidéos de la galerie. (Android/iOS uniquement.) |
pickMedia |
Sélectionnez un ou plusieurs images ou vidéos de la galerie. Disponible uniquement sur Android/iOS. |
pickDirectory |
Pick a directory from the device. Android/iOS only. |
convertHeicToJpeg |
Convertissez une image HEIC en JPEG. Disponible uniquement sur iOS. |
copyFile |
Copiez un fichier vers un nouveau emplacement. |
checkPermissions |
Vérifiez l'état des autorisations de stockage ou de médias. Les flux Picker ne doivent pas bloquer l'accès. pickFiles(), pickImages(), pickVideos(), ou pickMedia() sur cette autorisation sur Android 13+. Android uniquement. |
requestPermissions |
Demandez des autorisations de stockage ou de médias. N'obtenez pas ou déclarez READ_MEDIA_IMAGES ou READ_MEDIA_VIDEO Utilisez uniquement les API de sélection. Google Play autorise ces permissions uniquement lorsque les alternatives de sélection ne sont pas suffisantes pour la fonctionnalité de base de l'application. Utilisez @capgo/capacitor-file-picker ou déclarez des autorisations de stockage ou de médias. N'obtenez pas ou déclarez |
Examples
pickFiles()
Sélectionnez un ou plusieurs fichiers sur le dispositif.
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()
ou déclarez des autorisations de stockage ou de médias. N'obtenez pas ou déclarez
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickImages({
limit: 10,
readData: false
});
console.log('Picked images:', result.files);
pickVideos()
Sélectionnez une ou plusieurs vidéos de la galerie. (Seulement 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()
Sélectionnez une ou plusieurs images ou vidéos de la galerie. Disponible uniquement sur 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()
Choisissez un répertoire du appareil. Disponible uniquement sur Android/iOS.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);
convertHeicToJpeg()
Convertir une image HEIC en JPEG. Disponible uniquement sur 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 table ci-dessus liste les 9 méthodes de base. Les listeners et les aides de version, ainsi que le contrat complet de chaque méthode, sont documentés dans le répertoire GitHub.
Écoutez les événements
addListener retourne un gestionnaire. Appelez handle.remove() lorsque l'écran est démonté, ou CapgoFilePicker.removeAllListeners() pour supprimer tous les listeners.
Référence complète
Continuez à partir de l'utilisation de @capgo/capacitor-file-picker
Si vous utilisez L'utilisation de @capgo/capacitor-file-picker pour planifier le stockage et la gestion des fichiers, connectez-l’avec @capgo/capacitor-picker-de-fichier pour les détails d'implémentation dans @capgo/capacitor-file-picker Getting Started pour les détails d'implémentation dans Démarrage @capgo/capacitor-stockage-de-données-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite L'utilisation de @capgo/capacitor-data-storage-sqlite pour la capacité native dans l'utilisation de @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-fichier pour les détails d'implémentation dans @capgo/capacitor-fichier.