Date: 02-Mar-2017 (under development)
- (enh #863): New plugin method
zoom
with parameterframeId
to allow custom triggering of zoomed preview for each thumbnail frame. - (enh #881): Update Spanish Translations.
- (bug #882): Correct image resize validation.
- (enh #875): Reset form based events more correctly to allow multiple bootstrap file inputs within forms.
- (bug #885): Correct validation for
allowedFileTypes
. - (enh #886): Append zoom modal dialog to
body
element if available to avoid multiple BS modals conflict. - Enhance events like
fileclear
andfilepreajax
to be aborted viaevent.preventDefault()
. - (enh #887): New properties
msgUploadBegin
andmsgUploadEnd
to display a better progress status. ThelayoutTemplates.progress
will support a new token{status}
. - Enhance uploaded thumb frames to not reset or change the frame identifier after successful upload.
Date: 21-Feb-2017
- (bug #870): Correct config.width parsing.
- (bug #872): Correct typo in
bootstrap.min.css
. - (enh #874): Enhance/Standardize CSS Styles for Krajee Default Theme.
- (enh #876): Update Spanish Translations.
- (enh #879): Update Russian Translations.
Date: 11-Feb-2017
- (enh #812): Update Greek Translations.
- (enh #815): Enhance parsing of thumbnails that are visible in preview (will allow plugin to be initialized in hidden containers like tabs).
- (enh #816): New property
msgFileTypes
to control descriptions/localizations of file types displayed. - (bug #819): Correct init preview auto replace post
uploadSingle
action in thumbnails. - (enh #820): Prevent resize if image is smaller than allowed dimensions.
- (enh #822): Enhancement for preventing upload when data is empty. New property
msgUploadEmpty
has been incorporated. - (enh #823): Correct file indices assignment during validation of images.
- (enh #824): Add Korean Translations.
- (bug #825): Correct
fileimagesresized
event triggering. - (bug #826): Extend language configuration to consider defaults.
- (enh #828): Allow drag sort of single uploaded thumbnails with
initialPreview
config set (post upload). - (enh #831): Update Finnish Translations.
- (bug #833): Correct validation and defaults init for
allowedPreviewTypes
. - (bug #834): Correct clearing of file preview including zoom cache.
- (enh #835): Update Polish Translations.
- (enh #837): Update Czech Translations.
- (bug #839): Correct
initialPreview
generation and sortable behavior for async uploads. - (enh #844): Display zoom preview navigation buttons only when multiple files exist.
- (enh #662, #725): Enhance preview modal to be appended to body before each zoom action (if
body
tag exists). - (enh #847): Update German Translations.
- (enh #851): Create Kazakh Translations.
- (bug #852): Ensure
frameClass
setting ininitialPreviewConfig
is considered. - (enh #854): Better file size calculation and display.
- (enh #857): Default error handling for unknown ajax errors.
- (enh #858): Thumb Frame CSS class as configurable property.
- (enh #859): Enhance and revamp preview caching.
- (enh #860): Initialize template defaults in a better manner.
- (enh #861): New properties within
layoutTemplates
. - (enh #862): Launch a brand new Krajee theme:
explorer
.
Date: 17-Dec-2016
- (enh #696): Better default preview zoom settings.
- (enh #764): Update Russian Translations.
- (enh #771): Update Chinese Translations.
- (enh #769, #785, #786, #787): Better image resized event handling.
- (enh #779, #789): More correct thumbnail identification post rearrange.
- (enh #782): New validation for invalid slug file name (caption):
- if slug callback returns an empty string, then an error will be thrown using
msgInvalidFileName
. - if slug callback returns
false
then the next file will be read and current file skipped.
- if slug callback returns an empty string, then an error will be thrown using
- (enh #788): New validation for minimum file size:
- new property
minFileSize
which validates the minimum file size in KB for upload, else throws a validation error usingmsgSizeTooSmall
. This defaults to0
. - if
minFileSize
is set tonull
, then above validation is skipped and no minimum file size check is performed.
- new property
- (enh #791): Auto orientation of images based on EXIF data.
- (enh #799): Fix IE memory issue on image load.
- (enh #800): Update Spanish Translations.
- (enh #802): Allow MOV files preview for supported devices and browsers.
- (enh #803): Update Hungarian Translations.
- (enh #804): Add Slovenian Translations.
- (enh #809): Various enhancements for preview control and iconic thumbnails.
- add ability to control and render different previews for file thumbnails and zoomed preview content
- new property
preferIconicPreview
will try to parse thepreviewFileIconSettings
andpreviewFileExtSettings
to automatically force iconic previews for file thumbnails. - new property
preferIconicZoomPreview
will try to parse thepreviewFileIconSettings
andpreviewFileExtSettings
to automatically force iconic previews in the zoomed content. - the above properties will be applied and parsed for
initialPreview
content as well.
Date: 20-Sep-2016
- (bug #734): Correct right parsing of
fileuploaded
event params. - (enh #736): Update Portugese Brazilian Translations.
- (enh #741): Update Vietnamese Translations.
- (enh #745): Update Russian Translations.
- (bug #753): Correct IE11 file clear bug when using without ajax.
- (bug #758): Correct file slug name parsing for an invalid file extension.
Date: 07-Aug-2016
- (bug #710): Fix bug for
ifSet
validation. - Add contribution templates.
- (enh #715): Reset caption correctly on clear.
- (enh #718): Update Japanese Translations.
- (enh #719): Pass right
previewId
tofileuploaded
event. - (enh #721): Update Turkish Translations.
- (bug #722): Correctly concat ajax output in initial preview.
- (enh #728): Change sortable plugin name to avoid conflict with JUI Sortable.
- (enh #729): Implement
progressUploadThreshold
to show processing when waiting for server response. - (enh #730): Correct Romanian Translations.
- (enh #731): New method
getFilesCount
for returning upl + non-upl files count.
Date: 09-Jul-2016
- (enh #680): Populate filestack for files greater than maxFilePreviewSize.
- (enh #695): Update Spanish Translations.
- (enh #698): Re-enable drag and drop support for IE Edge.
- (bug #700): Fix custom preview icons to be displayed and validated correctly.
- (enh #702): Add files to stack correctly for max & min preview size validation.
- (enh #704): Add grammatically correct "No files selected" message.
- (enh #706): Remove invalid files from filestack correctly for validation errors.
Date: 11-Jun-2016
- (bug #595): Correct initialization of
allowedPreviewTypes
. - (enh #600): Synchronize latest package on NuGet.
- (enh #604): Fixed unset method in deleting previewCache index.
- (enh #605): Fixed previewCache tags reset.
- (enh #615): Correct Finnish Localizations.
- (enh #618): Update German Translations.
- (enh #632): Find correct filename in IE9.
- (enh #633): New property
maxFilePreviewSize
to control preview of large size files. - (enh #634): Enhance ability for PDF and HTML preview.
- Enhanced PDF support as PDF embedding is now possible for
initialPreview
. In addition a new template for PDF is available withinpreviewTemplates
. - HTML Preview is enhanced with a better template. The plugin also now includes support for
DOMPurify
plugin (and available in plugins folder). This processes and cleans the HTML from XSS before previewing. This behavior can be controlled viapurifyHtml
property that defaults totrue
.
- Enhanced PDF support as PDF embedding is now possible for
- (enh #635): Various preview enhancements. Previews will be revamped with various functionality:
- Add ability to zoom every thumbnail to a modal preview. So all types of files (images, videos, pdf, text etc) can be previewed in a larger zoom dialog window.
- Automatic slideshow like interface for zoom preview modal. One can navigate left or right to view previous or next content in the preview. In addition to button navigation, keyboard navigation (via left/right arrow keys) is also available.
- Borderless maximized mode and Full Screen mode available for preview.
- Auto disable the previous or next button when the first or last file/image is reached.
- Now
initialPreview
can be setup MORE easier without writing or returning entire markup. Thus the new functionality will enable to use built inpreviewTemplates
. - A new boolean property
initialPreviewAsData
is available to control the above. If set totrue
, it will allow developers to now pass just the data withininitialPreview
(instead of complete markup) and the markup will be auto generated usingpreviewTemplates
. - New property
initialPreviewFileType
to set the default file type for initial preview. Defaults toimage
. Must be on of the keys infileTypeSettings
. - All the other settings can be controlled via
initialPreviewConfig
. The new properties available withininitialPreviewConfig
are:type
: OverrideinitialPreviewFileType
at global level and set a separate type for each file in the initial preview.previewAsData
: boolean property to override theinitialPreviewAsData
setting at global level
- New zoom preview control buttons:
prev
next
fullscreen
borderless
toggleheader
close
- The other new settings to control zoomed preview:
previewZoomSettings
: Will allow to set the CSS style (e.g. width, height and other CSS style settings) for each zoomed content type (i.e.image
,pdf
,video
etc.).previewZoomButtonIcons
: Ability to set the labels for previous, next, fullscreen, borderless, and close buttons.previewZoomButtonTitles
: Ability to set the titles for previous, next, fullscreen, borderless, and close buttons.previewZoomButtonClasses
: Ability to set the CSS classes for previous, next, fullscreen, borderless, and close buttons.
- Modifications to all language locales JS for accomodating new translations
- (enh #636): File action enhancements.
- Zoom and Drag buttons will be shown as an additional file action buttons in addition to
upload
andremove
- New boolean properties
showZoom
,showDrag
,showRemove
,showUpload
are now added tofileActionSettings
to control display of these buttons - New properties
zoomIcon
,zoomClass
,zoomTitle
are available withinfileActionSettings
for controlling the zoom button styles and display. - New properties
dragIcon
,dragClass
,dragTitle
are available withinfileActionSettings
for controlling the drag indicator styles and display. - New properties
actionZoom
andactionDrag
are available withinlayoutTemplates
to configure the markup of the zoom and drag buttons.
- Zoom and Drag buttons will be shown as an additional file action buttons in addition to
- (enh #639): Add ability to just require package in nodejs
- (enh #640): Ability to theme and provide font awesome theme. New property
theme
added. - (enh #641): Wrap readFile(index + 1) in a function to prevent 'unsafe-eval' blocking with CSP.
- (enh #642): Reorganize JS code into proper folders. Following folders will be added/maintained
locales
: all translation JS files will be located herethemes
: all theme JS files will be located hereplugins
: third party JS plugins that will be used to work with bootstrap-fileinput
- (enh #643):Implement rearranging / sorting functionality for initial preview.
- Add ability to rearrange and sort thumbnails by drag & drop. This feature will use the Sortable plugin which will be included in the
js/plugins
folder. - This feature will be available only for initial preview thumbnails for both ajax and form uploads.
- New property for drag indicator and drag behavior configurations will be included in
fileActionSettings
:showDrag
dragIcon
dragClass
dragTitle
dragSettings
- New template
actionDrag
will be available withinlayoutTemplates
to configure your drag indicator markup.
- Add ability to rearrange and sort thumbnails by drag & drop. This feature will use the Sortable plugin which will be included in the
- Simpler naming for files in locales and themes folders.
- (enh #647): Display file size in previews and templates.
- Enhancements to file preview icons (
other
template). - (enh #654): Update Spanish Translations.
- (enh #655): Include sass styling configuration.
- (enh #666): Update sortable draggable selector.
- (enh #674): Organize all themes in a separate
themes
folder. - (enh #650, #676): Ability to configure browse button display and file select via zone click.
- New boolean property
showBrowse
that allows you to control the display of the browse button - New boolean property
browseOnZoneClick
that allows you to select a file:- for ajax uploads - by clicking on the preview drag/drop zone
- for form based/non-ajax uploads - by setting
defaultPreviewContent
and that will be clickable to browse files
- New string message property
dropZoneClickTitle
that will be appended to thedragZoneTitle
for ajax uploads whenbrowseOnZoneClick
istrue
.
- New boolean property
Date: 28-Feb-2016
- (enh #514): Set default value for
removeFromPreviewOnError
tofalse
. - (enh #554): Update documentation and demos to include
webkitdirectory
for upload. - (enh #555): Set default value for
removeFromPreviewOnError
tofalse
. - (enh #557): Enhance default file type parsing to intelligently not render unpreviewable content.
- (enh #559): Allow custom error display styles (e.g. via bootstrap dialog) through these changes:
- added
msg
param infileerror
,fileuploaderror
, andfilefoldererror
events.
- added
- (enh #560): Update French Translations.
- (enh #565): Enhance progress bar display when upload is aborted or cancelled.
- (enh #567): New properties and improved messages.
- (enh #572): Add Finnish Translations.
- (enh #573): Update package.json to include
peerDependencies
. - (enh #574): Change naming convention for private / internal methods. Prepend internal plugin methods with underscore
_
. - (enh #575): Implement public method chaining and update docs for methods.
- (bug #576): Correct previewCache initialization.
- (bug #577): Better label spacing for default browse icon.
Date: 25-Jan-2016
- (enh #550): Correct Drag and drop issue with v4.2.9.
Date: 22-Jan-2016
- (enh #489): Update documentation for
change
andfileselect
events. - (enh #521): Update Dutch Translations.
- (enh #523): Add new branch
sass
forbootstrap-sass-official
support. - (enh #530): Error alert box and preview thumbnail styling enhancements.
- (enh #531): Enhance/Fix typos of Arabic translation.
- (enh #534, enh #535): Ability to remove errored file thumbnails via
removeFromPreviewOnError
. - (enh #541): Improve default slug callback to accept most characters.
- (enh #545): Refactor code to deep extend options correctly.
Date: 18-Nov-2015
- Update bootstrap bower version to support only 3.x variants.
- Implement package.json.
- (enh #449): Add Arabic Translations.
- (enh #454): Update Turkish Translations.
- (enh #460): Update CSS selectors prefix to start with
file
. - (enh #462): Responsive buttons and new property
buttonLabelClass
. - (enh #465): Add Català translations.
- (enh #474): Upload via button within each preview thumbnail skips last file for async uploads.
- (enh #477): Fix IE10 specific styling bug for file input block button.
- (enh #481): Universal Module Definition for use with CommonJS, AMD or browser globals.
- (bug #483): Clear and reset native input after uploading each single file thumbnail.
- (enh #488): Publish to npm.
- (enh #490): Fix
zh-TW
translationbrowseLabel
wording. - (enh #494): Add Indonesian translations.
Date: 13-Sep-2015
- (bug #420): Revamp file status progress and positioning updates for asynchronous upload.
- (enh #427): Add image resizing capability before upload.
- (enh #428): Enhancements to asynchronous uploads when
showPreview
isfalse
. - (bug #429): Fix for MS Edge bug that does not support drag and drop.
- (enh #431): Add Danish locale translations.
- (enh #432): Send slugged file names with the file blob when uploading via ajax.
- (enh #433): Added new events for image handling.
fileimageloaded
(fires after each image is loaded in preview) - this is an existing eventfileimagesloaded
(fires after all images are loaded in preview)fileimageresized
(fires after each image in preview is resized)fileimagesresized
(fires after all images in preview are resized)fileimageresizeerror
(fires when any image resize error is faced)
- (enh #434): Added Japanese translations.
- (enh #436): New property
showClose
and new layout templateclose
to control close icon display. - (enh #437): New property
defaultPreviewContent
to control a default preview. - (bug #442); Enhance the filenames parsing in the filestack and slug conversion.
Date: 26-Aug-2015
- (enh #373): Default delete ajax request type to POST (instead of DELETE).
- (enh #376): Ability to validate initial/server files for max and min file count.
- (enh #377): Various enhancements to text preview.
- (enh #378): Ability to configure different icon thumbnails for preview files.
- (enh #379): Combine more translatable settings and update locale js files.
- (enh #380, #381): Consistent styling for thumbnails.
- Update translations to include
fileActionSettings
. - (enh #382): Better implementation for parsing text in
parseError
method. - (enh #385): Updated Russian & Ukranian translations.
- (enh #387): Reset
initialCaption
better when preview is cleared. - (enh #389): New templates and styling enhancements to caption and main buttons.
- (enh #390): Thumbnail error display enhancements.
- (enh #391): Thumbnail styling enhancements for flash, html, and object types.
- (enh #392): Enhancements to allow using plugin functions directly.
- (enh #393): Minor enhancements to abort events before upload.
- (bug #398): Validate
data.errorkeys
more correctly. - (enh #401): Various enhancements to preview file thumbnails and error validations.
- (enh #405): Create traditional Chinese translations.
- (enh #410): Better validation for IE 10 and below.
- (enh #412): Enhancements to file upload cancellation.
- (enh #413): Various updates to translations.
- (enh #426): Enhancements to progress bar and display thumbnail specific progress.
Date: 27-Jul-2015
- (enh #362): Add Bulgarian translations.
- (bug #370): Reverts #342 with better fix.
- (enh #371): Ability to replace files in the preview. New
autoReplace
property. - (enh #372): Create new event
filepreajax
.
Date: 22-Jul-2015
- (enh #340): Receive
previewId
andindex
in extra data for individual thumbnail uploads (ajax). - (enh #342): Add ability to modify extra data before ajax upload in
beforeSend
events. - (enh #351): Updates to Ukranian & Russian translations.
- (enh #356): Implement
destroy
method. - (enh #357): Enhanced and better
refresh
method. - (enh #358): Implement event namespaces and enhance event handling process.
Date: 21-Jun-2015
- (enh #336): Fixes to reset preview via
initUploadSuccess
.
Date: 18-Jun-2015
- (enh #332): Bump nuget and bower package versions.
Date: 15-Jun-2015
- (enh #279, #280): Fixed error for failed response types.
- (enh #287): Add Brazilian Portugese (pt-BR) translations.
- (bug #295): Validate
overwriteInitial
correctly for ajax uploads. - (enh #296): Fixed license identifiers in bower.json and composer.json.
- (enh #297): Add Romanian translations.
- (enh #299): Enhancements for displaying uploaded file thumbnails.
- New property
showUploadedThumbs
that will display uploaded thumbnails until the remove/clear button is explicitly pressed. - New event
filesuccessremove
. This will be triggered on removing the uploaded thumbnail using the thumbnail delete button. The event shares the following parameters:id
: the HTML id attribute of the thumbnail container Theevent
can be set to returnfalse
to abort the thumbnail removal.
- New property
- (enh #302): Add Greek (el) translations.
- (enh #303): Validate only files to be dragged and dropped.
- (enh #305): Implement better cleanup of memory with
revokeObjectURL
. - (enh #307): Allow setting thumbnail frame css class and attributes via
initialPreviewConfig
. - (enh #308): Better check for
data.error
being empty. - (enh #309): Fixes for older browsers.
- (bug #310): Set missing caption icon on error.
- (bug #315): Fix parsing of preview settings for default (other) preview.
- (bug #327): More correct clearing of preview.
- (bug #328): Implement image dimension validations.
- New properties added to the plugin:
minImageWidth
minImageHeight
maxImageWidth
maxImageHeight
msgImageWidthSmall
msgImageHeightSmall
msgImageWidthLarge
msgImageHeightLarge
- New properties added to the plugin:
- (enh #329): Message translation updates.
- (enh #330): Minor enhancements in validating preview and progress bar display.
Date: 11-May-2015
- (enh #275): Add Czech & Slovakian translations.
- (enh #277): New
language
property to allow configuring multi lang widgets on same page.
Date: 02-May-2015
- (enh #232): Update docs to reflect updated bootstrap CDN domain.
- (enh #237): Better styling of file caption icon.
- (bug #238): Correct initialization of plugin variables when other than maxFileCount & maxFileSize.
- (enh #241): Enhancements to initial preview delete to perform validations before delete.
- (bug #243): Correct sending of
deleteExtraData
. - (enh #244): Add Serbian translations.
- (enh #245): Allow initial caption to be set without initial preview.
- (bug #247): Correct mime types validation.
- (enh #248): keep chinese characters in file caption.
- (bug #249): Fix error message content display.
- (enh #250): Change default slug routine to allow umlauts in filenames.
- (enh #251): Add Italian localizations.
- (enh #252): Enhance async batch completion.
- (bug #253): Fix initial preview delete cache initialization.
- (bug #257): Fix upload single to replace thumbs correctly.
- (enh #258): Enhance messages to include file plural and single.
- (enh #259): Add Polish translations.
- (enh #263): Enhance parsing of file preview thumbnails and actions.
- (enh #264): Validate input type of file before initializing plugin.
- (enh #269, #272): Add Turkish translations.
- (enh #270): Add Portugese translations.
- (enh #271): Add Dutch translations.
- (bug #273): Reset caption correctly after all initial preview is deleted.
Date: 30-Mar-2015
- (bug #171): Fix typo for files validation.
- (enh #167, #173): New
deleteExtraData
property for ajax deletions. - (enh #174): New
deleteUrl
property. - (enh #175): Ability to override delete extra data in
initialPreviewConfig
. - (enh #176): Wrong file in README installation steps fixed.
- (enh #177): Trigger filebatchpreupload if showPreview is
false
. - (enh #178): Updated README for cancel button configuration.
- (enh #179): Validate and cast
maxFileSize
andmaxFileCount
to numeric - even if they have been setup as a string. - (enh #181): Fix change event triggered for IE 11 when file input is set to empty.
- (enh #183): Delete extra data enhancements.
- (enh #184): Fix documentation for filedeleted event.
- (enh #187): New property
previewFileIcon
to configure file icon shown in preview for unreadable file types. - (enh #188): Clear fileinput more correctly for all browsers when initialPreview is set enhancement
- (enh #189): Reinitialize initial preview delete events correctly on file selection.
- (enh #192): Ability to extend and add one's own ajax settings.
- New property
ajaxDeleteSettings
to help extend and add to delete ajax settings. ajaxSettings
to help extend and add upload ajax settings
- New property
- (bug #193): Better validation for triggering
filebatchuploadcomplete
on async batch upload completion. - (enh #202): Ability to add Translations / Locales.
- Identify and group all messages that need to be translated configurable via
$.fn.fileinput.locales['<lang-code>']
- Set default english messages configuration
$.fn.fileinput.locales['en']
within the plugin core code - Individual locale files need to be created as separate js files e.g.
<lang>.js
- Identify and group all messages that need to be translated configurable via
- (enh #203): Enhancements and revamp of all error events.
- fileerror
- fileuploaderror
- filebatchuploaderror
- filedeleteerror
- filefoldererror (new event - see #209)
- filecustomerror (new event - see #206)
- (enh #204): New properties
fileMinCount
andmsgFilesTooLess
(useful to make file input mandatory).- The
fileMinCount
property will allow to set the minimum file count needed before triggering upload. It will work for bothajax
uploads andnormal form based submission
. - This will enable you to set the file input to be a mandatory / required input. (e.g.
fileMinCount
=1
). ThemsgFilesTooLess
will be displayed and error raised. - If
fileMinCount
is set to0
it will be treated as files are optional and no error will be triggered.
- The
- (enh #205): Allow to auto set initialPreview within
filebatchuploadcomplete
&filebatchuploadsuccess
.- Allows you to auto define the
initialPreview
andinitialPreviewConfig
after an ajax upload by returning these within the data object from your ajax response onfileuploaded
&filebatchuploadsuccess
.
- Allows you to auto define the
- (enh #206): Ability to add custom validation and trigger custom error to abort upload.
- This enhancement will enable you to add your additional custom validations to enhance the fileinput to be used for innumerous scenarios. It will allow an ability to return an associative object with any of the fileinput events (except the error events and the
filebatchuploadsuccess
orfilebatchuploadcomplete
) e.g.change
,fileselect
,filepreupload
,filebatchpreupload
etc. The object can return the following keys:message
: string, the validation error message to be displayed before upload. If this is set the plugin will automatically abort the upload whenever called and display this as an error message. You can use this property for example to read a file and perform your own custom validation.data
: object, an optional associative array of additional data that you can pass for usage later.
- You can get this data by reading
abortData
in the parameters for the newfilecustomerror
event. This new event will be triggered during upload, when you have triggered an abort from any of the other events.
- This enhancement will enable you to add your additional custom validations to enhance the fileinput to be used for innumerous scenarios. It will allow an ability to return an associative object with any of the fileinput events (except the error events and the
- (enh #209): Better validation for folder drag and drop and auto-skip any dropped folders. New property
msgFoldersNotAllowed
added to the plugin to allow configuring the message shown. The eventfilefoldererror
is triggered when a folder is dragged. - (enh #211): Add ability to show detailed server error stack via
showAjaxErrorDetails
. - (enh #212): Revamp preview to use a new preview caching object.
- (enh #213): Code cleanup, eliminate change event on clear and properly reset preview cache after ajax deletes.
- (enh #215): Set default delete method REST compliant.
- (enh #216): Add Hungarian Translations.
- (enh #217): Ensure
filebatchselected
event is triggered after FileReader completes reading files selected. - (enh #218): Do not clear preview for ajaxuploads until remove button clicked.
- (enh #222): Enhance to include dynamically replaceable thumbnail tags. Two new properties
previewThumbTags
andinitialPreviewThumbTags
will be available for configuration. - (enh #225): Create Russian translations.
- (enh #226): Create Spanish (Latin American) translations.
- (enh #227): Created Ukranian translations and updated Russian translations.
- (enh #228): Created Thai translations.
- (enh #229): Created French translations.
- (enh #230): More correct initial preview delete reset.
Date: 13-Feb-2015
- (enh #149): Custom tags support for layoutTemplates and previewTemplates (new properties
customLayoutTags
andcustomPreviewTags
included). - (enh #151): New
filebatchselected
event triggered after every batch of files are selected. - (enh #152): New faster
replaceAll
method instead of regexp parsing to replace tags in templates. - (enh #153): Improve error handler for trapping FileReader security exceptions and new property
msgFileSecured
will display the security exception message. - (enh #154): Code cleanup and restructure for JS lint changes (using JSHint Code cleanup library).
- (enh #155): Allow display of long file names without spaces/word breaks.
- (enh #156): Fix reset of file stack for various upload modes (single, batch async and batch sync).
- (enh #157): Upload progress bar styling enhancements.
- Allow upload progress bar css class to be configurable
- Create and allow two different styles/css classes for progress bar
progressClass
: styling for progress bar when upload is in processprogressCompleteClass
: styling for progress bar when upload is complete
- (bug #159): Ensure filestack is passed correctly with
outData
for events. - (bug #160): Correct documentation typo for usage.
- (enh #162): New property ajaxSettings to allow configuring ajax params.
- Set copyright year to current.
- Relocate sample files from examples directory to bootstrap-fileinput-samples repo.
Date: 20-Jan-2015
- (enh #124): Allow submission of extra data even if no files are selected.
- (enh #131): Allow empty values in extra data to be submitted.
- (enh #136):Create new upload method that can be called externally.
- (enh #137): Trigger new events -
filedisabled
andfileenabled
. - (enh #139): Reset file stack correctly on ajax upload completion.
Date: 12-Jan-2015
- (bug #100, #101): Set right params for error thrown during reading of files.
- (bug #104): Fix formdata not defined.
- (enh #105): Expose current jqXHR object on ajax events.
- (enh #106): Enhance events for ajax requests and enable cancelling sync uploads
- (enh #108): Add nuget package.
- (bug #112): Fix undefined filestack for individual file upload within preview.
- (bug #113): Icon layout template undefined when using user template.
- (bug #114): Prevent multiple file selection when using single file configuration.
- (enh #115): Autosize file caption responsively on window resize.
- (enh #116): Hide remove and upload buttons until unless file(s) are selected.
- (enh #119): Enhance caption to include ellipsis for long file names
- (bug #120): Correct multiple iterations of upload for async batch uploads.
- (enh #121): Animate progress bars by default for upload progress.
Date: 26-Dec-2014
- (enh #88): Allow uploadExtraData to be passed as a callback.
- (enh #89): New
otherActionButtons
to allow adding customized initial preview content actions. - (enh #90): New event
filebatchpreupload
for both synchronous and asynchronous batch uploads. - (enh #91): Pass FileReader instance with outData in events.
- (enh #92): Realign event triggering timing for batch uploads to ensure outData is available.
- (enh #93): Better styling of file upload icon indicators in thumbnails.
- Code cleanup with reusable methods for event raising and outData generation.
- (bug #95): Correct event off for drag & drop in plugin refresh method.
- (bug #97): Reset events correctly with plugin refresh method.
Date: 20-Dec-2014
- (enh #85): Combine output data as a single object, that is sent for various file upload events.
filepreupload
fileuploaded
fileuploaderror
filebatchuploaderror
filebatchuploadsuccess
filebatchuploadcomplete
- (enh #86): Disable thumbnail action buttons when upload is in progress.
- (enh #87): More correct progress indicator percentage for asynchronous upload.
Date: 19-Dec-2014
- (enh #81): Add new events:
filebatchuploadsuccess
filebatchuploadcomplete
- (enh #80): Allow access to
uploadExtraData
andresponseData
to following eventsfilepreupload
fileuploaded
fileuploaderror
filebatchuploaderror
filebatchuploadsuccess
filebatchuploadcomplete
filelock
fileunlock
Date: 18-Dec-2014
- (bug #76): Update filestack when
showPreview
is false. - (bug #78): Set uploadExtraData parameters to be correctly sent via POST.
- (enh #58): Set a new property
textEncoding
for reading the text files with right encoding.
Date: 17-Dec-2014
- (enh #74): Enhancements to file validation errors for both FORM and AJAX uploads.
- For normal Form based uploads automatically disable the Upload button
- Display a separate error styled thumbnail for the file that faced the validation error.
- Reset errors correctly to overwrite files with a new change or drag/drop
- (enh #75): Better validation of browser support for drag and drop.
Date: 14-Dec-2014
- (enh #70): Version 4.0 enhancements.
- Renamed
initialDelimiter
toinitialPreviewDelimiter
- (bug #72): Fix bootstrap ## version constraint.
- Add functionality for AJAX based UPLOAD using HTML5 FormData (most modern browsers support it). Will degrade to normal Form Based File submission if this is not supported.
- To use AJAX Upload, the
uploadUrl
property is MANDATORY and must be set. - Enhance plugin to now allow files to be added, appended, removed (based on FEEDBACK from many). Thus one can append files to preview.
- New DRAG & DROP zone available in preview to drag and drop files and append.
- Delete or upload files one by one OR in batch.
- If
showPreview
is set to false, or uploadUrl is not supported plugin will degrade to normal form based upload. - Configurable indicators for file awaiting upload, file successfully uploaded, files errored in upload.
- Ability to add extra form data with ajax based uploads.
- Upload progress bar and individual thumbnail upload indicators.
- Ability to cancel and abort ongoing AJAX uploads.
- Templates have been revamped and enhanced for each file type.
- Ensure plugin is still lean in size and optimized for performance inspite of the above features by optimally utilizing HTML5 & jquery features only.
showCancel
: shows a cancel button for aborting ajax uploads (defaults totrue
).cancelLabel
: label for the cancel button.cancelTitle
: title for the cancel button on hover.cancelIcon
: icon markup for the cancel buttoncancelClass
: CSS class for the cancel button.removeTitle
: title for the remove button on hover.uploadTitle
: title for the upload button on hover.uploadUrl
: the url that will be used to process AJAX based uploads (using FormData XHR2).uploadExtraData
: extra data that will be passed as data to the url/AJAX server call via POSTuploadAsync
: whether the batch upload of multiple files will be asynchronous/in parallel. Defaults totrue
.initialPreviewShowDelete
: shows a delete button for each initial preview content's thumbnail (defaults totrue
).initialPreviewConfig
: configuration for setting up eachinitialPreviewContent
item (associative array/object)caption
: The caption or filename to display for each initial preview item content.width
: The CSS width of the image/content displayed.url
: The URL for deleting the image/content via AJAX (shown only forinitialPreviewContent
).key
: The key that will be passed to the URL via POST (shown only forinitialPreviewContent
).
dropZoneEnabled
: Enable a drag and drop zone for dragging files and is available only for ajax based uploads (defaults totrue
).dropZoneTitle
: Title to be displayed in the drag & drop zone.dropZoneTitleClass
: CSS class for the drag & drop zone title.fileActionSettings
: configuration for setting up actions for newly selected file thumbnails in the preview (associative array/object)removeIcon
: icon for remove button to be displayed in each file thumbnail.removeClass
: CSS class for the remove button in each file thumbnail.removeTitle
: title for remove button in each file thumbnail.uploadIcon
: icon for upload button to be displayed in each file thumbnail.uploadClass
: CSS class for the remove button in each file thumbnail.uploadTitle
: title for remove button in each file thumbnail.indicatorNew
: an indicator (HTML markup) for new pending upload displayed in each file thumbnail.indicatorSuccess
: an indicator (HTML markup) for successful upload displayed in each file thumbnail.indicatorError
: an indicator (HTML markup) for error in upload displayed in each file thumbnail.indicatorLoading
: an indicator (HTML markup) for ongoing upload displayed in each file thumbnail.indicatorNewTitle
: title to display on hover of indicator for new pending upload in each file thumbnail.indicatorSuccessTitle
: title to display on hover of indicator for successful in each file thumbnail.indicatorErrorTitle
: title to display on hover of indicator for error in upload in each file thumbnail.indicatorLoadingTitle
: title to display on hover of indicator for ongoing upload in each file thumbnail.
Date: 08-Dec-2014
- (enh #60): Enhance upload button for disable/enable when used with
<a>
tag. - (bug #61): Refresh preview to show errors correctly after each file is validated.
- (enh #64): Add ability to override the slug method with a
slugCallback
property. - (enh #65): Correct validation of
refreshPreview
usingupdateFileDetails
. - (enh #67): Enhance support for IE browsers
- Add specific validations for parsing IE versions rightly
- Enhance plugin to extend styling support to IE 9 (with the limitation that IE 9 does not support HTML 5 features like multiple file upload)
- Fix clearing of file input rightly for IE 9 & IE 10
- Degrade plugin automatically to a native file input for older IE versions
- Prevent change method firing twice when file is cleared after error is encountered in IE 11.
- (bug #68): Fix refresh method of the fileinput to trigger change correctly.
Date: 23-Nov-2014
- (enh #53): Validations and events for right reset of files when browse button is clicked.
- (enh #55): Clear the files when file browse dialog is cancelled only if the browser clears the native file input.
- (enh #56): Trigger new events
filebrowse
andfileselectnone
.
Date: 13-Nov-2014
- (enh #50): Dynamically auto size file captions for long file names exceeding container width. New property
autoFitCaption
is added which defaults totrue
. When this istrue
the plugin will auto fit caption text within the container dynamically and responsively based on window size. - (enh #51): Autosize preview images when they exceed the size of the preview container.
- (enh #52): Raise new
fileimageloaded
event.
Date: 11-Nov-2014
- Set release to stable in composer.json.
- (enh #48): Trigger
fileloaded
event whenshowPreview
isfalse
. - (enh #49): Set image preview dimensions to auto fit and center
Date: 15-Oct-2014
- (bug #40): More correct fix for IE (ver < 11) inability to clear fileinput values.
- Templatize errorContainer for display within the preview window.
- (enh #42): Enhance plugin to configure the
elErrorContainer
for displaying validation errors. - (bug #43): Validate special characters in filename before generating caption.
- (bug #44): Browser IE10 hangs on file clear.
Date: 09-Oct-2014
- (enh #36): New feature. Validation routine for checking allowed file types and extensions.
- (bug #37): HTML encode text content for preview in modal.
- (enh #38): Highlight error CSS in file caption on validation error.
- (bug #39): HTML encode caption hover title.
- (bug #40): Fix IE (ver < 11) inability to clear fileinput values.
Date: 20-Sep-2014
- (enh #30): Enhanced generic support for more preview formats (audio, video, html, flash, and other objects).
- (enh #31): Better control and configuration of preview templates.
- (enh #32): Added checks for file api support.
- (enh #33): Better text format validation and correct modal preview.
Note: There are BC Breaking Changes with release v2.4.0.
With release v2.4.0, the plugin has been revamped to support and configure a wide variety of file formats for preview. This may break some backward compatibility (BC) for older versions that use custom templates.
The following are the major changes with release v2.4.0:
- Plugin has been revamped to build preview intelligence based on various file preview types. The inbuilt file support types are categorized as
image
,text
,html
,video
,audio
,flash
,object
, andother
. allowedPreviewTypes
: You can now configure which all file types are allowed to be shown as a preview. This defaults to['image', 'html', 'text', 'video', 'audio', 'flash', 'object']
. Thus all file types are treated as an object to preview by default. For exampleTo preview onlyimage
andvideo
, you can set this to['image', 'video']
.allowedPreviewMimeTypes
: In addition toallowedPreviewTypes
, you can also control which all mime types can be displayed for preview. This defaults to null, meaning all mime types are supported.layoutTemplates
: Allows you to configure all layout template settings within one property. The layout objects that can be configured are:main1
,main2
,preview
,caption
, andmodal
.previewTemplates
: All preview templates for each preview type have been combined into one property, instead of separate templates for image, text etc. The keys are the formats as set inallowedPreviewTypes
and values are the templates used for previewing. There are default prebuilt templates for each preview file type (generic
,image
,text
,html
,video
,audio
,flash
,object
, andother
). Thegeneric
template is used only for displayinginitialPreview
content using direct markup.previewSettings
: Allows you to configure width and height for each preview image type. The plugin has default widths and heights predefined for each type i.eimage
,text
,html
,video
,audio
,flash
, andobject
.fileTypeSettings
: Allows you to configure and identify each preview file type using a callback. The plugin has default callbacks predefined to identify each type i.eimage
,text
,html
,video
,audio
,flash
, andobject
.- Replacing tags within templates has been enhanced. With this release it will automatically check for multiple occurrences of each tag to replace within a template string.
NOTE: Flash preview will require Shockwave flash to be installed and supported by the client browser. The flash preview currently works successfully with webkit browsers only. Video & Audio formats are however supported by all modern browsers that support the HTML5
video
/audio
tags. Note that browsers have limited number of video/audio formats supported by the HTML5 video element (e.g. mp4, webm, ogg, mp3, wav). The size of video files are recommended to be small (to be controlled throughmaxFileSize
property) so that it does not affect the preview performance. You can copy a few files from theexamples
directory of this plugin repo, to test a few examples of flash and video files.
Date: 19-Sep-2014
- (enh #28, #29): Added support for previewing flash and video files.
- Better replacement of tags in templates. Replaces all tag occurences with this new release.
Date: 19-Aug-2014
- (enh #24): Update readAsBinaryString to readAsArrayBuffer
- (enh #25): Graceful degrade to normal file input for older browsers (including previous versions of Safari).
Date: 11-Aug-2014
- (enh #16, #17): Added exception handling for trapping FileReader API errors
- New configuration property added:
maxFilesCount
. Defaults to0
which means unlimited. - New configurable error messages added:
msgFilesTooMany
,msgFileNotFound
,msgFileNotReadable
,msgFilePreviewAborted
, andmsgFilePreviewError
. - Enhanced plugin to improve browser performance when loading and previewing multiple image files.
- (enh #18): Better validation for older browsers (not supporting HTML5) to degrade to normal file input.
- (enh #19): Synchronize preview with file browse dialog behavior, when cancel button is pressed in file dialog window.
- (enh #20): Fix
fileloaded
event to incrementpreviewId
and enhance to return file index. - (enh #21): Enhance multiple file upload and preview performance using setTimeout.
- (enh #21): Enhance loading progress message and message templates for multiple file uploads.
- (enh #22): Enhance file caption message display for validation errors.
- Other minor bug fixes.
Date: 25-Jul-2014
- (enh #12, #13, #14): Various enhancements and fixes.
- (enh #15): Enhanced validation of file size through
maxFileSize
configuration. - New plugin events added:
fileerror
,fileloaded
,filecleared
. - New plugin methods added:
disable
,enable
- Enhanced configurable templates for previewing image, text, and other files (and a generic template).
- Make caption text configurable through a new parameter
msgSelected
. - Correct calculation of files selected when
initPreview
is false. - Automatic scale images for preview, when images are too wide to fit in container.
- Added delimiter option for
initialPreview
to pass multiple content delimited as a string.
Date: 21-Jul-2014
- (enh #9): Enhanced caption template and styling for captions to prevent overflow of long file names out of the caption container.
- (enh #10): Ability to display initial caption, when initialPreview is false.
Date: 15-Jul-2014
- (enh #9): Enhanced caption template and styling for captions to prevent overflow of long file names out of the caption container.
Date: 02-Jul-2014
- The plugin now offers an additional
overwriteInitial
option. This is by default set totrue
, whereby, anyinitialPreview
content set will be overwritten, when new file is uploaded or when files are cleared. Setting it tofalse
will help displaying a saved image or file from database always - useful especially when using themultiple
file upload feature.
Date: 03-Jun-2014
- The plugin now offers an additional
refresh
method. This enables you to dynamically change element attributes or plugin options at runtime and refresh the widget.
Date: 23-May-2014
- The plugin now offers an option to display initial preview of images/text/other files. This is useful for record update scenarios. This can be a single image/file or an array of images/files.
- Extending to the above feature, the plugin also allows you to set a preview caption for the initial preview field.
- The following element identifiers need to be passed as a string like '#id' instead of a JQuery object:
- elCaptionContainer
- elCaptionText
- elPreviewContainer
- elPreviewImage
- elPreviewStatus
Date: 01-Jan-2014
Initial release. The following features are included in this release:
- The plugin will convert a simple HTML file input to an advanced file picker control. Will help fallback to a file input for browsers not supporting JQuery or Javascript.
- The file input consists of the following three sections with options and templates to control the display:
- file caption section: to display a brief information of the file(s) selected
- file action buttons section: to browse, remove, and upload files.
- file preview section: to display the selected files on client for preview (supports images and text file types). Other file types will be displayed as normal thumbnails.
- The plugin automatically converts an input with
type = file
to an advanced file picker input if you set itsclass = file
. All options to the input can be passed as HTML5data
attributes. - Ability to select and preview multiple files. Uses HTML 5 File reader API to read and preview files. Displays the progress of files being being loaded onto the preview zone, in case many files are chosen.
- Offers predefined templates and CSS classes which can be changed to style your file-input display as per your needs.
- Option to show/hide any or all of the following:
- caption section
- preview section
- upload button
- remove button
- Customise the location of the target container elements to display the entire plugin, the caption container, the caption text, the preview container, preview image, and preview status.
- For text file previews, autowrap the text to the thumbnail width, and show a wrap indicator link to display complete text on hover. You can customize the wrap indicator (which defaults to …).
- Customise the messages for preview, progress, and files selected.
- Upload action defaults to form submit. Supports an upload route/server action parameter for custom ajax based upload.
- Triggers JQuery events for advanced development. Events currently available are
filereset
andfileclear
. - Disabled and readonly file input support.
- Size of the entire plugin is less than 11KB (about 9KB for the minified JS and 2KB for the minified CSS).