Merge branch 'main' into fix/selectize-escaping

Author: elnelson575

CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### New features
 
+* Added `ui.insert_nav_panel()`, `ui.remove_nav_panel()`, and `ui.update_nav_panel()` to support dynamic navigation. (#90)
+
 * Added support for python 3.13. (#1711)
 
 * `ui.sidebar()` is now interactively resizable. (#2020)
@@ -19,6 +21,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * `playwright.controller.InputActionButton` gains a `expect_icon()` method. As a result, the already existing `expect_label()` no longer includes the icon. (#2020)
 
+### Changes
+
+* `express.ui.insert_accordion_panel()`'s function signature has changed to be more ergonomic. Now you can pass the `panel_title` and `panel_contents` directly instead of `ui.hold()`ing the `ui.accordion_panel()` context manager. (#2042)
+
 ### Improvements
 
 * Improved the styling and readability of markdown tables rendered by `ui.Chat()` and `ui.MarkdownStream()`. (#1973)
@@ -29,6 +35,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Added module support for `session.clientdata` methods. This allows you to access client data values in Shiny modules without needing to namespace the keys explicitly. (#1978)
 
+* Fixed false positive warning in `layout_columns()` about number of widths vs elements. (#1704)
+
 ### Bug fixes
 
 * Fixed an issue with `ui.Chat()` sometimes wanting to scroll a parent element. (#1996)
@@ -39,6 +47,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Fixed `set()` method of `InputSelectize` controller so it clears existing selections before applying new values. (#2024)
 
+### Deprecations
+
+* `ui.panel_well()` is deprecated in favor of `ui.card()`. (#2038)
+
 
 ## [1.4.0] - 2025-04-08
 

docs/_quartodoc-core.yml

@@ -84,14 +84,16 @@ quartodoc:
         - ui.navset_pill_list
         - ui.navset_hidden
         - ui.navbar_options
+        - ui.insert_nav_panel
+        - ui.remove_nav_panel
+        - ui.update_nav_panel
     - title: UI panels
       desc: Visually group together a section of UI components.
       contents:
         - ui.panel_absolute
         - ui.panel_fixed
         - ui.panel_conditional
         - ui.panel_title
-        - ui.panel_well
     - title: Uploads & downloads
       desc: Allow users to upload and download files.
       contents:

docs/_quartodoc-express.yml

@@ -78,6 +78,9 @@ quartodoc:
         - express.ui.navset_pill_list
         - express.ui.navset_hidden
         - express.ui.navbar_options
+        - express.ui.insert_nav_panel
+        - express.ui.remove_nav_panel
+        - express.ui.update_nav_panel
     - title: Chat interface
       desc: Build a chatbot interface
       contents:
@@ -157,7 +160,6 @@ quartodoc:
         - express.ui.panel_absolute
         - express.ui.panel_fixed
         - express.ui.panel_title
-        - express.ui.panel_well
     - title: Uploads & downloads
       desc: Allow users to upload and download files.
       contents:

examples/airmass/app.py

@@ -14,45 +14,37 @@
 
 from shiny import App, Inputs, Outputs, Session, reactive, render, req, ui
 
-app_ui = ui.page_fixed(
-    ui.tags.h3("Air mass calculator"),
-    ui.div(
+app_ui = ui.page_fillable(
+    ui.tags.h2("Air mass calculator", {"class": "lead display-6 text-center"}),
+    ui.layout_columns(
         ui.markdown(
             """This Shiny app uses [Astropy](https://www.astropy.org/) to calculate the
-            altitude (degrees above the horizon) and airmass (the amount of atmospheric
-            air along your line of sight to an object) of one or more astronomical
-            objects, over a given evening, at a given geographic location.
-            """
+        altitude (degrees above the horizon) and airmass (the amount of atmospheric
+        air along your line of sight to an object) of one or more astronomical
+        objects, over a given evening, at a given geographic location.
+        """
         ),
-        class_="mb-5",
-    ),
-    ui.row(
-        ui.column(
-            8,
+        ui.card(
             ui.output_ui("timeinfo"),
-            ui.output_plot("plot", height="800px"),
+            ui.output_plot("plot", height="600px"),
             # For debugging
             # ui.output_table("table"),
-            class_="order-2 order-sm-1",
         ),
-        ui.column(
-            4,
-            ui.panel_well(
-                ui.input_date("date", "Date"),
-                class_="pb-1 mb-3",
-            ),
-            ui.panel_well(
+        ui.TagList(
+            ui.card(ui.input_date("date", "Date"), fill=False),
+            ui.card(
                 ui.input_text_area(
-                    "objects", "Target object(s)", "M1, NGC35, PLX299", rows=3
+                    "objects",
+                    "Target object(s)",
+                    "M1, NGC35, PLX299",
+                    rows=2,
                 ),
-                class_="pb-1 mb-3",
-            ),
-            ui.panel_well(
-                location_ui("location"),
-                class_="mb-3",
+                fill=False,
             ),
-            class_="order-1 order-sm-2",
+            ui.card(location_ui("location")),
         ),
+        col_widths=[-2, 8, -2, -1, 7, 3, -1],
+        min_height="600px",
     ),
 )
 

examples/inputs-update/app.py

@@ -4,78 +4,70 @@
 
 app_ui = ui.page_fluid(
     ui.panel_title("Changing the values of inputs from the server"),
-    ui.row(
-        ui.column(
-            4,
-            ui.panel_well(
-                ui.tags.h4("These inputs control the other inputs on the page"),
-                ui.input_text(
-                    "control_label", "This controls some of the labels:", "LABEL TEXT"
-                ),
-                ui.input_slider(
-                    "control_num", "This controls values:", min=1, max=20, value=15
-                ),
+    ui.layout_columns(
+        ui.card(
+            ui.card_header("These inputs control the other inputs on the page"),
+            ui.input_text(
+                "control_label", "This controls some of the labels:", "LABEL TEXT"
+            ),
+            ui.input_slider(
+                "control_num", "This controls values:", min=1, max=20, value=15
             ),
         ),
-        ui.column(
-            4,
-            ui.panel_well(
-                ui.tags.h4("These inputs are controlled by the other inputs"),
-                ui.input_text("inText", "Text input:", value="start text"),
-                ui.input_numeric(
-                    "inNumber", "Number input:", min=1, max=20, value=5, step=0.5
-                ),
-                ui.input_numeric(
-                    "inNumber2", "Number input 2:", min=1, max=20, value=5, step=0.5
-                ),
-                ui.input_slider("inSlider", "Slider input:", min=1, max=20, value=15),
-                ui.input_slider(
-                    "inSlider2", "Slider input 2:", min=1, max=20, value=(5, 15)
-                ),
-                ui.input_slider(
-                    "inSlider3", "Slider input 3:", min=1, max=20, value=(5, 15)
-                ),
-                ui.input_date("inDate", "Date input:"),
-                ui.input_date_range("inDateRange", "Date range input:"),
+        ui.card(
+            ui.card_header("These inputs are controlled by the other inputs"),
+            ui.input_text("inText", "Text input:", value="start text"),
+            ui.input_numeric(
+                "inNumber", "Number input:", min=1, max=20, value=5, step=0.5
+            ),
+            ui.input_numeric(
+                "inNumber2", "Number input 2:", min=1, max=20, value=5, step=0.5
+            ),
+            ui.input_slider("inSlider", "Slider input:", min=1, max=20, value=15),
+            ui.input_slider(
+                "inSlider2", "Slider input 2:", min=1, max=20, value=(5, 15)
+            ),
+            ui.input_slider(
+                "inSlider3", "Slider input 3:", min=1, max=20, value=(5, 15)
             ),
+            ui.input_date("inDate", "Date input:"),
+            ui.input_date_range("inDateRange", "Date range input:"),
         ),
-        ui.column(
-            4,
-            ui.panel_well(
-                ui.input_checkbox("inCheckbox", "Checkbox input", value=False),
-                ui.input_checkbox_group(
-                    "inCheckboxGroup",
-                    "Checkbox group input:",
-                    {
-                        "option1": "label 1",
-                        "option2": "label 2",
-                    },
-                ),
-                ui.input_radio_buttons(
-                    "inRadio",
-                    "Radio buttons:",
-                    {
-                        "option1": "label 1",
-                        "option2": "label 2",
-                    },
-                ),
-                ui.input_select(
-                    "inSelect",
-                    "Select input:",
-                    {
-                        "option1": "label 1",
-                        "option2": "label 2",
-                    },
-                ),
-                ui.input_select(
-                    "inSelect2",
-                    "Select input 2:",
-                    {
-                        "option1": "label 1",
-                        "option2": "label 2",
-                    },
-                    multiple=True,
-                ),
+        ui.card(
+            ui.card_header("These inputs are updated by the server"),
+            ui.input_checkbox("inCheckbox", "Checkbox input", value=False),
+            ui.input_checkbox_group(
+                "inCheckboxGroup",
+                "Checkbox group input:",
+                {
+                    "option1": "label 1",
+                    "option2": "label 2",
+                },
+            ),
+            ui.input_radio_buttons(
+                "inRadio",
+                "Radio buttons:",
+                {
+                    "option1": "label 1",
+                    "option2": "label 2",
+                },
+            ),
+            ui.input_select(
+                "inSelect",
+                "Select input:",
+                {
+                    "option1": "label 1",
+                    "option2": "label 2",
+                },
+            ),
+            ui.input_select(
+                "inSelect2",
+                "Select input 2:",
+                {
+                    "option1": "label 1",
+                    "option2": "label 2",
+                },
+                multiple=True,
             ),
             ui.navset_tab(
                 ui.nav_panel("panel1", ui.h2("This is the first panel.")),

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

@@ -1,20 +1,21 @@
 import random
 
-from shiny import reactive, ui
-from shiny.express import input
-
-
-def make_panel(letter):
-    return ui.accordion_panel(
-        f"Section {letter}", f"Some narrative for section {letter}"
-    )
-
+from shiny import reactive
+from shiny.express import input, ui
 
 ui.input_action_button("add_panel", "Add random panel", class_="mt-3 mb-3")
-ui.accordion(*[make_panel(letter) for letter in "ABCDE"], id="acc", multiple=True)
+
+with ui.accordion(id="acc", multiple=True):
+    for letter in "ABCDE":
+        with ui.accordion_panel(f"Section {letter}"):
+            f"Some narrative for section {letter}"
 
 
 @reactive.effect
 @reactive.event(input.add_panel)
 def _():
-    ui.insert_accordion_panel("acc", make_panel(str(random.randint(0, 10000))))
+    ui.insert_accordion_panel(
+        "acc",
+        f"Section {random.randint(0, 10000)}",
+        f"Some narrative for section {random.randint(0, 10000)}",
+    )

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

@@ -0,0 +1,52 @@
+from shiny import App, Inputs, Outputs, Session, reactive, ui
+
+app_ui = ui.page_sidebar(
+    ui.sidebar(
+        ui.input_action_button("add", "Add 'Dynamic' tab"),
+        ui.input_action_button("update_foo", "Add/Remove 'Foo' tab"),
+    ),
+    ui.navset_tab(
+        ui.nav_panel("Hello", "This is the hello tab", value="Hello"),
+        ui.nav_panel("Foo", "This is the Foo tab", value="Foo"),
+        ui.nav_menu(
+            "Static",
+            ui.nav_panel("Static 1", "Static 1", value="s1"),
+            ui.nav_panel("Static 2", "Static 2", value="s2"),
+            value="Menu",
+        ),
+        id="tabs",
+    ),
+)
+
+
+def server(input: Inputs, output: Outputs, session: Session):
+
+    @reactive.effect
+    @reactive.event(input.update_foo)
+    def _():
+        if input.update_foo() % 2 == 0:
+            ui.insert_nav_panel(
+                "tabs",
+                ui.nav_panel("Foo", "Foo is back now", value="Foo"),
+                target="Menu",
+                position="before",
+                select=True,
+            )
+        else:
+            ui.remove_nav_panel("tabs", target="Foo")
+
+    @reactive.effect
+    @reactive.event(input.add)
+    def _():
+        id = "Dynamic-" + str(input.add())
+        ui.insert_nav_panel(
+            "tabs",
+            ui.nav_panel(id, id, value=id),
+            target="s2",
+            position="before",
+        )
+
+        ui.notification_show(f"Added tab to menu: {id}")
+
+
+app = App(app_ui, server)