Changeset 61017 for trunk/src/wp-includes/kses.php

Timestamp:

10/21/2025 11:05:01 AM (6 months ago)

Author:

ellatrix

Message:

KSES: add MathML tags.

These tags are needed for the new Math block, which is included in WP 6.9.

See ​https://github.com/WordPress/gutenberg/pull/72182.
See ​https://github.com/WordPress/wordpress-develop/pull/10307.

Fixes #64115.

File:

• trunk/src/wp-includes/kses.php (modified) (1 diff)

trunk/src/wp-includes/kses.php

@@ -414 +414 @@
         ),
         'wbr'        => array(),
+    );
+
+    // https://www.w3.org/TR/mathml-core/#global-attributes
+    // Except common attributes added by _wp_add_global_attributes.
+    $math_global_attributes = array(
+        'displaystyle'   => true,
+        'scriptlevel'    => true,
+        'mathbackground' => true,
+        'mathcolor'      => true,
+        'mathsize'       => true,
+        // Common attributes also defined by _wp_add_global_attributes.
+        // We do not want to add all those global attributes though.
+        'class'          => true,
+        'data-*'         => true,
+        'dir'            => true,
+        'id'             => true,
+        'style'          => true,
+    );
+
+    $math_overunder_attributes = array(
+        'accentunder' => true,
+        'accent'      => true,
+    );
+
+    $allowedposttags = array_merge(
+        $allowedposttags,
+        array(
+            // https://www.w3.org/TR/mathml-core/#the-top-level-math-element
+            'math'          => array_merge(
+                $math_global_attributes,
+                array(
+                    'display' => true,
+                )
+            ),
+
+            // https://www.w3.org/TR/mathml-core/#token-elements
+            // https://www.w3.org/TR/mathml-core/#text-mtext
+            'mtext'         => $math_global_attributes,
+            // https://www.w3.org/TR/mathml-core/#the-mi-element
+            'mi'            => array_merge(
+                $math_global_attributes,
+                array(
+                    'mathvariant' => true,
+                )
+            ),
+            // https://www.w3.org/TR/mathml-core/#number-mn
+            'mn'            => $math_global_attributes,
+            // https://www.w3.org/TR/mathml-core/#operator-fence-separator-or-accent-mo
+            'mo'            => array_merge(
+                $math_global_attributes,
+                array(
+                    'form'          => true,
+                    'fence'         => true,
+                    'separator'     => true,
+                    'lspace'        => true,
+                    'rspace'        => true,
+                    'stretchy'      => true,
+                    'symmetric'     => true,
+                    'maxsize'       => true,
+                    'minsize'       => true,
+                    'largeop'       => true,
+                    'movablelimits' => true,
+                )
+            ),
+            // https://www.w3.org/TR/mathml-core/#space-mspace
+            'mspace'        => array_merge(
+                $math_global_attributes,
+                array(
+                    'width'  => true,
+                    'height' => true,
+                    'depth'  => true,
+                )
+            ),
+            // https://www.w3.org/TR/mathml-core/#string-literal-ms
+            'ms'            => $math_global_attributes,
+
+            // https://www.w3.org/TR/mathml-core/#general-layout-schemata
+            // https://www.w3.org/TR/mathml-core/#horizontally-group-sub-expressions-mrow
+            'mrow'          => $math_global_attributes,
+            // https://www.w3.org/TR/mathml-core/#fractions-mfrac
+            'mfrac'         => array_merge(
+                $math_global_attributes,
+                array(
+                    'linethickness' => true,
+                )
+            ),
+            // https://www.w3.org/TR/mathml-core/#radicals-msqrt-mroot
+            'msqrt'         => $math_global_attributes,
+            'mroot'         => $math_global_attributes,
+            // https://www.w3.org/TR/mathml-core/#style-change-mstyle
+            'mstyle'        => $math_global_attributes,
+            // https://www.w3.org/TR/mathml-core/#error-message-merror
+            'merror'        => $math_global_attributes,
+            // https://www.w3.org/TR/mathml-core/#adjust-space-around-content-mpadded
+            'mpadded'       => array_merge(
+                $math_global_attributes,
+                array(
+                    'width'   => true,
+                    'height'  => true,
+                    'depth'   => true,
+                    'lspace'  => true,
+                    'voffset' => true,
+                )
+            ),
+            // https://www.w3.org/TR/mathml-core/#making-sub-expressions-invisible-mphantom
+            'mphantom'      => $math_global_attributes,
+
+            // https://www.w3.org/TR/mathml-core/#script-and-limit-schemata
+            // https://www.w3.org/TR/mathml-core/#subscripts-and-superscripts-msub-msup-msubsup
+            'msub'          => $math_global_attributes,
+            'msup'          => $math_global_attributes,
+            'msubsup'       => $math_global_attributes,
+            // https://www.w3.org/TR/mathml-core/#underscripts-and-overscripts-munder-mover-munderover
+            'munder'        => array_merge( $math_global_attributes, $math_overunder_attributes ),
+            'mover'         => array_merge( $math_global_attributes, $math_overunder_attributes ),
+            'munderover'    => array_merge( $math_global_attributes, $math_overunder_attributes ),
+            // https://www.w3.org/TR/mathml-core/#prescripts-and-tensor-indices-mmultiscripts
+            'mmultiscripts' => $math_global_attributes,
+            'mprescripts'   => $math_global_attributes,
+
+            // https://www.w3.org/TR/mathml-core/#tabular-math
+            // https://www.w3.org/TR/mathml-core/#table-or-matrix-mtable
+            'mtable'        => array_merge(
+                $math_global_attributes,
+                array(
+                    // Non-standard, used by temml/katex.
+                    // https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mtable
+                    'columnalign'   => true,
+                    'rowspacing'    => true,
+                    'columnspacing' => true,
+                    'align'         => true,
+                    'rowalign'      => true,
+                    'columnlines'   => true,
+                    'rowlines'      => true,
+                    'frame'         => true,
+                    'framespacing'  => true,
+                    'width'         => true,
+                )
+            ),
+            // https://www.w3.org/TR/mathml-core/#row-in-table-or-matrix-mtr
+            'mtr'           => array_merge(
+                $math_global_attributes,
+                array(
+                    // Non-standard, used by temml/katex.
+                    // https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mtr
+                    'columnalign' => true,
+                    'rowalign'    => true,
+                )
+            ),
+            // https://www.w3.org/TR/mathml-core/#entry-in-table-or-matrix-mtd
+            'mtd'           => array_merge(
+                $math_global_attributes,
+                array(
+                    'columnspan'  => true,
+                    'rowspan'     => true,
+                    // Non-standard, used by temml/katex.
+                    // https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/mtd
+                    'columnalign' => true,
+                    'rowalign'    => true,
+                )
+            ),
+
+            // https://www.w3.org/TR/mathml-core/#semantics-and-presentation
+            'semantics'     => $math_global_attributes,
+            'annotation'    => array_merge(
+                $math_global_attributes,
+                array(
+                    'encoding' => true,
+                )
+            ),
+
+            // Non-standard but widely supported, used by temml/katex.
+            'menclose'      => array_merge(
+                $math_global_attributes,
+                array(
+                    'notation' => true,
+                )
+            ),
+        )
     );