Overview

MultiTagViewer is a Mendix pluggable widget designed to display multiple tags stored in a JSON array within a String attribute. It provides a clean, read-only visualization of tag data, allowing applications to present structured lists such as labels, categories, or keywords in an organized tag format.

The widget integrates seamlessly with Mendix pages through a Data View context and works particularly well alongside the MultiInputTag widget, which handles tag creation and storage. By reading the JSON data and rendering each value as an individual tag, MultiTagViewer helps maintain a clear and consistent representation of multi-value data within Mendix applications.

Its lightweight design and support for custom styling make it easy to integrate into existing user interfaces while ensuring that tag information remains easy to read and visually structured.

Documentation

Typical Usage Scenario

The MultiTagViewer widget is used to display multiple values that are stored as tags in a single Mendix String attribute. It is especially useful in situations where users have already entered multiple tags using an input widget (such as MultiInputTag) and the application needs to present those values in a clean, read-only format.

Instead of displaying raw JSON or comma-separated text, the widget converts the stored data into visual tags, making it easier for users to read and understand the information.

Typical scenarios include:

• Displaying keywords or labels for articles or documents
• Showing categories or tags assigned to records
• Presenting skills or technologies in employee profiles
• Displaying filters or metadata in dashboards or reports
• Showing previously entered multi-value fields in detail pages

This improves readability and provides a consistent visual representation of multi-value data across the application.

Features and Limitations

Features

• Tag Rendering
•  Displays values stored in a JSON array as visually separated tags.
• Read-Only Display
•  Designed for viewing tags without allowing editing or modification.
• Seamless Mendix Data Binding
•  Connects directly to a String attribute within a Data View.
• JSON Parsing
•  Automatically reads JSON-formatted tag data and renders each value as an individual tag.
• Custom Styling Support
•  Allows developers to apply custom CSS classes for UI customization.
• Lightweight Integration
•  Simple to add to existing Mendix pages with minimal configuration.

Limitations

• The widget only displays tags and does not allow editing or adding new values.
• Requires valid JSON formatted data in the String attribute.
• If the attribute contains invalid JSON, the widget may display no tags.

Dependencies

• Mendix Studio Pro supporting pluggable widgets
• A String attribute containing tags stored as a JSON array

No additional Mendix modules are required.

Installation

1. Download the widget package (.mpk file).
2. Open your Mendix project in Mendix Studio Pro.
3. Import the widget through App Explorer → Widgets → Import Widget.
4. Build or run the project to make the widget available in the toolbox.

Configuration

1. Place the MultiTagViewer widget inside a Data View.
2. In the widget properties, select the String attribute containing the tag data.
3. Ensure the attribute contains JSON formatted tag values.
4. Optionally apply custom CSS classes for styling.
5. Run the application to display the tags.

Known Bugs

There are currently no known critical issues in this release.

If any issues are discovered, they can be reported through the project’s issue tracker.

Frequently Asked Questions

Q: What format should the data be stored in?

The widget expects a JSON array of strings, for example:

["Tag1","Tag2","Tag3"].

Q: Can the widget edit or remove tags?

No. The widget is read-only and designed only for displaying tag data.

Q: Can it be used without the MultiInputTag widget?

Yes. As long as the String attribute contains valid JSON tag data, the widget can display it.

Q: Does the widget require a Data View?

Yes. The widget must be placed inside a Data View context to access the bound Mendix object attribute.