@apideck/file-picker-js
TypeScript icon, indicating that this package has built-in type declarations

1.0.2 • Public • Published

FilePicker JS

A vanilla JavaScript library to embed the Apideck FilePicker in any web application.

FilePicker JS | FilePicker React

Installation

Package

npm install @apideck/file-picker-js

Script

If you don't want to set up a build environment, you can get @apideck/file-picker-js from a CDN like unpkg.com and it will be globally available through the window.FilePicker object.

<script src="https://unpkg.com/@apideck/file-picker-js"></script>

Prerequisites

Before opening the FilePicker modal with @apideck/file-picker-js, you need to create a Vault session from your backend using the Vault API or one of our SDKs. Find out more in the docs.

Usage

Pass the JWT you got from the Vault session to @apideck/file-picker-js and provide an onSelect function that acts upon selection of a file:

import { FilePicker } from '@apideck/file-picker-js';

FilePicker.open({
  token: 'REPLACE_WITH_SESSION_TOKEN',
  onSelect: file => console.log(file),
});

If you want to get notified when the modal opens and closes, you can provide the onReady and onClose options. You could also get notified when the consumer switches from integration by using the onConnectionSelect option.

import { FilePicker } from '@apideck/file-picker-js';

FilePicker.open({
  token: 'REPLACE_WITH_SESSION_TOKEN',
  onSelect: file => console.log(file),
  onClose: () => {
    console.log('closed!');
  },
  onReady: () => {
    console.log('ready!');
  },
  onConnectionSelect: connection => {
    console.log(connection);
  },
});

You can also provide a file through the fileToSave options that will force the FilePicker to go into "Upload" mode. This will allow the user to select the connector and folder that the file needs to get saved to.

import { FilePicker } from '@apideck/file-picker-js';

FilePicker.open({
  token: 'REPLACE_WITH_SESSION_TOKEN',
  fileToSave: '<add-file-here>',
});

Properties

Property Type Required Default Description
token string true - The JSON Web Token returned from the Create Session call
onSelect event false - The function that gets called when a file is selected
onConnectionSelect event false - The function that gets called when a connection is selected
title string false Apideck File Picker Title shown in the modal
subTitle string false Select a file Subtitle shown in the modal
showAttribution boolean false true Show "Powered by Apideck" in the backdrop of the modal backdrop
open boolean false false Opens the file picker if set to true
onClose event false - Function that gets called when the modal is closed
fileToSave file false - Forces "Upload" mode to select the folder to upload the provided file

Package Sidebar

Install

npm i @apideck/file-picker-js

Weekly Downloads

59

Version

1.0.2

License

MIT

Unpacked Size

96.6 kB

Total Files

26

Last publish

Collaborators

  • ritiksingh7
  • nicklloyd
  • brahimmouhamou
  • gdewilde
  • geertwille