Rename Stacked widget to Stack

All of our other widgets are present tense, like Accordion, Tab, Box, etc, so the grammar feels like it fits better. As a survey:

Toolkits that use "Stack":

* flutter: https://api.flutter.dev/flutter/widgets/Stack-class.html
* GTK: https://docs.gtk.org/gtk4/class.Stack.html
* MUI: https://mui.com/material-ui/react-stack/
* Kivy: https://kivy.org/doc/stable/api-kivy.uix.stacklayout.html?highlight=stack


Toolkits that use "Stacked":

* QT: https://doc.qt.io/qt-6/qstackedwidget.html

Author: jasongrout

docs/source/changelog.md

@@ -27,7 +27,7 @@ See also the
 - Tagsinput widget ([#2591](https://github.com/jupyter-widgets/ipywidgets/pull/2591), [#3272](https://github.com/jupyter-widgets/ipywidgets/pull/3272))
 - Drop notebook dependency from widgetsnbextension ([#2590](https://github.com/jupyter-widgets/ipywidgets/pull/2590))
 - Cast 'value' in range sliders to a tuple ([#2441](https://github.com/jupyter-widgets/ipywidgets/pull/2441))
-- Added a layout widget for 'stacked' layout ([#2376](https://github.com/jupyter-widgets/ipywidgets/pull/2376))
+- Added a layout widget for 'stack' layout ([#2376](https://github.com/jupyter-widgets/ipywidgets/pull/2376))
 - Play widget: expose playing and repeat ([#2283](https://github.com/jupyter-widgets/ipywidgets/pull/2283), [#1897](https://github.com/jupyter-widgets/ipywidgets/issues/1897))
 - Fix debouncing and throttling code ([#3060](https://github.com/jupyter-widgets/ipywidgets/pull/3060))
 - Fix regression on spinning icons ([#2685](https://github.com/jupyter-widgets/ipywidgets/pull/2685), [#2477](https://github.com/jupyter-widgets/ipywidgets/issues/2477))

docs/source/examples/Widget List.ipynb

@@ -1388,9 +1388,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Stacked\n",
+    "### Stack\n",
     "\n",
-    "The `Stacked` widget can have multiple children widgets as for `Tab` and `Accordion`, but only shows one at a time depending on the value of ``selected_index``:"
+    "The `Stack` widget can have multiple children widgets as for `Tab` and `Accordion`, but only shows one at a time depending on the value of ``selected_index``:"
    ]
   },
   {
@@ -1401,8 +1401,8 @@
    "source": [
     "button = widgets.Button(description='Click here')\n",
     "slider = widgets.IntSlider()\n",
-    "stacked = widgets.Stacked([button, slider], selected_index=0)\n",
-    "stacked  # will show only the button"
+    "stack = widgets.Stack([button, slider], selected_index=0)\n",
+    "stack  # will show only the button"
    ]
   },
   {
@@ -1419,15 +1419,15 @@
    "outputs": [],
    "source": [
     "dropdown = widgets.Dropdown(options=['button', 'slider'])\n",
-    "widgets.jslink((dropdown, 'index'), (stacked, 'selected_index'))\n",
-    "widgets.VBox([dropdown, stacked])"
+    "widgets.jslink((dropdown, 'index'), (stack, 'selected_index'))\n",
+    "widgets.VBox([dropdown, stack])"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Accordion,  Tab, and Stacked use `selected_index`, not value\n",
+    "### Accordion,  Tab, and Stack use `selected_index`, not value\n",
     "\n",
     "Unlike the rest of the widgets discussed earlier, the container widgets `Accordion` and `Tab` update their `selected_index` attribute when the user changes which accordion or tab is selected. That means that you can both see what the user is doing *and* programmatically set what the user sees by setting the value of `selected_index`.\n",
     "\n",

packages/controls/src/widget_selectioncontainer.ts

@@ -422,17 +422,17 @@ export class TabView extends DOMWidgetView {
   luminoWidget: JupyterLuminoTabPanelWidget;
 }
 
-export class StackedModel extends SelectionContainerModel {
+export class StackModel extends SelectionContainerModel {
   defaults(): Backbone.ObjectHash {
     return {
       ...super.defaults(),
-      _model_name: 'StackedModel',
-      _view_name: 'StackedView',
+      _model_name: 'StackModel',
+      _view_name: 'StackView',
     };
   }
 }
 
-export class StackedView extends BoxView {
+export class StackView extends BoxView {
   initialize(parameters: WidgetView.IInitializeParameters): void {
     super.initialize(parameters);
     this.listenTo(this.model, 'change:selected_index', this.update_children);

packages/schema/jupyterwidgetmodels.latest.json

@@ -6554,7 +6554,7 @@
         "type": "string"
       },
       {
-        "default": "StackedModel",
+        "default": "StackModel",
         "help": "",
         "name": "_model_name",
         "type": "string"
@@ -6572,7 +6572,7 @@
         "type": "string"
       },
       {
-        "default": "StackedView",
+        "default": "StackView",
         "help": "",
         "name": "_view_name",
         "type": "string"
@@ -6634,12 +6634,12 @@
     ],
     "model": {
       "module": "@jupyter-widgets/controls",
-      "name": "StackedModel",
+      "name": "StackModel",
       "version": "2.0.0"
     },
     "view": {
       "module": "@jupyter-widgets/controls",
-      "name": "StackedView",
+      "name": "StackView",
       "version": "2.0.0"
     }
   },

packages/schema/jupyterwidgetmodels.latest.md

@@ -1168,17 +1168,17 @@ Attribute        | Type             | Default          | Help
 `description_width` | string           | `''`             | Width of the description to the side of the control.
 `handle_color`   | `null` or string | `null`           | Color of the slider handle.
 
-### StackedModel (@jupyter-widgets/controls, 2.0.0); StackedView (@jupyter-widgets/controls, 2.0.0)
+### StackModel (@jupyter-widgets/controls, 2.0.0); StackView (@jupyter-widgets/controls, 2.0.0)
 
 Attribute        | Type             | Default          | Help
 -----------------|------------------|------------------|----
 `_dom_classes`   | array of string  | `[]`             | CSS classes applied to widget DOM element
 `_model_module`  | string           | `'@jupyter-widgets/controls'` | 
 `_model_module_version` | string           | `'2.0.0'`        | 
-`_model_name`    | string           | `'StackedModel'` | 
+`_model_name`    | string           | `'StackModel'`   | 
 `_view_module`   | string           | `'@jupyter-widgets/controls'` | 
 `_view_module_version` | string           | `'2.0.0'`        | 
-`_view_name`     | string           | `'StackedView'`  | 
+`_view_name`     | string           | `'StackView'`    | 
 `box_style`      | string (one of `'success'`, `'info'`, `'warning'`, `'danger'`, `''`) | `''`             | Use a predefined styling for the box.
 `children`       | array of reference to Widget widget | `[]`             | List of widget children
 `layout`         | reference to Layout widget | reference to new instance | 

python/ipywidgets/ipywidgets/widgets/__init__.py

@@ -19,7 +19,7 @@
 from .widget_time import TimePicker
 from .widget_output import Output
 from .widget_selection import RadioButtons, ToggleButtons, ToggleButtonsStyle, Dropdown, Select, SelectionSlider, SelectMultiple, SelectionRangeSlider
-from .widget_selectioncontainer import Tab, Accordion, Stacked
+from .widget_selectioncontainer import Tab, Accordion, Stack
 from .widget_string import HTML, HTMLMath, Label, Text, Textarea, Password, Combobox
 from .widget_controller import Controller
 from .interaction import interact, interactive, fixed, interact_manual, interactive_output

python/ipywidgets/ipywidgets/widgets/tests/test_selectioncontainer.py

@@ -5,7 +5,7 @@
 
 from traitlets import TraitError
 
-from ipywidgets.widgets import Accordion, Tab, Stacked, HTML
+from ipywidgets.widgets import Accordion, Tab, Stack, HTML
 
 class TestTab(TestCase):
 
@@ -113,11 +113,11 @@ def test_titles(self):
         assert len(widget.children) == 1
         assert widget.titles == ('',)
 
-class TestStacked(TestCase):
+class TestStack(TestCase):
 
     def setUp(self):
         self.children = [HTML('0'), HTML('1')]
-        self.widget = Stacked
+        self.widget = Stack
 
     def test_selected_index_none(self):
         widget = self.widget(self.children, selected_index=None)

python/ipywidgets/ipywidgets/widgets/widget_selectioncontainer.py

@@ -114,7 +114,7 @@ def _reset_selected_index(self):
 
 
 @register
-class Stacked(_SelectionContainer):
+class Stack(_SelectionContainer):
     """Displays only the selected child."""
-    _view_name = Unicode('StackedView').tag(sync=True)
-    _model_name = Unicode('StackedModel').tag(sync=True)
+    _view_name = Unicode('StackView').tag(sync=True)
+    _model_name = Unicode('StackModel').tag(sync=True)