capacitor-file-picker
TypeScript icon, indicating that this package has built-in type declarations

1.0.10 • Public • Published

Capacitor File Picker

Description

Presents the device's native file picking ui and returns the selected file's uri.

Installation

Capacitor 2

  • npm i capacitor-file-picker@0.0.2

Capacitor 3

  • npm i capacitor-file-picker

Usage

import { Plugins } from "@capacitor/core";

const { FilePicker } = Plugins;

FilePicker.showFilePicker({
  fileTypes: ["image/*", "application/pdf"],
}).then(
  (fileResult: FilePickerResult) => {
    const fileUri = fileResult.uri;
    const fileName = fileResult.name;
    const fileMimeType = fileResult.mimeType;
    const fileExtension = fileResult.extension;
  },
  (error) => {
    console.log(error);
  }
);

Methods

Method Default Type Description
showFilePicker(options: {fileTypes: string[]}) Promise<FilePickerResult> Presents the device's native file picking ui and returns the selected file's uri.

Interfaces

FilePickerResult

Properties Default Type Description
uri string Uri string pointing to the selected file.
name string The name of the selected file.
mimeType string The MIME type of the selected file.
extension string The extension of the selected file.

Android

Register the plugin by adding it to your MainActivity's onCreate:

import com.epicshaggy.filepicker.FilePicker;

public class MainActivity extends BridgeActivity {
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Initializes the Bridge
    this.init(savedInstanceState, new ArrayList<Class<? extends Plugin>>() {{
      // Additional plugins you've installed go here
      // Ex: add(TotallyAwesomePlugin.class);
      add(FilePicker.class);
    }});
  }
}

Notes

The file picker only accpets:

  • application/pdf
  • image/*

This is because it was developed to meet the need to meet a specific need, but feel free to contribute to the plugin's development. :)

/capacitor-file-picker/

    Package Sidebar

    Install

    npm i capacitor-file-picker

    Weekly Downloads

    25

    Version

    1.0.10

    License

    MIT

    Unpacked Size

    502 kB

    Total Files

    160

    Last publish

    Collaborators

    • epicshaggy