- We’ve built the next version of the File Uploader.
This article comes in handy when you want to alter the default Uploading Widget initialization behavior. That can be done to get more control over Uploading Widget on your system and has to do with the two following boolean parameters:
UPLOADCARE_MANUAL_START, the option which defaults to
falseand controls the start of Uploading Widget initialization.
UPLOADCARE_LIVE, the option which defaults to
trueand controls the character of that initialization.
This means that by default Uploading Widgets are initialized during your page load. And,
every ~100 ms we check if there are any new inputs with the specific role
Automatic vs manual init
All Uploading Widgets on your page are initialized during its load, which may not be the
desired behavior when you want to do something before the page load. That is
UPLOADCARE_MANUAL_START option comes in
You should pass the
uploadcare.start() to override global settings.
However, you can still pass any global settings, but keep in mind that
settings keys are
UPLOADCARE_CROP for details about the snippet above.
Checking for new inputs
By default, new
[role=uploadcare-uploader] elements on your page are
initialized as Uploading Widget in every ~100 ms. Such behavior is caused by a single
However, if you would like to alter this behavior, consider disabling the
UPLOADCARE_LIVE option. Then, you will have to
manually init any new inputs with the specified