On this page

WidgetBox#

Download this notebook from GitHub (right-click to download).


import panel as pn
pn.extension()

The WidgetBox layout allows arranging multiple panel objects in a vertical container. It is largely identical to the Column layout but has some default styling that makes widgets be clearly grouped together visually. It has a list-like API with methods to append, extend, clear, insert, pop, remove and __setitem__, which make it possible to interactively update and modify the layout.

Parameters:#

For layout and styling related parameters see the customization user guide.

  • objects (list): The list of objects to display in the WidgetBox. Should not generally be modified directly except when replaced in its entirety.

  • disabled (boolean, default=False): Allow to disable all the widgets displayed in the WidgetBox.


A WidgetBox layout can either be instantiated as empty and populated after the fact or using a list of objects provided as positional arguments. If the objects are not already panel components they will each be converted to one using the pn.panel conversion method.

w1 = pn.widgets.TextInput(name='Text:')
w2 = pn.widgets.FloatSlider(name='Slider')

box = pn.WidgetBox('# WidgetBox', w1, w2)
box

In general it is preferred to modify layouts only through the provided methods and avoid modifying the objects parameter directly. The one exception is when replacing the list of objects entirely, otherwise it is recommended to use the methods on the WidgetBox itself to ensure that the rendered views of the WidgetBox are rerendered in response to the change. As a simple example we might add an additional widget to the box using the append method:

w3 = pn.widgets.Select(options=['A', 'B', 'C'])
box.append(w3)

On a live server or in a notebook the box above will dynamically expand in size to accomodate all three widgets and the title. To see the effect in a statically rendered page, we will display the box a second time:

box

In general a WidgetBox does not have to be given a width, height or sizing_mode, allowing it to adapt to the size of its contents.

This web page was generated from a Jupyter notebook and not all interactivity will work on this website. Right click to download and run locally for full Python-backed interactivity.

Download this notebook from GitHub (right-click to download).