Skip to content

Dropzone-ui(7.0.2) = Files-ui(1.0.5)

Latest
Compare
Choose a tag to compare
@JinSSJ3 JinSSJ3 released this 29 Mar 05:20
· 3 commits to master since this release
8b6806b

Dropzone UI has grown very fast and has exceeded its original scope. That's why we find it reasonable to rebrand it and create a new package taking the best of this one and adding more features and new components. This new package is here and its name is Files UI ⚡
In an very near future we'll stop giving support to dropzone-ui, so we enforce you to upgrade to the new package.

In the meanwhile dropzone-ui package will become a wrapper for files-ui.

👀 📚 ⚡ Live demos and full documentation : files-ui.com

DropzoneUI_to_FilesUI

🧪 New features and 🐛 🔨 Improvements

  • ExtFile: Data estructure that "extends" the File Object. This object is designed to allow the information exchange between components. This data type replaces the old "FileValidate" type from dropzone-ui.

  • <FileMosaic/>: This new component replaces the old "FileItem" component.

    • Dark mode: Now this component can be adpted to a dark mode pages with the respective prop.
    • New icons: Icons for delete were changed.
    • For uploading, the loader can support to display the current progress.
  • <FileCard/>: This new component is an alternative version of FileMosaic. It displays the file info in a card. Receives the same props as FileMosaic plus elevation.

  • <FileInputButton/>: This component replaces the old "InputButton" component. The features are the same as the dropzone except the header and footer related features. That means that this component now can trigger the upload progress.
    Validation is optional, so non valid files can be uploaded.

  • <Avatar/>: This new component is designed tohandle the selection of images for changing the avatar. Can recieve as source an string url or even a File.

  • <FullScreen/>: The old components "FullScreenImage" and "FullScreenVideo" have been separated into FUllScreen, ImagePreview and VideoPreview.

    • FullScreen: component for display in a fullscreen backdrop other components.
    • ImagePreview: component is an <img/> tag enhanced to allow as src a string url or a ile object.
    • VideoPreview: component is an <video/> tag enhanced to allow as src a string url or a ile object.
  • <Dropzone/>: This component has been refactored to improve the design, colors and internal components such us headeror footer.

    • Header and footer can be handled through 2 new props: headerConfig and footerConfig
    • Action buttons: these are external buttons thta can trigger the default operations in dropzone.
    • Uploading: The upload operation now is completele handled using pure javascript without external libraries wich means axios is no longer a dependency.
  • smartImgFit: This is a special prop for FileMosaic, FileCard and Avatar components that makes someway "smart" the components to fit the images depeding on their orientation ("landscape" or protrait). Square images are hardly afected.

    • How it works?

      • If false, image width will be set to 100%.
        If present, image will be analized and displayed according to its heigh and width. Image with height greater than its width has a "portrait" orientation. Otherwise it has a "landscape" orientation. .

        - If value is "orientation", image will be displayed complete by giving 100% to width prop if the orientation is "landscape". When orientation is "portrait", height prop will be set to 100%. Some images will show an empty space.
        
        - If value is "center", image will be centered and will not be displayed complete. This the empty space is avoided. This is achived by giving 100% to width prop if the orientation is "portrait". When orientation is "landscape", height prop will be set to 100%.
        
  • FilesUIProvider: Localization and darkMode are props that can be set globally by using the React context API. Also the new feature that comes wit this improvement is that now is possible to set custom file icons for every file type.

  • Download Files: Both FileCard and FileMosaic components are able to perform download from same origin or external resources.

📚 Improved documentation.

  • The complete documentation can be found in files-ui web page.