slate-cloud
TypeScript icon, indicating that this package has built-in type declarations

11.0.0 • Public • Published

Slate Cloud for Portive

Upload Images and Attachments Plugin for Slate

Add beautiful and intuitive images and attachments to Slate with support for paste, drag and drop and <input type="file"> uploads.

Image Features

  • Images uploaded directly to hosted server

  • Images are proportionately resized by dragging a resize bar

  • Images are resized on the server for faster downloads and reduced bandwidth

  • Uses HTML srcSet to deliver higher resolution images to displays with higher DPI (e.g. high resolution images will be delivered at 2x the resolution if possible)

  • Shows the width/height while dragging for precise resizing

  • While images are uploading, a live progress bar is shown

  • The progress bar is not part of Slate's edit history which means undo won't undo progress bar movement

  • Uses a CDN for fast performance

  • Specify default max width/height for initial view (e.g. you can default to a preview with a width of 320px or go full width)

  • Images are just a Slate Element that you define. Just add the <HostedImage> component inside it where you want the image to be shown. Because it's just a Slate element you can do all the following:

    • You can choose to display image as block or inline image.
    • You can choose to make it a void blocks (no editable inner content) or support editable content like an editable caption.
    • You have full control over how it displays (e.g. rounded edges, drop shadows, outlines)
  • Coming Soon:

    • Image presets. Specify preset sizes for thumbnail, preview and full if you desire
    • Image imports. When a user pastes the URL of an image, it automatically uploads the image to the editor.
    • Sharpening. Enable additional image processing like sharpening for low DPI displays. Sharpening is probably not required for high DPI displays.

Attachment Features

  • Default implementation shows attachment block with filename, file size (friendly format like 12KB) and the progress bar

  • Supports progress bar while uploading on custom attachments with a <ProgressBar> Component

  • Fully customizable to display aspects like size of file, original filename and who uploaded the attachment.

General Features

  • Has an async save method that ensures that all the images and attachments have finished uploading with an optional timeout. If the timeout is reached first, will return the document without the completed uploaded.

  • Uses a secret API key just for you that gives you control over who can upload, how much and for how long giving you secure control over uploading.

  • Coming Soon:

    • Tag file uploads, for example with a userId or a projectId
    • Limit file uploads based on tags and customize message when a limit is exceeded. For example, user johndoe can upload up to 1 GB and then he is shown a message and given a link to the upgrade page.

Package Sidebar

Install

npm i slate-cloud

Weekly Downloads

1

Version

11.0.0

License

MIT

Unpacked Size

174 kB

Total Files

137

Last publish

Collaborators

  • thesunny