matplotlib
diff --git a/‎doc/api/widgets_api.rst‎
Lines changed: 1 addition & 0 deletions b/‎doc/api/widgets_api.rst‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎lib/matplotlib/widgets.py‎
Lines changed: 79 additions & 128 deletions b/‎lib/matplotlib/widgets.py‎
Lines changed: 79 additions & 128 deletions
@@ -27,6 +27,7 @@ Widget classes
    Cursor
    MultiCursor
    Button
+   _Buttons
    CheckButtons
    RadioButtons
    SliderBase
 
@@ -1037,7 +1037,84 @@ def _expand_text_props(props):
     return cycler(**props)() if props else itertools.repeat({})
 
 
-class CheckButtons(AxesWidget):
+class _Buttons(AxesWidget):
+    """
+    The base class for `CheckButtons` and `RadioButtons`.
+
+    This class provides common functionality for button widgets,
+    such as handling click events, managing button labels, and connecting callbacks.
+
+    The class itself is private and may be changed or removed without prior warning.
+    However, the public API it provides to subclasses is stable and considered
+    public on the subclasses.
+    """
+
+    def _clear(self, event):
+        """Internal event handler to clear the buttons."""
+        if self.ignore(event) or self.canvas.is_saving():
+            return
+        if self._useblit and self.canvas.supports_blit:
+            self._save_blit_background(self.canvas.copy_from_bbox(self.ax.bbox))
+        self.ax.draw_artist(self._buttons)
+
+    def set_label_props(self, props):
+        """
+        Set properties of the `.Text` labels.
+
+        .. versionadded:: 3.7
+
+        Parameters
+        ----------
+        props : dict
+            Dictionary of `.Text` properties to be used for the labels. Same
+            format as label_props argument of :class:`RadioButtons` or
+            :class:`CheckButtons`.
+        """
+        _api.check_isinstance(dict, props=props)
+        props = _expand_text_props(props)
+        for text, prop in zip(self.labels, props):
+            text.update(prop)
+
+    @_call_with_reparented_event
+    def _clicked(self, event):
+        if self.ignore(event) or event.button != 1 or not self.ax.contains(event)[0]:
+            return
+        idxs = [  # Indices of frames and of texts that contain the event.
+            *self._frames.contains(event)[1]["ind"],
+            *[i for i, text in enumerate(self.labels) if text.contains(event)[0]]]
+        if idxs:
+            coords = self._frames.get_offset_transform().transform(
+                self._frames.get_offsets())
+            self.set_active(  # Closest index, only looking in idxs.
+                idxs[(((event.x, event.y) - coords[idxs]) ** 2).sum(-1).argmin()])
+
+    def on_clicked(self, func):
+        """
+        Connect the callback function *func* to button click events.
+
+        Parameters
+        ----------
+        func : callable
+            When the button is clicked, call *func* with button label.
+            When all buttons are cleared, call *func* with None.
+            The callback func must have the signature::
+
+                def func(label: str | None) -> Any
+
+            Return values may exist, but are ignored.
+
+        Returns
+        -------
+        A connection id, which can be used to disconnect the callback.
+        """
+        return self._observers.connect('clicked', func)
+
+    def disconnect(self, cid):
+        """Remove the observer with connection id *cid*."""
+        self._observers.disconnect(cid)
+
+
+class CheckButtons(_Buttons):
     r"""
     A GUI neutral set of check buttons.
 
@@ -1152,44 +1229,6 @@ def __init__(self, ax, labels, actives=None, *, useblit=True,
 
         self._observers = cbook.CallbackRegistry(signals=["clicked"])
 
-    def _clear(self, event):
-        """Internal event handler to clear the buttons."""
-        if self.ignore(event) or self.canvas.is_saving():
-            return
-        if self._useblit and self.canvas.supports_blit:
-            self._save_blit_background(self.canvas.copy_from_bbox(self.ax.bbox))
-        self.ax.draw_artist(self._buttons)
-
-    @_call_with_reparented_event
-    def _clicked(self, event):
-        if self.ignore(event) or event.button != 1 or not self.ax.contains(event)[0]:
-            return
-        idxs = [  # Indices of frames and of texts that contain the event.
-            *self._frames.contains(event)[1]["ind"],
-            *[i for i, text in enumerate(self.labels) if text.contains(event)[0]]]
-        if idxs:
-            coords = self._frames.get_offset_transform().transform(
-                self._frames.get_offsets())
-            self.set_active(  # Closest index, only looking in idxs.
-                idxs[(((event.x, event.y) - coords[idxs]) ** 2).sum(-1).argmin()])
-
-    def set_label_props(self, props):
-        """
-        Set properties of the `.Text` labels.
-
-        .. versionadded:: 3.7
-
-        Parameters
-        ----------
-        props : dict
-            Dictionary of `.Text` properties to be used for the labels. Same
-            format as label_props argument of :class:`CheckButtons`.
-        """
-        _api.check_isinstance(dict, props=props)
-        props = _expand_text_props(props)
-        for text, prop in zip(self.labels, props):
-            text.update(prop)
-
     def set_frame_props(self, props):
         """
         Set properties of the check button frames.
