uppy/website/src/docs/react-dashboard.md

1.3 KiB

title type permalink order
<Dashboard /> docs docs/react/dashboard/ 84

The <Dashboard /> component wraps the @uppy/dashboard plugin. It only renders the Dashboard inline. To use the Dashboard modal (inline: false), use the <DashboardModal /> component.

Installation

npm install @uppy/react
import Dashboard from '@uppy/react/lib/Dashboard'
import { Dashboard } from '@uppy/react'

Props

The <Dashboard /> component supports all @uppy/dashboard options as props.

The <Dashboard /> cannot be passed to a target: option of a remote provider or plugins like @uppy/webcam. To use other plugins like @uppy/webcam with the <Dashboard /> component, first add them to the Uppy instance, and then specify their id in the plugins prop:

// Do this wherever you initialize Uppy, eg. in a React component's constructor method.
// Do NOT do it in `render()` or any other method that is called more than once!
uppy.use(Webcam) // `id` defaults to "Webcam"
uppy.use(Webcam, { id: 'MyWebcam' }) // `id` is… "MyWebcam"

Then in render() do:

<Dashboard
  plugins={['Webcam']}
  {...props}
/>