Skip to content

doc: add documentation for the Upload component#981

Open
laurenic0l wants to merge 12 commits into
mainfrom
972-upload-component
Open

doc: add documentation for the Upload component#981
laurenic0l wants to merge 12 commits into
mainfrom
972-upload-component

Conversation

@laurenic0l

Copy link
Copy Markdown
Contributor

Adds the documentation article and demos for the new inline Upload component

Covers:

Basics + when to use vs. FileUploadDialog
Picking files: selection mode, picker source, filters, drop zone
Validation and limits + server-side validation note
Upload behavior: auto upload, auto clear, programmatic actions
Mobile capture
Native file system access
Customizing the layout: presets, part visibility, default slot
Themes
Events
Internationalization
Styling

- docs/components/upload.md covering basics, picker behavior, validation
  and limits, auto upload and auto clear, mobile capture, native file
  system access, layout customization with presets and the default slot,
  themes, events, internationalization, and styling
- UploadView: resume upload inside a job application form
- UploadPickingFilesView: multi-file gallery uploader with filter switching
- UploadAutoUploadView: ticket submission with background attachment uploads
- UploadPresetsView: side-by-side comparison of the four chrome presets
- UploadDefaultSlotView: HEADLESS preset with projected drop surface
- UploadEventsView: progress bar and status line driven by onChange,
  onListProgress, and onComplete
Comment thread docs/docs/components/upload.md Outdated
@laurenic0l laurenic0l marked this pull request as ready for review May 28, 2026 02:34
@laurenic0l laurenic0l added the status: waiting-for-review The PR is ready. Waiting for team members to review. label May 28, 2026
@hyyan hyyan added the status: needs-snapshot Update to the latest snapshot before this PR can be merged. label May 28, 2026
Comment thread docs/docs/components/upload.md
Comment thread docs/docs/components/upload.md
Comment thread docs/docs/components/upload.md Outdated
Comment thread docs/docs/components/upload.md
Comment thread docs/docs/components/upload.md Outdated
@laurenic0l laurenic0l requested a review from MatthewHawkins May 28, 2026 20:43
@laurenic0l

Copy link
Copy Markdown
Contributor Author

Thanks for the feedback @MatthewHawkins. I've applied the changes

@hyyan hyyan left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@laurenic0l Looking great overall, just a few more requests!

Comment thread docs/docs/components/upload.md
Comment thread docs/docs/components/upload.md
Comment thread src/main/java/com/webforj/samples/views/upload/UploadView.java
Comment thread src/main/java/com/webforj/samples/views/upload/UploadView.java
Comment thread src/main/java/com/webforj/samples/views/upload/UploadView.java
Comment thread docs/docs/components/upload.md
Comment thread docs/docs/components/upload.md Outdated
Comment thread docs/docs/components/upload.md Outdated
@laurenic0l laurenic0l requested a review from hyyan June 2, 2026 23:27
@laurenic0l

Copy link
Copy Markdown
Contributor Author

Heads up: the new UploadDefaultSlotView parses dropped CSVs using Apache Commons CSV, so this PR also adds the commons-csv dependency to pom.xml:

xml<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-csv</artifactId>
  <version>1.11.0</version>
</dependency>

Let me know if there's a preferred version or if you'd rather I parse the CSV with a different approach.

@hyyan hyyan linked an issue Jun 17, 2026 that may be closed by this pull request
@bbrennanbasis bbrennanbasis removed the status: waiting-for-review The PR is ready. Waiting for team members to review. label Jun 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status: needs-snapshot Update to the latest snapshot before this PR can be merged.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document Upload Component

4 participants