Matrix

Category: Widgets
Subcategory: Display widgets

Overview

Is a Tree Table not enough and do you need to make a reference table? The Rows & Columns are separate lists of objects, the Entry objects are reference objects (they reference to a row & column). This widget will enable you to create a matrix view, possible with child rows (to view a tree structure). Please read the documentation and have a look at the test-project. (Please note that version 1 & 1.1 were called "Dynamic (Tree) Table", we renamed it to better reflect the capabilities

Documentation

Demo urlhttps://dynamictabletest-sandbox.mxapps.io/

Apache License Dependencies DevDependencies Support WM Studio GitHub release GitHub issues DeepScan grade Available

Matrix Widget for Mendix

Mendix Matrix Widget using Ant Design Table (MIT License). This is inspired on the Tree Table widget, but takes objects in the columns as well.

logo

Show a reference table. Rows & Columns are Mendix objects, Entry objects are in between.

screenshot

See test-project https://dynamictabletest-sandbox.mxapps.io/ for a live demo! On the bottom of this page there is a short explanation of the Domain model that is used. Test-project can be downloaded here

Missing features? See TODO at the bottom to see which items are still on the TODO list. If you find other bugs, please report this as an issue here

Features

  • Display a matrix, where rows can have children, like a tree
  • Data Sources: XPath, Microflow, Nanoflow
  • Children: Get over reference, Microflow, Nanoflow
  • Selection of rows (single, multi)
  • Events: Click/Double click on Row, Column, Entry or empty field

This widget is about 600Kb uncompressed, so in your cloud deployment this widget should take about 160 Kb of network resources

Tested:

  • IE11 & Edge
  • Chrome
  • Firefox
  • Safari

Basic Configuration

1. Row

settings

  • Rows can be retrieved over XPath, Microflows and Nanoflows
  • Your title can be purely text or HTML, either through the attribute or Nanoflow. Make sure you sanitize any user input to prevent XSS issues.

2. Row Children

settings

  • This is totally optional. If you want to do a tree structure, please configure the children
  • You can either get these over a Child reference (see bottom for explanation) or through a Microflow/Nanoflow when using a hasChildren attribute

3. Column

settings

  • Columns can be retrieved over XPath, Microflows and Nanoflows
  • Your title can be purely text or HTML, either through the attribute or Nanoflow. Make sure you sanitize any user input to prevent XSS issues.

4. Entries

settings

  • An Entry is an object that is linked to 1 row and 1 column
  • An Entry has a title (see Column/Row title, same principle)
  • In order to retrieve entries, you will need to use a Data Helper (see next)

5. Data Helper

settings

  • See explanation in the settings screen

6. Selection

settings

7. Events

settings

8. UI Settings

settings

Demo project

https://dynamictabletest-sandbox.mxapps.io/

Domain Model

This demo uses the following domain model:

domain model

Short explanation:

  • A table is placed inside a data view with a View object
  • For the first rows, it will get all Rows that have a reference to View and _Root = true
  • Every row might have children. You either get these over a reference Children, or when you use a Microflow and _hasChildren = true
  • Column Objects also have a reference to View, although it is not entirely necessary
  • When loading Entry object, the widget will create a EntryHelper object that has references to the shown Rows&Columns. This helper is passed down to a microflow/nanoflow
  • When the Entry objects are loaded, the widget will place these in the correct field based on the reference to a Column/Row
  • The SelectionHelper is used for selections, but this is based on the test-project and can be disregarded here.

Issues, suggestions and feature requests

Please report your issues here

TODO

The following things need to be further tested and/or fixed. Please don't report this as a bug if this is in the TODO list:

  • Basic WebModeler preview + settings
  • Add Icon attribute (from Tree Table)
  • Add config for when context changes (reload rows?)
  • Column overflow (first column)
  • Header height
  • Left column lock issue with header. This is when locking the left column, it can get out of sync with the header.
  • Unit tests

License

Apache 2

Releases

Version: 1.4.0
Framework Version: 8.0.0
Release Notes: - Fix #13 #14 Fix for MX9
Version: 1.3.4
Framework Version: 8.0.0
Release Notes: - Code cleanup
Version: 1.3.3
Framework Version: 8.0.0
Release Notes: - Improvements in rendering, fixing issues with large data sets (as reported in #9)
Version: 1.3.2
Framework Version: 8.0.0
Release Notes: - Fix #7: Column microflow/nanoflow expect a wrong paremeter
Version: 1.3.1
Framework Version: 8.0.0
Release Notes: - Rewrote State reset table, so data get's reloaded when context object changes. This was due to a bug reported in [this forum topic](https://forum.mendixcloud.com/link/questions/99879)