Advanced Document Viewer

Content Type: Widget
Categories: Utility,User Interface,Visualization

Overview

Advanced Document Viewer is a production-ready Mendix pluggable widget that

lets users preview, manage, and interact with uploaded documents directly

within your Mendix application — no third-party services required for core

functionality.

 

Use this widget alongside the Mendix File Manager widget. File Manager

handles upload; Advanced Document Viewer handles preview, download, and delete.

 

KEY FEATURES

 

Preview Support

  •  PDF — inline preview using blob-fetch (no auto-download, works always)
  •  Excel / CSV — powered by SheetJS, works on local development too
  •  Images — JPG, PNG, GIF, WEBP, SVG inline preview
  •  Office files — DOCX, PPTX via Google Docs Viewer (deployed environments)
  •  Video and Audio — HTML5 player
  •  Text and XML — dark monospace viewer

 

Security

  • Per-file password protection — locked files show only a View button; 

Download and Delete are hidden until the correct password is entered

  • File expiry date — files auto-disable after the expiry date; View, 

Download, and Delete are all blocked automatically

 

Productivity

  • Inline annotations — users can add comments per document inside the  preview popup
  • Bulk select — select multiple files for bulk download or bulk delete
  • Delete confirmation dialog — configurable, prevents accidental deletion
  • Custom validation message — wire a string attribute from your Save nanoflow to show a red banner when no file has been uploaded
  • Pagination — handles large file lists with a Load More button

 

WHAT MAKES THIS DIFFERENT

 

Unlike the built-in Mendix File Viewer, Advanced Document Viewer adds

password protection, file expiry, annotations, and bulk

operations — features that enterprise and client-facing applications demand.

 

Excel and CSV files preview locally without any deployment, which is

unique among Mendix document widgets.

 

COMPATIBILITY

 

- Mendix Studio Pro 9.x and 10.x

- Web platform only

- Apache-2.0 license — free for commercial and personal use

 

SETUP

 

1. Add the widget to your page alongside a File Manager widget

2. Connect both to the same list datasource (entities extending

System.FileDocument)

3. Map the File name attribute and optionally File size, Upload date,

Expiry date, and Password attributes

4. Configure Display settings as needed

Documentation

Typical usage scenario

 

The Advanced Document Viewer widget is designed to provide a seamless and interactive document management experience within Mendix applications.

It can be used in scenarios such as:

  • Document management systems (DMS)
  • Employee portals for accessing files
  • Customer portals for secure document sharing
  • Internal dashboards for viewing reports (PDF, Excel, images, etc.)
  • Applications requiring password-protected file access

This widget solves key problems like:

  • Viewing multiple file formats directly inside the app
  • Restricting access using per-file password protection
  • Providing inline preview without downloading
  • Managing documents efficiently with a clean UI

 

Features

 

The Advanced Document Viewer widget is designed to provide a seamless and interactive document management experience within Mendix applications.

It can be used in scenarios such as:

  • Document management systems (DMS)
  • Employee portals for accessing files
  • Customer portals for secure document sharing
  • Internal dashboards for viewing reports (PDF, Excel, images, etc.)
  • Applications requiring password-protected file access

This widget solves key problems like:

  • Viewing multiple file formats directly inside the app
  • Restricting access using per-file password protection
  • Providing inline preview without downloading
  • Managing documents efficiently with a clean UI

 

Installation

 

Download the widget from Mendix Marketplace

Import the .mpk file into your Mendix project

Add the widget to a page

Configure the required data source (FileDocument entity)

 

Configuration

 

  • Set Data SourceUse a list of System.FileDocument (or custom entity)

Map required attributes:

  • File Name → Name
  • File Size → Size (optional)
  • Upload Date → createdDate (optional)
  • Expiry Date → custom attribute (optional)
  • Password → custom string attribute (optional)

Optional configurations:

  • Enable password protection
  • Enable expiry validation
  • Configure annotations

 

Frequently Asked Questions

1. Does it support all file types?

Supports most common formats: PDF, Images, Excel, Text, Video, Audio.

2. Is password protection secure?

It is UI-level protection, not encryption. For high security, use backend validation.

3. Can I use it with a single object?

Currently optimized for list-based data source.

4. Does it work on mobile?

Yes, fully responsive and works on mobile devices.

5. Can I customize UI?

Yes, you can modify styles via CSS or extend the widget.

Releases

Version: 1.0.0
Framework Version: 10.0.0
Release Notes:

Initial release of Advanced Document Viewer v1.0.0

What's included in this release:

  • PDF preview — inline rendering using blob-fetch, bypasses auto-download
  • Excel and CSV preview — powered by SheetJS, works on local development without deployment
  • Image preview — supports JPG, PNG, GIF, WEBP, SVG
  • Office file preview — DOCX, PPTX via Google Docs Viewer (requires deployed environment)
  • Video and Audio — HTML5 player support
  • Text and XML — dark monospace viewer

 Security features:

  • Per-file password protection — Download and Delete are hidden until the correct password is entered
  • File expiry date — files automatically disable after expiry, all actions are restricted
  • Watermark — dynamic overlay text inside the preview popup

Productivity features:

  • Inline annotations and comments per document
  • Bulk select with bulk download and bulk delete
  • Delete confirmation dialog
  • Custom validation message via string attribute
  • Pagination support for large file lists

Compatibility:

  • Compatible with Mendix Studio Pro 9.x and 10.x
  • Built using Mendix pluggable widget architecture

This version marks the first stable release of the Advanced Document Viewer widget, providing a complete and secure document handling solution within Mendix applications.