diff --git a/plugins/plotly-express/docs/sidebar.json b/plugins/plotly-express/docs/sidebar.json index 3278c9613..07b602781 100644 --- a/plugins/plotly-express/docs/sidebar.json +++ b/plugins/plotly-express/docs/sidebar.json @@ -16,6 +16,7 @@ }, { "label": "Plot Types", + "expanded": true, "items": [ { "label": "Area", @@ -117,6 +118,7 @@ }, { "label": "Concepts", + "expanded": true, "items": [ { "label": "Plot by", diff --git a/plugins/ui/docs/components/flex.md b/plugins/ui/docs/components/flex.md index e61099943..1a2342d4e 100644 --- a/plugins/ui/docs/components/flex.md +++ b/plugins/ui/docs/components/flex.md @@ -1,6 +1,10 @@ # Flex + A [flexbox](https://developer.mozilla.org/en-US/docs/Learn/CSS/CSS_layout/Flexbox)-based layout container that utilizes dimension values and supports the gap property for consistent spacing between items. +> [!TIP] +> The `flex` component follows the same rules as a browser flexbox layout. A good game for understanding flexbox is [Flexbox Froggy](https://flexboxfroggy.com/). + ## Example ```python @@ -24,6 +28,7 @@ my_flex = ui_flex() The `direction` prop determines the direction in which the flex items are laid out. Options: + - `row` (default): the flex items are arranged horizontally from left to right. - `column`: the flex items are arranged vertically from top to bottom. - `row-reverse`: the flex items are arranged horizontally from right to left. @@ -98,7 +103,6 @@ def ui_flex_nesting(): my_flex_nesting = ui_flex_nesting() ``` - ## Wrapping When enabled, items that overflow wrap into the next row. Resize your browser window to see the items reflow. @@ -124,12 +128,12 @@ def ui_flex_wrap(): my_flex_wrap = ui_flex_wrap() ``` - ## Justification The `justify_content` prop is used to align items along the main axis. When the direction is set to "column", it controls the vertical alignment, and when the direction is set to "row", it controls the horizontal alignment. Options: + - `stretch` (default): the flex items are stretched to fill the container along the cross-axis. - `start`: the flex items are aligned at the start of the cross-axis. - `end`: the flex items are aligned at the end of the cross-axis. @@ -200,12 +204,12 @@ def ui_flex_justify(): my_flex_justify = ui_flex_justify() ``` - ## Alignment The `align_items` prop aligns items along the cross-axis. When the direction is set to "column", it controls horizontal alignment, and when it is set to "row", it controls vertical alignment. Options: + - `stretch` (default): the flex items are stretched to fill the container along the cross-axis. - `start`: the flex items are aligned at the start of the cross-axis. - `end`: the flex items are aligned at the end of the cross-axis. @@ -254,7 +258,6 @@ def ui_flex_align_vertical(): my_flex_align_vertical = ui_flex_align_vertical() ``` - ```python from deephaven import ui @@ -289,9 +292,8 @@ def ui_flex_align_horizontal(): my_flex_align_horizontal = ui_flex_align_horizontal() ``` - ## API reference ```{eval-rst} .. dhautofunction:: deephaven.ui.flex -``` \ No newline at end of file +``` diff --git a/plugins/ui/docs/sidebar.json b/plugins/ui/docs/sidebar.json index 85cd16769..6e3966dc0 100644 --- a/plugins/ui/docs/sidebar.json +++ b/plugins/ui/docs/sidebar.json @@ -24,6 +24,7 @@ }, { "label": "Describing the UI", + "expanded": true, "items": [ { "label": "Your First Component",