CharLimiter Datalist Formatter

Introduction

The CharLimiter Datalist Formatter Plugin allows users to configure the number of characters displayed in a column of a list. It is an ideal utility for displaying long text fields (such as descriptions or notes) within compact lists by automatically truncating the text once it exceeds your specified character threshold.

Plugin Information

Plugins Available in the Bundle:

• CharLimiter Datalist Formatter (Datalist Formatter)

Supported Database: MySQL, PostgreSQL, Oracle, MS SQL Server
License: Apache License, Version 2.0

This plugin is compatible with Joget DX 8.

Get Started

Prerequisites

• Joget DX 8 Enterprise or Community Edition.
• Developer or administrator access with permissions to manage plugins and applications.

Where to get the plugin

You can obtain the plugin JAR file by downloading the latest release from the Joget Marketplace.

How to install

1. Download the latest release .jar file from the repository page.
2. Log in to your Joget Console.
3. Navigate to the Admin Bar and select Settings > Manage Plugins.
4. Click the Upload Plugins button, select your downloaded JAR file, and click Upload.

How to use it

You can choose to either import the demo app provided or configure the plugin manually from scratch.

Steps for Importing the Demo App

1. Download the demo app.
2. Go to your Joget Home page or the All Apps view and click Import App to upload and run the downloaded demo app.

Steps for Creating the App from Scratch

1. Create a new app and open up a form in the Form Builder.
2. Add a Text Field element onto your form canvas.
   
3. Save your form, and click Generate App to generate a CRUD interface.
   
4. Launch the application UI using the Click here option.
5. Navigate to the newly generated list, open it in the List Builder, and select the Text Field column you want to customize.
6. In the column properties pane, navigate to Properties > Formatter and select CharLimiter Datalist Formatter from the dropdown list to apply the character limit to the selected column.
   

Configure Properties

When configuring the CharLimiter Datalist Formatter properties, you can configure the following settings:

• Number of Characters: Defines the maximum number of characters to display in the column. Text that exceeds this limit will be truncated and followed by an ellipsis ("...").

Expected Outcome

When the list runs in your application UI, any text in the specified column that exceeds the configured character limit will be cleanly truncated. An ellipsis ("...") will automatically append to the end of the text, visually indicating that there is more content within the field than what is currently shown.

Download Plugin

Download the plugin from the Joget Marketplace.

Download Sample App