-eXZdZddlmZddlZejeZddlmZm Z m Z ddl m Z m Z mZmZmZmZmZddlmZmZddlmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$dd l%m&Z&dd l'm(Z(m)Z)m*Z*dd l+m,Z,m-Z-dd l.m/Z/m0Z0m1Z1dd l2m3Z3m4Z4m5Z5m6Z6m7Z7ddl8m9Z9ddl:m;Z;ddleGdde=Z?Gdde?Z@eGddeZAGdde?eAZBGdde?ZCGdde?ZDeGdd e?ZEGd!d"eEZFGd#d$eEZGGd%d&e9ZHGd'd(e?ZIGd)d*e?ZJGd+d,e?ZKdS)-z& Various kinds of layout components. ) annotationsN)RGBColor ColorLike)Align DimensionsFlowModeLocationScrollbarPolicy SizingMode SizingPolicy)HasPropsabstract)AutoBoolEitherEnumFloatInstanceIntList NonNegativeNullNullableStringStructTuple)Optional) GridSpacingPixels TracksSizing)errorwarning)MIN_PREFERRED_MAX_HEIGHTMIN_PREFERRED_MAX_WIDTHREPEATED_LAYOUT_CHILD)BOTH_CHILD_AND_ROOT EMPTY_LAYOUTFIXED_HEIGHT_POLICYFIXED_SIZING_MODEFIXED_WIDTH_POLICY)Model)Menu) UIElement) ColumnFlexBoxGridBoxGroupBoxHBox LayoutDOMRow ScrollBoxSpacerTabPanelTabsVBoxc 6eZdZUdZd'fd ZeddZeee dZ d e d <eee d Z d e d <eee d Z eee dZeee dZeee dZeee ee e ee e e e dZeeeeddZeeeeddZeeeedZeeddZeeedZeeee eee ee ddZ!ee"e#ddZ$eeee%ddZ&d(d Z'e(de'Z)e*e+d!Z,e*e-d"Z.e*e/d#Z0e1e2d$Z3e1e4d%Z5d)d&Z6xZ7S)*r6z0 The base class for layoutable components. returnNonec:tj|i|dSNsuper__init__selfargskwargs __class__s 4lib/python3.11/site-packages/bokeh/models/layouts.pyrDzLayoutDOM.__init__`%$)&)))))Fz Whether the widget will be disabled when rendered. If ``True``, the widget will be greyed-out and not responsive to UI events. helpz The width of the component (in pixels). This can be either fixed or preferred width, depending on width sizing policy. int | Nonewidthz The height of the component (in pixels). This can be either fixed or preferred height, depending on height sizing policy. heightzL Minimal width of the component (in pixels) if width is adjustable. zN Minimal height of the component (in pixels) if height is adjustable. zL Maximal width of the component (in pixels) if width is adjustable. zN Maximal height of the component (in pixels) if height is adjustable. a Allows to create additional space around the component. The values in the tuple are ordered as follows - Margin-Top, Margin-Right, Margin-Bottom and Margin-Left, similar to CSS standards. Negative margin values may be used to shrink the space from any direction. autoa( Describes how the component should maintain its width. ``"auto"`` Use component's preferred sizing policy. ``"fixed"`` Use exactly ``width`` pixels. Component will overflow if it can't fit in the available horizontal space. ``"fit"`` Use component's preferred width (if set) and allow it to fit into the available horizontal space within the minimum and maximum width bounds (if set). Component's width neither will be aggressively minimized nor maximized. ``"min"`` Use as little horizontal space as possible, not less than the minimum width (if set). The starting point is the preferred width (if set). The width of the component may shrink or grow depending on the parent layout, aspect management and other factors. ``"max"`` Use as much horizontal space as possible, not more than the maximum width (if set). The starting point is the preferred width (if set). The width of the component may shrink or grow depending on the parent layout, aspect management and other factors. .. note:: This is an experimental feature and may change in future. Use it at your own discretion. Prefer using ``sizing_mode`` if this level of control isn't strictly necessary. defaultrNa( Describes how the component should maintain its height. ``"auto"`` Use component's preferred sizing policy. ``"fixed"`` Use exactly ``height`` pixels. Component will overflow if it can't fit in the available vertical space. ``"fit"`` Use component's preferred height (if set) and allow to fit into the available vertical space within the minimum and maximum height bounds (if set). Component's height neither will be aggressively minimized nor maximized. ``"min"`` Use as little vertical space as possible, not less than the minimum height (if set). The starting point is the preferred height (if set). The height of the component may shrink or grow depending on the parent layout, aspect management and other factors. ``"max"`` Use as much vertical space as possible, not more than the maximum height (if set). The starting point is the preferred height (if set). The height of the component may shrink or grow depending on the parent layout, aspect management and other factors. .. note:: This is an experimental feature and may change in future. Use it at your own discretion. Prefer using ``sizing_mode`` if this level of control isn't strictly necessary. a Describes the proportional relationship between component's width and height. This works if any of component's dimensions are flexible in size. If set to a number, ``width / height = aspect_ratio`` relationship will be maintained. Otherwise, if set to ``"auto"``, component's preferred width and height will be used to determine the aspect (if not set, no aspect will be preserved). blockzX Defines whether the layout will flow in the ``block`` or ``inline`` dimension. a How the component should size itself. This is a high-level setting for maintaining width and height of the component. To gain more fine grained control over sizing, use ``width_policy``, ``height_policy`` and ``aspect_ratio`` instead (those take precedence over ``sizing_mode``). Possible scenarios: ``"inherit"`` The sizing mode is inherited from the parent layout. If there is no parent layout (or parent is not a layout), then this value is treated as if no value for ``sizing_mode`` was provided. ``"fixed"`` Component is not responsive. It will retain its original width and height regardless of any subsequent browser window resize events. ``"stretch_width"`` Component will responsively resize to stretch to the available width, without maintaining any aspect ratio. The height of the component depends on the type of the component and may be fixed or fit to component's contents. ``"stretch_height"`` Component will responsively resize to stretch to the available height, without maintaining any aspect ratio. The width of the component depends on the type of the component and may be fixed or fit to component's contents. ``"stretch_both"`` Component is completely responsive, independently in width and height, and will occupy all the available horizontal and vertical space, even if this changes the aspect ratio of the component. ``"scale_width"`` Component will responsively resize to stretch to the available width, while maintaining the original or provided aspect ratio. ``"scale_height"`` Component will responsively resize to stretch to the available height, while maintaining the original or provided aspect ratio. ``"scale_both"`` Component will responsively resize to both the available width and height, while maintaining the original or provided aspect ratio. z The alignment point within the parent container. This property is useful only if this component is a child element of a layout (e.g. a grid). Self alignment can be overridden by the parent container (e.g. grid track align). Na  A menu to display when user right clicks on the component. .. note:: To display a native context menu, the viewer will need to right-click twice. The second click closes the Bokeh context menu and falls back back the native one. zW Whether the layout is interactively resizable, and if so in which dimensions. colorrc4t|tr|}n;t|tr&t j|}t|jtr ||jd<dS||j_dS)z$ Background color of the component. zbackground-colorN) isinstancerto_csstupler from_tuplestylesdictbackground_color)rFrVs rJ_set_backgroundzLayoutDOM._set_backgrounds eU # # 3LLNNEE u % % 3N5))0022E dk4 ( ( 1.3DK* + + ++0DK ( ( (rLcZ|jdkr|j|jt|SdSdSNfixed) sizing_moderPrQstrrFs rJ_check_fixed_sizing_modez"LayoutDOM._check_fixed_sizing_mode,s8  w & &DJ,>$+BUt99  ' &BUBUrLcL|jdkr|jt|SdSdSra) width_policyrPrdres rJ_check_fixed_width_policyz#LayoutDOM._check_fixed_width_policy1s1   ' 'DJ,>t99  ( ',>,>rLcL|jdkr|jt|SdSdSra) height_policyrQrdres rJ_check_fixed_height_policyz$LayoutDOM._check_fixed_height_policy6s1   ( (T[-@t99  ) (-@-@rLc|j|jnd}|j|jn|}|j|jn|}||cxkr|ksnt|SdSNr) min_widthrP max_widthrd)rFrorPrps rJ_min_preferred_max_widthz"LayoutDOM._min_preferred_max_width;sk&*n&@DNNa &*j&@DJJi&*n&@DNNe U////i////t99 0/rLc|j|jnd}|j|jn|}|j|jn|}||cxkr|ksnt|SdSrn) min_heightrQ max_heightrd)rFrsrQrts rJ_min_preferred_max_heightz#LayoutDOM._min_preferred_max_heightDsk(,(CT__ (, (CT[[(,(CT__ f2222 2222t99 32rLc&|jdvr|jSdS)N) stretch_widthrbN)rcrQres rJ_sphinx_height_hintzLayoutDOM._sphinx_height_hintMs  ? ? ?; trLr>r?)rVrr>r?r>rO)8__name__ __module__ __qualname____doc__rDrdisabledrrrrP__annotations__rQrorsrprtrrmarginrrrrhrkrr aspect_ratior flow_moder rcralignrr/ context_menur resizabler_property backgroundr$r+rfr,rir*rlr#r&rqr%rurx __classcell__rIs@rJr6r6Ys8 ******tE!   H !S!1!19   E    "++c"2"2:   F    S))1   I++c**2   JS))1   I++c**2   JXffS%%S//55c33L3LMMU   F6$\ 2 2FJ   L@F4l!3!3VK   M@6$e3   LXw6   I(44 ++-3- - - K^ F4eeeDDKKe&E&Ev]   E8HHTNND@   LtTT*--uD   I 1 1 1 1$00J W   W   !  W !!"! U "##$# U #$$%$rLr6c$eZdZdZdfd ZxZS)r9zK A container for space used to fill an empty spot in a row or column. r>r?c:tj|i|dSrArBrEs rJrDzSpacer.__init__XrKrLry)r{r|r}r~rDrrs@rJr9r9RsG **********rLr9cdeZdZdZeeddZeeddZeddZ dS) GridCommonz* Common properties for grid-like layouts. Na Describes how the grid should maintain its rows' heights. This maps to CSS grid's track sizing options. In particular the following values are allowed: * length, e.g. ``100px``, ``5.5em`` * percentage, e.g. ``33%`` * flex, e.g. 1fr * enums, e.g. ``max-content``, ``min-content``, ``auto``, etc. If a single value is provided, then it applies to all rows. A list of values can be provided to size all rows, or a dictionary providing sizing for individual rows. See https://developer.mozilla.org/en-US/docs/Web/CSS/grid-template-rows or https://w3c.github.io/csswg-drafts/css-grid/#track-sizing for details. rSa Describes how the grid should maintain its columns' widths. This maps to CSS grid's track sizing options. In particular the following values are allowed: * length, e.g. ``100px``, ``5.5em`` * percentage, e.g. ``33%`` * flex, e.g. 1fr * enums, e.g. ``max-content``, ``min-content``, ``auto``, etc. If a single value is provided, then it applies to all columns. A list of values can be provided to size all columns, or a dictionary providing sizing for individual columns. See https://developer.mozilla.org/en-US/docs/Web/CSS/grid-template-columns or https://w3c.github.io/csswg-drafts/css-grid/#track-sizing for details. rz The gap between children (in pixels). Either a number, if spacing is the same for both dimensions, or a pair of numbers indicating spacing in the vertical and horizontal dimensions respectively. ) r{r|r}r~rr"rowscolsr spacingrLrJrr[ss44 8L$6   D& 8L$6   D&k!+   GGGrLrc eZdZdZdfd Zeeeee e e eee e e e e gdZ e e dZxZS) r3z" A CSS grid-based grid container. r>r?c:tj|i|dSrArBrEs rJrDzGridBox.__init__rKrLzV A list of children with their associated position in the grid (row, column). rScd|jD}t|tt|krt|SdS)Ncg|] }|d S)rr.0childs rJ z;GridBox._check_repeated_layout_children..s:::%U1X:::rL)childrenlensetrdrFrs rJ_check_repeated_layout_childrenz'GridBox._check_repeated_layout_childrensJ::4=::: x==CH .. . .t99  / .rLry)r{r|r}r~rDrrrrr0rrr#r'rrrs@rJr3r3s,,******tFF hhy!!3,, hhy!!3S#6688ACK   H  U !!"!rLr3c :eZdZdZdfd Zeeeee e e e gd eeedZ e ed d Zed d Zeed ZxZS)r5z" A CSS grid-based horizontal box. r>r?c:tj|i|dSrArBrEs rJrDz HBox.__init__rKrL)rcolspanzr A list of children with their associated position in the horizontal box (optional; column number, span). rScd|DS)Nc.g|]}t|Srr]rs rJrz!HBox...$=h=h=hUZt%?P?P?P=h=h=hrLrrs rJz HBox.=h=h^f=h=h=hrLNzE Describes how the grid should maintain its columns' widths. r/ The gap between children (in pixels). cd|jD}t|tt|krt|SdS)Ncg|] }|d Srrritems rJrz8HBox._check_repeated_layout_children..;;;tT'];;;rLitemsrrrdrs rJrz$HBox._check_repeated_layout_childrenJ;;tz;;; x==CH .. . .t99  / .rLry)r{r|r}r~rDrrrr0rracceptsrrr"rr!rr#r'rrrs@rJr5r5s#,,******tFF)!4!4((3--hhWZmm\\\fhp   hhy))**,h,h i i  8L$6   DfQ&   G U !!"!rLr5c :eZdZdZdfd Zeeeee e e e gd eeedZ e ed d Zed d Zeed ZxZS)r<z A CSS grid-based vertical box. r>r?c:tj|i|dSrArBrEs rJrDz VBox.__init__rKrL)rrowrzm A list of children with their associated position in the vertical box (optional; row number, span). rScd|DS)Nc.g|]}t|Srrrs rJrz!VBox...rrLrrs rJrz VBox.rrLNzC Describes how the grid should maintain its rows' heights. rrcd|jD}t|tt|krt|SdS)Ncg|] }|d Srrrs rJrz8VBox._check_repeated_layout_children..rrLrrs rJrz$VBox._check_repeated_layout_childrenrrLry)r{r|r}r~rDrrrr0rrrrrr"rr!rr#r'rrrs@rJr<r<s#********tFF)!4!4((3--hhWZmm\\\fhp   hhy))**,h,h i i  8L$6   DfQ&   G U !!"!rLr<ceZdZdZd fd ZeedZeedZ e e dZ e eed Zed d ZxZS)r2zC Abstract base class for Row and Column. Do not use directly. r>r?ct|dkrd|vrtdt|dkrt||d<tjdi|dS)Nrrz;'children' keyword cannot be used with positional argumentsr)r ValueErrorlistrCrDrEs rJrDzFlexBox.__init__sm t99q==Z611Z[[ [ YY]]!%dF: ""6"""""rLcjddlm}t||jst |SdS)Nr)chain) itertoolsrrrrd)rFrs rJ_check_empty_layoutzFlexBox._check_empty_layoutsF######EE$-(()) t99   rLcg}|jD]9}|j0||jjvr"|t |:|rd|SdS)Nz, )rdocumentrootsappendrdjoin)rFproblemscs rJ_check_child_is_also_rootz!FlexBox._check_child_is_also_rootsg ( (Az%!qz/?*?*?A'''  99X&& &4rLct|jtt|jkrt|SdSrA)rrrrdres rJrz'FlexBox._check_repeated_layout_childrens= t}  S%7%7!8!8 8 8t99  9 8rLzj The list of children, which can be other components including plots, rows, columns, and widgets. rMrrrSry)r{r|r}r~rDr$r)rr(rr#r'rrrr0rrrrrs@rJr2r2s###### W\  W !!"! U !!"!tHHY''/   Hc!#   GGGGGrLr2c,eZdZdZdfd ZddZxZS) r7z Lay out child components in a single horizontal row. Children can be specified as positional arguments, as a single argument that is a sequence, or using the ``children`` keyword argument. r>r?c:tj|i|dSrArBrEs rJrDz Row.__init__rKrLrOc~td|jDrdStd|jDS)Nc3BK|]}|duVdSrArxrxs rJ z*Row._sphinx_height_hint.. 3FF1q$$&&$.FFFFFFrLc3>K|]}|VdSrArrs rJrz*Row._sphinx_height_hint...BBq1((**BBBBBBrL)anyrmaxres rJrxzRow._sphinx_height_hint G FF FFF F F 4BBDMBBBBBBrLryrzr{r|r}r~rDrxrrs@rJr7r7c******CCCCCCCCrLr7c,eZdZdZdfd ZddZxZS) r1z Lay out child components in a single vertical row. Children can be specified as positional arguments, as a single argument that is a sequence, or using the ``children`` keyword argument. r>r?c:tj|i|dSrArBrEs rJrDzColumn.__init__rKrLrOc~td|jDrdStd|jDS)Nc3BK|]}|duVdSrArrs rJrz-Column._sphinx_height_hint..rrLc3>K|]}|VdSrArrs rJrz-Column._sphinx_height_hint..rrL)rrsumres rJrxzColumn._sphinx_height_hintrrLryrzrrs@rJr1r1rrLr1ceZdZdZd fd ZeddZeed Z e d d Z e d d Z xZ S)r:z= A single-widget container with title bar and controls. r>r?c:tj|i|dSrArBrEs rJrDzTabPanel.__init__&rKrLz& The text title of the panel. rSz^ The child widget. If you need more children, use a layout widget, e.g. a ``Column``. rMFz Whether this panel is closable or not. If True, an "x" button will appear. Closing a panel is equivalent to removing it from its parent container (e.g. tabs). z8 Whether the widget is responsive to UI events. ry)r{r|r}r~rDrtitlerr0rrclosablerrrs@rJr:r: s ****** F2%   E HY&   EtE!   H tE!   HHHHHrLr:c eZdZdZdfd ZdZeeed ee e ee dZ eed d Zed d ZxZS)r;z+ A panel widget with navigation tabs. r>r?c:tj|i|dSrArBrEs rJrDz Tabs.__init__ArKrLz)examples/interaction/widgets/tab_panes.pyz* The list of child panel widgets. rMcd|DS)Nc6g|]\}}t||S))rr)r:)rrrs rJrz!Tabs...Is*aaaPUU!C!C!CaaarLr)rs rJrz Tabs.IsaaZ_aaarLabovez9 The location of the buttons that activate tabs. rSrz& The index of the active tab. ry)r{r|r}r~rD __example__rrr:rrrr0tabsrr tabs_locationractiverrs@rJr;r;;s ******>K 4""*   eeFHHY$7$78899aa c c D7:   MS   FFFFFrLr;creZdZdZd fd ZeedZee dZ e dd Z xZ S) r4z0 A panel that allows to group UI elements. r>r?c:tj|i|dSrArBrEs rJrDzGroupBox.__init__YrKrLzV The title text of the group. If not provided, only the frame will be showed. rM The child UI element. This can be a single UI control, widget, etc., or a container layout like ``Column`` or ``Row``, or a combitation of layouts. Fz Whether to allow disabling this group (all its children) via a checkbox in the UI. This allows to broadcast ``disabled`` state across multiple UI controls that support that state. ry)r{r|r}r~rDrrrrr0rr checkablerrs@rJr4r4Ss ****** HV#   E HY&   E U"   IIIIIrLr4cveZdZdZd fd ZeedZee dd Z ee dd Z xZ S) r8z= A panel that allows to scroll overflowing UI elements. r>r?c:tj|i|dSrArBrEs rJrDzScrollBox.__init__qrKrLrrMrRz5 The visibility of the horizontal scrollbar. rSz3 The visibility of the vertical scrollbar. ry) r{r|r}r~rDrr0rrr horizontal_scrollbarvertical_scrollbarrrs@rJr8r8ks ****** HY&   E  4G   ovE   rLr8)Lr~ __future__rlogging getLoggerr{logcolorsrrr core.enumsrr r r r r rcore.has_propsrrcore.propertiesrrrrrrrrrrrrrrcore.property.structrcore.property_aliasesr r!r"core.validationr#r$core.validation.errorsr%r&r'core.validation.warningsr(r)r*r+r,modelr-ui.menusr/ ui.ui_elementr0__all__r6r9rr3r5r<r2r7r1r:r;r4r8rrLrJr s#"""""g!!+*********0/////// ,+++++EEEEEEEEEE,,,,,,,,mmmmmmmmmm$$$$$$ & vvvvv vv vp*****Y*** / / / / / / /  / bi&9292 * * * * * i* *  * ZCCCCC'CCC CCCCCWCCC      u   6     9   0     y   0          rL