Fix tick_params() label rotation mode (matplotlib#29593)

* Fix tick_params() label rotation mode

Follow-up to matplotlib#28968.

The rotation_mode was only wired up half way, so that the parameter was
accepted but did not have any effect.

* Update axis.pyi

Author: timhoffm

lib/matplotlib/axes/_base.py

@@ -3469,7 +3469,9 @@ def tick_params(self, axis='both', **kwargs):
         labelbottom, labeltop, labelleft, labelright : bool
             Whether to draw the respective tick labels.
         labelrotation : float
-            Tick label rotation
+            Tick label rotation angle in degrees. See `.Text.set_rotation`.
+        labelrotation_mode : {'default', 'anchor', 'xtick', 'ytick'}
+            Tick label rotation mode. See `.Text.set_rotation_mode`.
         grid_color : :mpltype:`color`
             Gridline color.
         grid_alpha : float

lib/matplotlib/axis.py

@@ -75,6 +75,7 @@ def __init__(
         label2On=False,
         major=True,
         labelrotation=0,
+        labelrotation_mode=None,
         grid_color=None,
         grid_linestyle=None,
         grid_linewidth=None,
@@ -157,11 +158,13 @@ def __init__(
         self.label1 = mtext.Text(
             np.nan, np.nan,
             fontsize=labelsize, color=labelcolor, visible=label1On,
-            fontfamily=labelfontfamily, rotation=self._labelrotation[1])
+            fontfamily=labelfontfamily, rotation=self._labelrotation[1],
+            rotation_mode=labelrotation_mode)
         self.label2 = mtext.Text(
             np.nan, np.nan,
             fontsize=labelsize, color=labelcolor, visible=label2On,
-            fontfamily=labelfontfamily, rotation=self._labelrotation[1])
+            fontfamily=labelfontfamily, rotation=self._labelrotation[1],
+            rotation_mode=labelrotation_mode)
 
         self._apply_tickdir(tickdir)
 
@@ -321,7 +324,8 @@ def _apply_params(self, **kwargs):
             self.label2.set(rotation=self._labelrotation[1])
 
         label_kw = {k[5:]: v for k, v in kwargs.items()
-                    if k in ['labelsize', 'labelcolor', 'labelfontfamily']}
+                    if k in ['labelsize', 'labelcolor', 'labelfontfamily',
+                             'labelrotation_mode']}
         self.label1.set(**label_kw)
         self.label2.set(**label_kw)
 
@@ -1050,14 +1054,15 @@ def _translate_tick_params(cls, kw, reverse=False):
             'tick1On', 'tick2On', 'label1On', 'label2On',
             'length', 'direction', 'left', 'bottom', 'right', 'top',
             'labelleft', 'labelbottom', 'labelright', 'labeltop',
-            'labelrotation', 'rotation_mode',
+            'labelrotation', 'labelrotation_mode',
             *_gridline_param_names]
 
         keymap = {
             # tick_params key -> axis key
             'length': 'size',
             'direction': 'tickdir',
             'rotation': 'labelrotation',
+            'rotation_mode': 'labelrotation_mode',
             'left': 'tick1On',
             'bottom': 'tick1On',
             'right': 'tick2On',

lib/matplotlib/axis.pyi

@@ -48,6 +48,7 @@ class Tick(martist.Artist):
         label2On: bool = ...,
         major: bool = ...,
         labelrotation: float = ...,
+        labelrotation_mode: Literal["default", "anchor", "xtick", "ytick"] | None = ...,
         grid_color: ColorType | None = ...,
         grid_linestyle: str | None = ...,
         grid_linewidth: float | None = ...,

lib/matplotlib/tests/test_axes.py

@@ -7539,15 +7539,19 @@ def test_tick_param_label_rotation():
     ax.yaxis.set_tick_params(which='both', rotation=90)
     for text in ax.get_xticklabels(which='both'):
         assert text.get_rotation() == 75
+        assert text.get_rotation_mode() == 'default'
     for text in ax.get_yticklabels(which='both'):
         assert text.get_rotation() == 90
+        assert text.get_rotation_mode() == 'default'
 
-    ax2.tick_params(axis='x', labelrotation=53)
-    ax2.tick_params(axis='y', rotation=35)
+    ax2.tick_params(axis='x', labelrotation=53, labelrotation_mode='xtick')
+    ax2.tick_params(axis='y', rotation=35, rotation_mode='ytick')
     for text in ax2.get_xticklabels(which='major'):
         assert text.get_rotation() == 53
+        assert text.get_rotation_mode() == 'xtick'
     for text in ax2.get_yticklabels(which='major'):
         assert text.get_rotation() == 35
+        assert text.get_rotation_mode() == 'ytick'
 
 
 @mpl.style.context('default')

lib/matplotlib/text.pyi

@@ -46,8 +46,8 @@ class Text(Artist):
     def update(self, kwargs: dict[str, Any]) -> list[Any]: ...
     def get_rotation(self) -> float: ...
     def get_transform_rotates_text(self) -> bool: ...
-    def set_rotation_mode(self, m: None | Literal["default", "anchor"]) -> None: ...
-    def get_rotation_mode(self) -> Literal["default", "anchor"]: ...
+    def set_rotation_mode(self, m: None | Literal["default", "anchor", "xtick", "ytick"]) -> None: ...
+    def get_rotation_mode(self) -> Literal["default", "anchor", "xtick", "ytick"]: ...
     def set_bbox(self, rectprops: dict[str, Any]) -> None: ...
     def get_bbox_patch(self) -> None | FancyBboxPatch: ...
     def update_bbox_position_size(self, renderer: RendererBase) -> None: ...