@@ -1321,31 +1360,6 @@ def get_checked_labels(self):
                 zip(self.labels, self.get_status())
                 if box_checked]
 
-    def on_clicked(self, func):
-        """
-        Connect the callback function *func* to button click events.
-
-        Parameters
-        ----------
-        func : callable
-            When the button is clicked, call *func* with button label.
-            When all buttons are cleared, call *func* with None.
-            The callback func must have the signature::
-
-                def func(label: str | None) -> Any
-
-            Return values may exist, but are ignored.
-
-        Returns
-        -------
-        A connection id, which can be used to disconnect the callback.
-        """
-        return self._observers.connect('clicked', lambda text: func(text))
-
-    def disconnect(self, cid):
-        """Remove the observer with connection id *cid*."""
-        self._observers.disconnect(cid)
-
 
 class TextBox(AxesWidget):
     """
@@ -1612,7 +1626,7 @@ def disconnect(self, cid):
         self._observers.disconnect(cid)
 
 
-class RadioButtons(AxesWidget):
+class RadioButtons(_Buttons):
     """
     A GUI neutral radio button.
 
@@ -1745,44 +1759,6 @@ def __init__(self, ax, labels, active=0, activecolor=None, *,
 
         self._observers = cbook.CallbackRegistry(signals=["clicked"])
 
-    def _clear(self, event):
-        """Internal event handler to clear the buttons."""
-        if self.ignore(event) or self.canvas.is_saving():
-            return
-        if self._useblit and self.canvas.supports_blit:
-            self._save_blit_background(self.canvas.copy_from_bbox(self.ax.bbox))
-        self.ax.draw_artist(self._buttons)
-
-    @_call_with_reparented_event
-    def _clicked(self, event):
-        if self.ignore(event) or event.button != 1 or not self.ax.contains(event)[0]:
-            return
-        idxs = [  # Indices of buttons and of texts that contain the event.
-            *self._buttons.contains(event)[1]["ind"],
-            *[i for i, text in enumerate(self.labels) if text.contains(event)[0]]]
-        if idxs:
-            coords = self._buttons.get_offset_transform().transform(
-                self._buttons.get_offsets())
-            self.set_active(  # Closest index, only looking in idxs.
-                idxs[(((event.x, event.y) - coords[idxs]) ** 2).sum(-1).argmin()])
-
-    def set_label_props(self, props):
-        """
-        Set properties of the `.Text` labels.
-
-        .. versionadded:: 3.7
-
-        Parameters
-        ----------
-        props : dict
-            Dictionary of `.Text` properties to be used for the labels. Same
-            format as label_props argument of :class:`RadioButtons`.
-        """
-        _api.check_isinstance(dict, props=props)
-        props = _expand_text_props(props)
-        for text, prop in zip(self.labels, props):
-            text.update(prop)
-
     def set_radio_props(self, props):
         """
         Set properties of the `.Text` labels.
@@ -1859,31 +1835,6 @@ def clear(self):
         """Reset the active button to the initially active one."""
         self.set_active(self._initial_active)
 
-    def on_clicked(self, func):
-        """
-        Connect the callback function *func* to button click events.
-
-        Parameters
-        ----------
-        func : callable
-            When the button is clicked, call *func* with button label.
-            When all buttons are cleared, call *func* with None.
-            The callback func must have the signature::
-
-                def func(label: str | None) -> Any
-
-            Return values may exist, but are ignored.
-
-        Returns
-        -------
-        A connection id, which can be used to disconnect the callback.
-        """
-        return self._observers.connect('clicked', func)
-
-    def disconnect(self, cid):
-        """Remove the observer with connection id *cid*."""
-        self._observers.disconnect(cid)
-
 
 class SubplotTool(Widget):
     """