v0.10.0: Rename @render.data_frame method .input_cell_selection() to .cell_selection() (#148)

Author: schloerke

.github/workflows/deploy-docs.yml

@@ -4,7 +4,6 @@ on:
   push:
     branches: [main]
   pull_request:
-    branches: [main]
 
 jobs:
   build:

_quarto.yml

@@ -62,6 +62,9 @@ website:
     image-height: 630
     card-style: "summary_large_image"
 
+  repo-url: https://github.com/posit-dev/py-shiny-site
+  repo-actions: [issue, edit]
+
   navbar:
     background: primary
     foreground: light

components/_metadata.yml

@@ -10,3 +10,4 @@ filters:
   - quarto
   - line-highlight
   - shinylive
+repo-actions: false

components/outputs/data-grid/app-variation-select-rows-core.py

@@ -17,7 +17,7 @@ def penguins_df():
 
     @render.ui
     def rows():
-        rows = penguins_df.input_cell_selection()["rows"]  # <<
+        rows = penguins_df.cell_selection()["rows"]  # <<
         selected = ", ".join(str(i) for i in sorted(rows)) if rows else "None"
         return f"Rows selected: {selected}"
 

components/outputs/data-grid/app-variation-select-rows-express.py

@@ -9,7 +9,7 @@
 
 @render.ui()
 def rows():
-    rows = penguins_df.input_cell_selection()["rows"]  # <<
+    rows = penguins_df.cell_selection()["rows"]  # <<
     selected = ", ".join(str(i) for i in sorted(rows)) if rows else "None"
     return f"Rows selected: {selected}"
 

components/outputs/data-grid/index.qmd

@@ -47,7 +47,7 @@ listing:
   - title: Select Rows
     description: Set `selection_mode` in `render.DataGrid()` to `"row"` to allow the
       user to select one row at a time. Set it to `"rows"` to allow the user to select
-      multiple rows at a time. Access the selection(s) as `<id>.input_cell_selection()["rows"]`.
+      multiple rows at a time. Access the selection(s) as `<id>.cell_selection()["rows"]`.
     apps:
     - title: Preview
       file: app-variation-select-rows-core.py
@@ -130,9 +130,9 @@ To make a reactive Data Grid, follow three steps:
 
 A Data Grid can also collect input from the user. To allow this, set `render.DataGrid(selection_mode="row")` or `render.DataGrid(selection_mode="rows")` to allow the user to select one or more rows of the Data Grid.
 
-The indices of the selected rows will be accessible within the server function as a reactive variable returned by `<name>.input_cell_selection()["rows"]`, where <name> is the name of the function decorated with `@render.data_frame`.
+The indices of the selected rows will be accessible within the server function as a reactive variable returned by `<name>.cell_selection()["rows"]`, where <name> is the name of the function decorated with `@render.data_frame`.
 
-The value returned will be an empty tuple if no rows are selected, or a tuple of integers representing the indices of the selected rows. To filter a pandas data frame down to the selected rows, use `df.iloc[list(<name>.input_cell_selection()["rows"])]`.
+The value returned will be an empty tuple if no rows are selected, or a tuple of integers representing the indices of the selected rows. To filter a pandas data frame down to the selected rows, use `df.iloc[list(<name>.cell_selection()["rows"])]`.
 
 For more information about interacting with data frames, see the API documentation for [Express](../../../api/express/express.render.data_frame.qmd) or [Core](../../../api/core/render.data_frame.qmd) syntax.
 

components/outputs/datatable/app-variation-select-rows-core.py

@@ -17,7 +17,7 @@ def penguins_df():
 
     @render.ui
     def rows():
-        rows = penguins_df.input_cell_selection()["rows"]  # <<
+        rows = penguins_df.cell_selection()["rows"]  # <<
         selected = ", ".join(str(i) for i in sorted(rows)) if rows else "None"
         return f"Rows selected: {selected}"
 

components/outputs/datatable/app-variation-select-rows-express.py

@@ -9,7 +9,7 @@
 
 @render.ui
 def rows():
-    rows = penguins_df.input_cell_selection()["rows"]  # <<
+    rows = penguins_df.cell_selection()["rows"]  # <<
     selected = ", ".join(str(i) for i in sorted(rows)) if rows else "None"
     return f"Rows selected: {selected}"
 

components/outputs/datatable/index.qmd

@@ -47,7 +47,7 @@ listing:
   - title: Select Rows
     description: Set `selection_mode` in `render.DataTable()` to `"row"` to allow
       the user to select one row at a time. Set it to `"rows"` to allow the user to
-      select multiple rows at a time. Access the selection(s) as `<id>.input_cell_selection()["rows"]`.
+      select multiple rows at a time. Access the selection(s) as `<id>.cell_selection()["rows"]`.
     apps:
     - title: Preview
       file: app-variation-select-rows-core.py
@@ -130,9 +130,9 @@ To make a reactive Data Table, follow three steps:
 
 A Data Table can also collect input from the user. To allow this, set `render.DataTable(selection_mode="row")` or `render.DataTable(selection_mode="rows")` to allow the user to select one or more rows of the Data Table.
 
-The indices of the selected rows will be accessible within the server function as a reactive variable returned by `<name>.input_cell_selection()["rows"]`, where <name> is the name of the function decorated with `@render.data_frame`.
+The indices of the selected rows will be accessible within the server function as a reactive variable returned by `<name>.cell_selection()["rows"]`, where <name> is the name of the function decorated with `@render.data_frame`.
 
-The value returned will be an empty tuple if no rows are selected, or a tuple of integers representing the indices of the selected rows. To filter a pandas data frame down to the selected rows, use `df.iloc[list(<name>.input_cell_selection()["rows"])]`.
+The value returned will be an empty tuple if no rows are selected, or a tuple of integers representing the indices of the selected rows. To filter a pandas data frame down to the selected rows, use `df.iloc[list(<name>.cell_selection()["rows"])]`.
 
 For more information about interacting with data frames, see the API documentation for [Express](../../../api/express/express.render.data_frame.qmd) or [Core](../../../api/core/render.data_frame.qmd) syntax.
 

docs/overview.qmd

@@ -539,7 +539,7 @@ shiny create -t dashboard
 ## Development workflow
 
 See the [workflow](install-create-run.qmd) section for more information developing Shiny apps locally.
-Also keep in mind you can develop apps in the browser using the [playground](/playground).
+Also keep in mind you can develop apps in the browser using the [playground](https://shinylive.io/py/examples/).
 :::