katex: Explain reason for ignoring .vlist-t2 and .vlist-s CSS classes

rajveermalviya · rajveermalviya · commit cb3f8387b318 · 2025-09-01T21:46:57.000+05:30
Fixes: #1716
diff --git a/lib/model/katex.dart b/lib/model/katex.dart
@@ -356,7 +356,13 @@ class _KatexParser {
           }
         }
 
-        // TODO(#1716) Handle styling for .vlist-t2 spans
+        // We ignore the styling for .vlist-t2 CSS class on the root vlist
+        // span, and also the styling for .vlist-s CSS class on the empty span
+        // in the first .vlist-r span, because in KaTeX they only exists as a
+        // workaround for a Safari bug, and we don't need to apply those.
+        // See:
+        //   https://github.com/KaTeX/KaTeX/commit/766487bfe3bfdfabb73068401536ca03aa115e0d
+
         return KatexVlistNode(
           rows: rows,
           debugHtmlNode: kDebugMode ? element : null,

Original file line number	Diff line number	Diff line change
`@@ -356,7 +356,13 @@ class _KatexParser {`
`356`	`356`	`}`
`357`	`357`	`}`
`358`	`358`
`359`		`- // TODO(#1716) Handle styling for .vlist-t2 spans`
	`359`	`+ // We ignore the styling for .vlist-t2 CSS class on the root vlist`
	`360`	`+ // span, and also the styling for .vlist-s CSS class on the empty span`
	`361`	`+ // in the first .vlist-r span, because in KaTeX they only exists as a`
	`362`	`+ // workaround for a Safari bug, and we don't need to apply those.`
	`363`	`+ // See:`
	`364`	`+ // https://github.com/KaTeX/KaTeX/commit/766487bfe3bfdfabb73068401536ca03aa115e0d`
	`365`	`+`
`360`	`366`	`return KatexVlistNode(`
`361`	`367`	`rows: rows,`
`362`	`368`	`debugHtmlNode: kDebugMode ? element : null,`