matplotlib
diff --git a/‎doc/api/next_api_changes/behavior/20367-AG.rst
Copy file name to clipboard
+12Lines changed: 12 additions & 0 deletions b/‎doc/api/next_api_changes/behavior/20367-AG.rst
Copy file name to clipboard
+12Lines changed: 12 additions & 0 deletions
diff --git a/‎lib/matplotlib/tests/test_text.py
Copy file name to clipboardExpand all lines: lib/matplotlib/tests/test_text.py
+10Lines changed: 10 additions & 0 deletions b/‎lib/matplotlib/tests/test_text.py
Copy file name to clipboardExpand all lines: lib/matplotlib/tests/test_text.py
+10Lines changed: 10 additions & 0 deletions
diff --git a/‎lib/matplotlib/text.py
Copy file name to clipboardExpand all lines: lib/matplotlib/text.py
+24Lines changed: 24 additions & 0 deletions b/‎lib/matplotlib/text.py
Copy file name to clipboardExpand all lines: lib/matplotlib/text.py
+24Lines changed: 24 additions & 0 deletions
diff --git a/‎lib/matplotlib/widgets.py
Copy file name to clipboardExpand all lines: lib/matplotlib/widgets.py
+5-2Lines changed: 5 additions & 2 deletions b/‎lib/matplotlib/widgets.py
Copy file name to clipboardExpand all lines: lib/matplotlib/widgets.py
+5-2Lines changed: 5 additions & 2 deletions
@@ -0,0 +1,12 @@
+``Text`` allows a boolean *parse_math*
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+`.Text` objects now allow a *parse_math* keyword-only argument
+which defaults to True. When it is passed as False, that text object
+will consider the string as a literal and will not try to parse it
+as a mathtext object.
+
+``TextBox`` defaults it to False
+--------------------------------
+`.TextBox` now defaults its text object's *parse_math** argument
+as False. 
@@ -731,3 +731,13 @@ def test_unsupported_script(recwarn):
         [warn.message.args for warn in recwarn] ==
         [(r"Glyph 2534 (\N{BENGALI DIGIT ZERO}) missing from current font.",),
          (r"Matplotlib currently does not support Bengali natively.",)])
+
+
+def test_parse_math():
+    fig, ax = plt.subplots()
+    ax.text(0, 0, r"$ \wrong{math} $", parse_math=False)
+    fig.canvas.draw()
+
+    ax.text(0, 0, r"$ \wrong{math} $", parse_math=True)
+    with pytest.raises(ValueError, match='Unknown symbol'):
+        fig.canvas.draw()
@@ -125,6 +125,8 @@ def __init__(self,
                  usetex=None,          # defaults to rcParams['text.usetex']
                  wrap=False,
                  transform_rotates_text=False,
+                 *,
+                 parse_math=True,
                  **kwargs
                  ):
         """
@@ -142,6 +144,7 @@ def __init__(self,
             color if color is not None else mpl.rcParams["text.color"])
         self.set_fontproperties(fontproperties)
         self.set_usetex(usetex)
+        self.set_parse_math(parse_math)
         self.set_wrap(wrap)
         self.set_verticalalignment(verticalalignment)
         self.set_horizontalalignment(horizontalalignment)
@@ -1237,6 +1240,8 @@ def _preprocess_math(self, s):
             if s == " ":
                 s = r"\ "
             return s, "TeX"
+        elif not self.get_parse_math():
+            return s, False
         elif cbook.is_math_text(s):
             return s, True
         else:
@@ -1274,6 +1279,25 @@ def get_usetex(self):
         """Return whether this `Text` object uses TeX for rendering."""
         return self._usetex
 
+    def set_parse_math(self, parse_math):
+        """
+        Override switch to enable/disable any mathtext
+        parsing for the given `Text` object.
+
+        Parameters
+        ----------
+        parse_math : bool
+            Whether to consider mathtext parsing for the string
+        """
+        self._parse_math = bool(parse_math)
+
+    def get_parse_math(self):
+        """
+        Return whether mathtext parsing is considered
+        for this `Text` object.
+        """
+        return self._parse_math
+
     def set_fontname(self, fontname):
         """
         Alias for `set_family`.
 
@@ -1018,9 +1018,12 @@ def __init__(self, ax, label, initial='',
         self.label = ax.text(
             -label_pad, 0.5, label, transform=ax.transAxes,
             verticalalignment='center', horizontalalignment='right')
+
+        # TextBox's text object should not parse mathtext at all.
         self.text_disp = self.ax.text(
-            self.DIST_FROM_LEFT, 0.5, initial, transform=self.ax.transAxes,
-            verticalalignment='center', horizontalalignment='left')
+            self.DIST_FROM_LEFT, 0.5, initial,
+            transform=self.ax.transAxes, verticalalignment='center',
+            horizontalalignment='left', parse_math=False)
 
         self._observers = cbook.CallbackRegistry()