Deprecate update_navs

Author: elnelson575

examples/inputs-update/app.py

@@ -185,7 +185,7 @@ def _():
         # Tabset input =============================================
         # Change the selected tab.
         # The tabsetPanel must have been created with an 'id' argument
-        ui.update_navs("inTabset", selected="panel2" if c_num % 2 else "panel1")
+        ui.update_navset("inTabset", selected="panel2" if c_num % 2 else "panel1")
 
 
 app = App(app_ui, server, debug=True)

shiny/api-examples/navset_hidden/app-core.py

@@ -19,7 +19,7 @@ def server(input: Inputs, output: Outputs, session: Session):
     @reactive.effect
     @reactive.event(input.controller)
     def _():
-        ui.update_navs("hidden_tabs", selected="panel" + str(input.controller()))
+        ui.update_navset("hidden_tabs", selected="panel" + str(input.controller()))
 
 
 app = App(app_ui, server)

shiny/api-examples/navset_hidden/app-express.py

@@ -16,4 +16,4 @@
 @reactive.effect
 @reactive.event(input.controller)
 def _():
-    ui.update_navs("hidden_tabs", selected="panel" + str(input.controller()))
+    ui.update_navset("hidden_tabs", selected="panel" + str(input.controller()))

shiny/api-examples/update_navset/app-core.py

@@ -0,0 +1,20 @@
+from shiny import App, Inputs, Outputs, Session, reactive, ui
+
+app_ui = ui.page_sidebar(
+    ui.sidebar(ui.input_slider("controller", "Controller", min=1, max=3, value=1)),
+    ui.navset_card_tab(
+        ui.nav_panel("Panel 1", "Panel 1 content", value="panel1"),
+        ui.nav_panel("Panel 2", "Panel 2 content", value="panel2"),
+        ui.nav_panel("Panel 3", "Panel 3 content", value="panel3"),
+        id="inTabset",
+    ),
+)
+
+
+def server(input: Inputs, output: Outputs, session: Session):
+    @reactive.effect
+    def _():
+        ui.update_navset("inTabset", selected="panel" + str(input.controller()))
+
+
+app = App(app_ui, server)

shiny/api-examples/update_navset/app-express.py

@@ -0,0 +1,18 @@
+from shiny import reactive
+from shiny.express import input, ui
+
+with ui.sidebar():
+    ui.input_slider("controller", "Controller", min=1, max=3, value=1)
+
+with ui.navset_card_tab(id="inTabset"):
+    with ui.nav_panel("Panel 1", value="panel1"):
+        "Panel 1 content"
+    with ui.nav_panel("Panel 2", value="panel2"):
+        "Panel 2 content"
+    with ui.nav_panel("Panel 3", value="panel3"):
+        "Panel 3 content"
+
+
+@reactive.effect
+def _():
+    ui.update_navset("inTabset", selected="panel" + str(input.controller()))

shiny/express/ui/__init__.py

@@ -94,6 +94,7 @@
     update_date_range,
     update_nav_panel,
     update_navs,
+    update_navset,
     update_numeric,
     update_popover,
     update_radio_buttons,
@@ -246,6 +247,7 @@
     "update_text",
     "update_text_area",
     "update_navs",
+    "update_navset",
     "update_tooltip",
     "update_popover",
     "insert_ui",

shiny/express/ui/_cm_components.py

@@ -1203,7 +1203,7 @@ def nav_panel(
     value
         The value of the item. This is used to determine whether the item is active
         (when an ``id`` is provided to the nav container), programmatically select the
-        item (e.g., :func:`~shiny.ui.update_navs`), and/or be provided to the
+        item (e.g., :func:`~shiny.ui.update_navset`), and/or be provided to the
         ``selected`` argument of the navigation container (e.g.,
         :func:`~shiny.ui.navset_tab`).
     icon
@@ -1249,7 +1249,7 @@ def nav_menu(
     value
         The value of the item. This is used to determine whether the item is active
         (when an ``id`` is provided to the nav container), programmatically select the
-        item (e.g., :func:`~shiny.ui.update_navs`), and/or be provided to the
+        item (e.g., :func:`~shiny.ui.update_navset`), and/or be provided to the
         ``selected`` argument of the navigation container (e.g.,
         :func:`~shiny.ui.navset_tab`).
     icon

shiny/express/ui/_insert.py

@@ -111,7 +111,7 @@ def insert_nav_panel(
     value
         The value of the panel. Use this value to determine whether the panel is active
         (when an `id` is provided to the nav container) or to programmatically
-        select the item (e.g., :func:`~shiny.ui.update_navs`). You can also
+        select the item (e.g., :func:`~shiny.ui.update_navset`). You can also
         provide the value to the `selected` argument of the navigation container
         (e.g., :func:`~shiny.ui.navset_tab`).
     icon

shiny/ui/__init__.py

@@ -94,6 +94,7 @@
     update_date,
     update_date_range,
     update_navs,
+    update_navset,
     update_numeric,
     update_popover,
     update_radio_buttons,
@@ -273,6 +274,7 @@
     "update_text",
     "update_text_area",
     "update_navs",
+    "update_navset",
     "update_tooltip",
     "update_popover",
     # _insert

shiny/ui/_input_update.py

@@ -16,6 +16,7 @@
     "update_text",
     "update_text_area",
     "update_navs",
+    "update_navset",
 )
 
 import json
@@ -27,6 +28,7 @@
 from starlette.requests import Request
 from starlette.responses import JSONResponse, Response
 
+from .._deprecated import warn_deprecated
 from .._docstring import add_example, doc_format, no_example
 from .._typing_extensions import NotRequired, TypedDict
 from .._utils import drop_none
@@ -1054,6 +1056,45 @@ def update_navs(
     ----
     {note}
 
+    See Also
+    --------
+    * :func:`~shiny.ui.navset_tab`
+    * :func:`~shiny.ui.navset_pill`
+    * :func:`~shiny.ui.page_navbar`
+    """
+    warn_deprecated(
+        "`shiny.ui.update_navs()` has been superseded by `shiny.ui.update_navset()` and will be removed in the near future."
+    )
+
+    update_navset(
+        id=id,
+        selected=selected,
+        session=session,
+    )
+
+
+@add_example()
+@doc_format(note=_note)
+def update_navset(
+    id: str, selected: Optional[str] = None, session: Optional[Session] = None
+) -> None:
+    """
+    Change the value of a navs container on the client.
+
+    Parameters
+    ----------
+    id
+        An input id.
+    selected
+        The values that should be initially selected, if any.
+    session
+        A :class:`~shiny.Session` instance. If not provided, it is inferred via
+        :func:`~shiny.session.get_current_session`.
+
+    Note
+    ----
+    {note}
+
     See Also
     --------
     * :func:`~shiny.ui.navset_tab`