json.toHtmlTable function by Baaaaaz · Pull Request #5934 · RPTools/maptool

Baaaaaz · 2026-01-29T23:09:49Z

Requirements for Contributing a Bug Fix or Enhancement

Description of the Change

New MTScript function json.toHtmlTable(json [, options]) which recursively transforms json into nested html tables with applied options.

Possible Drawbacks

None foreseen, but added experimental flag while it matures.

Documentation Notes

To be done, but options are (in no particular order):

LeadObjectKeys - Return a specific order of object keys (if present) to start with
RearObjectKeys - Return a specific order of object keys (if present) to end with
SortObjectKeys - Return object keys in a sorted order (for keys not defined as lead and rear object keys)
Attributes - Sets any html attributes on the root table
Caption - Adds a caption element to the root table
Collapsible - Whether to output html tables with a detail/summary wrapper
CollapsibleOpenDepth - Whether a detail/summary wrapper is open by default
Titles - Whether to output the json path as html title attributes
ArrayOfObjects - Whether to pivot json objects within a json array
ObjectOfObjects - Whether to pivot json objects within a json object
AssetImage - Whether json values starting with "assetid://" should returned as an html <img> element
EscapeHtml - Whether json values containing certain html characters in should be escaped.
SanitizeHtml - Whether to sanitize the html returned from jsonToHtmlTable.
Input - Whether json values should be converted to input elements for use in a form (defaults to false)

Release Notes

Add new MTScript function json.toHtmlTable()

This change is

Baaaaaz · 2026-01-29T23:13:06Z

An example MTScript is:

[h: vJson = getInfo("map")]

[h: vOptions = json.set("{}", 
	"caption", "Example Data",
	"attributes", json.set("{}", "id","exampleId", "class","exampleClass"),
	"collapsible", 1,
	"collapsibleOpenDepth", 2,
	"escapeHtml", 0,
	"sanitizeHtml", 1,
	"assetImage", 1,
	"arrayOfObjects", 1,
	"objectOfObjects", 1,
	"leadObjectKeys", json.append("", "id", "name", "level"),
	"sortObjectKeys", "asc",
	"rearObjectKeys", json.append("", "source", "page"),
	"input", 0
)]

[frame5("INFO"): {
	<html>
		<head>
			<link rel='stylesheet' type='text/css' href='lib://JsonHtmlTable/macro/style.css?cachelib=false'>
			<style>
				[r:'
					span.json-array, th.json-array {background-color: LightSkyBlue;}
					span.json-object, th.json-object {background-color: DarkSeaGreen;}
					[data-json-key="name"] {color: red}
					[data-json-index="1"] {background-color: yellow}
				']
				</style>
		</head>
		
		<body>
			[r: json.toHtmlTable(vOptions, json.set("{}", "caption", "json.toHtmlTable Options"))]
			<hr>
			[r: json.toHtmlTable(vJson, vOptions)]
			<hr>
			[r: replace(json.toHtmlTable(vJson, vOptions), "<", "&lt;")]			
		</body>
	</html>
}]

Baaaaaz · 2026-01-29T23:21:02Z

Or another example using jmrs 5E spell library json:

…ions' into feature/5906-new-json-html-functions

Baaaaaz · 2026-02-13T08:06:31Z

Ready for a review :)

cwisniew · 2026-03-19T02:32:26Z

src/main/java/net/rptools/maptool/client/functions/json/JsonHtmlFunctions.java

+
+public class JsonHtmlFunctions {
+
+  JsonHtmlFunctions(JsonMTSTypeConversion converter) {


Can you add a @nonnull annotation to the argument to help IDEs pick up potential errors

cwisniew · 2026-03-19T02:35:35Z

src/main/java/net/rptools/maptool/client/functions/json/JsonHtmlFunctions.java

+  }
+
+  /** Track the current depth in the json hierarchy during the conversion to html table(s) */
+  private Integer jsonPathDepth;


Since you are not using null as a "not defined" value this should be just an int to avoid all the auto boxing/unboxking every time you use it.

cwisniew · 2026-03-19T02:40:21Z

src/main/java/net/rptools/maptool/client/functions/json/JsonHtmlFunctions.java

+    optionSanitizeHtml =
+        options.has("sanitizehtml")
+            ? !options.get("sanitizehtml").getAsBigDecimal().equals(BigDecimal.ZERO)
+            : true;


Because all of this is user input you need to check they passed the correct type and raise a meaningfull error if they didn't, rather than the JSON library throwing a vague error they would not be able to debug.

Especially since the problems with MT Json not being able to use booleans have been addressed many versions ago, I would expect to be able to use boolean true/false instead of 1/0 in the options.

Can take either boolean, or 1/0. Also added some option value validation and relevant exception messages.

json.html functions

a549023

github-actions bot added the feature Adding functionality that adds value label Jan 29, 2026

Baaaaaz marked this pull request as draft February 7, 2026 18:21

Baaaaaz added 3 commits February 13, 2026 07:52

json.html function take 2

59620db

Merge branch 'RPTools:develop' into feature/5906-new-json-html-functions

bca3d50

Merge remote-tracking branch 'origin/feature/5906-new-json-html-funct…

666dade

…ions' into feature/5906-new-json-html-functions

Baaaaaz changed the title ~~json.html functions~~ json.toHtmlTable function Feb 13, 2026

Baaaaaz marked this pull request as ready for review February 13, 2026 08:05

Baaaaaz added 2 commits February 15, 2026 07:59

json.html function css class adjs

97425c1

add scope attribute to th elements

98c5ee4

cwisniew requested changes Mar 19, 2026

View reviewed changes

Baaaaaz added 5 commits March 19, 2026 07:24

address review feedback

fda7a8d

improve escapeHtmlEntities

7c73cff

added json path depth limit option

bcd7a52

adjust json path tracking approach for performance

d3fe8dd

update some i18n messages (inc. removing some troublesome apostrophes)

a5b7c52

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

json.toHtmlTable function#5934

json.toHtmlTable function#5934
Baaaaaz wants to merge 11 commits intoRPTools:developfrom
Baaaaaz:feature/5906-new-json-html-functions

Baaaaaz commented Jan 29, 2026 •

edited

Loading

Uh oh!

Baaaaaz commented Jan 29, 2026 •

edited

Loading

Uh oh!

Baaaaaz commented Jan 29, 2026

Uh oh!

Baaaaaz commented Feb 13, 2026

Uh oh!

cwisniew Mar 19, 2026

Uh oh!

Baaaaaz Mar 19, 2026

Uh oh!

cwisniew Mar 19, 2026

Uh oh!

Baaaaaz Mar 19, 2026

Uh oh!

cwisniew Mar 19, 2026

Uh oh!

Baaaaaz Mar 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		public class JsonHtmlFunctions {

		JsonHtmlFunctions(JsonMTSTypeConversion converter) {

Conversation

Baaaaaz commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Requirements for Contributing a Bug Fix or Enhancement

Description of the Change

Possible Drawbacks

Documentation Notes

Release Notes

Uh oh!

Baaaaaz commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Baaaaaz commented Jan 29, 2026

Uh oh!

Baaaaaz commented Feb 13, 2026

Uh oh!

cwisniew Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Baaaaaz Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

cwisniew Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Baaaaaz Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

cwisniew Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Baaaaaz Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Baaaaaz commented Jan 29, 2026 •

edited

Loading

Baaaaaz commented Jan 29, 2026 •

edited

Loading