Module org.apache.wicket.extensions
Class UploadProgressBar
java.lang.Object
org.apache.wicket.Component
org.apache.wicket.MarkupContainer
org.apache.wicket.markup.html.WebMarkupContainer
org.apache.wicket.markup.html.panel.Panel
org.apache.wicket.extensions.ajax.markup.html.form.upload.UploadProgressBar
- All Implemented Interfaces:
Serializable,Iterable<Component>,IEventSink,IEventSource,IFeedbackContributor,IConverterLocator,IMetadataContext<Serializable,,Component> IQueueRegion,IHeaderContributor,IRequestableComponent,org.apache.wicket.util.IHierarchical<Component>,org.apache.wicket.util.io.IClusterable
A panel to show the progress of an HTTP upload.
Note: For this to work upload progress monitoring must be enabled in the wicket application. Example:
public class App extends WebApplication {
@Override
protected void init() {
super.init();
<b>getApplicationSettings().setUploadProgressUpdatesEnabled(true);</b> // <--
}
}
For customizing starting text see RESOURCE_STARTING.
Implementation detail: Despite being located in an Ajax package, the progress communication is
not done via Ajax but with an IFrame instead due to a bug in Webkit based browsers, see
WICKET-3202.- Author:
- Andrew Lombardi
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final classInitializer for this component; binds static resources. -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringResource key used to retrieve starting message for.Fields inherited from class org.apache.wicket.Component
ENABLE, FLAG_INITIALIZED, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING, RFLAG_CONTAINER_HAS_REMOVALS -
Constructor Summary
ConstructorsConstructorDescriptionUploadProgressBar(String id, Form<?> form) Constructor that will display the upload progress bar for every submit of the given form.UploadProgressBar(String id, Form<?> form, FileUploadField uploadField) Constructor that will display the upload progress bar for submissions of the given form, that include a file upload in the given file upload field; i.e. if the user did not select a file in the given file upload field, the progess bar is not displayed.UploadProgressBar(String id, FileUploadField uploadField) Constructor that will display the upload progress bar for every submit of the given form. -
Method Summary
Modifier and TypeMethodDescriptionprotected ResourceReferencegetCss()Override this to provide your own CSS, or return null to avoid including the default.protected StringAllows to pass a JavaScript function that is called when progress in updated.protected MarkupContainerCreates a component for the barprotected MarkupContainerCreates a component for the status textprotected voidvoidrenderHead(IHeaderResponse response) voidstart(IPartialPageRequestHandler handler) Methods inherited from class org.apache.wicket.markup.html.panel.Panel
getRegionMarkup, newMarkupSourcingStrategyMethods inherited from class org.apache.wicket.markup.html.WebMarkupContainer
getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSessionMethods inherited from class org.apache.wicket.MarkupContainer
add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findChildComponent, findComponentToDequeue, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onComponentTagBody, onDetach, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, stream, streamChildren, toString, toString, visitChildren, visitChildrenMethods inherited from class org.apache.wicket.Component
add, addStateChange, beforeRender, canCallListener, canCallListenerAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, createConverter, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMarkupTag, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isInitialized, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onBeforeRender, onComponentTag, onConfigure, onEvent, onModelChanged, onModelChanging, onReAdd, onRemove, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderPart, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlForListener, urlForListener, visitParents, visitParents, warn, wrapMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface org.apache.wicket.IQueueRegion
dequeue, newDequeueContextMethods inherited from interface java.lang.Iterable
forEach, spliterator
-
Field Details
-
RESOURCE_STARTING
Resource key used to retrieve starting message for. Example: UploadProgressBar.starting=Upload starting...- See Also:
-
-
Constructor Details
-
UploadProgressBar
Constructor that will display the upload progress bar for every submit of the given form.- Parameters:
id- component id (not null)uploadField- the file upload field to check for a file upload, or null to display the upload field for every submit of the given form
-
UploadProgressBar
Constructor that will display the upload progress bar for every submit of the given form.- Parameters:
id- component id (not null)form- form that will be submitted (not null)
-
UploadProgressBar
Constructor that will display the upload progress bar for submissions of the given form, that include a file upload in the given file upload field; i.e. if the user did not select a file in the given file upload field, the progess bar is not displayed.- Parameters:
id- component id (not null)form- form that is submitted (not null)uploadField- the file upload field to check for a file upload, or null to display the upload field for every submit of the given form
-
-
Method Details
-
onInitialize
- Overrides:
onInitializein classMarkupContainer
-
newStatusComponent
Creates a component for the status text- Parameters:
id- The component id- Returns:
- the status component
-
newBarComponent
Creates a component for the bar- Parameters:
id- The component id- Returns:
- the bar component
-
getCss
Override this to provide your own CSS, or return null to avoid including the default.- Returns:
- ResourceReference for your CSS.
-
renderHead
- Specified by:
renderHeadin interfaceIHeaderContributor- Overrides:
renderHeadin classComponent
-
getOnProgressUpdatedCallBack
Allows to pass a JavaScript function that is called when progress in updated.- Returns:
- A JavaScript function.
-
start
-