express.render.plot
express.render.plot(self,
=None,
_fn*,
=None,
alt=MISSING,
width=MISSING,
height**kwargs,
)
Reactively render a plot object as an HTML image.
Parameters
alt : Optional[str] = None
-
Alternative text for the image if it cannot be displayed or viewed (i.e., the user uses a screen reader).
width : float | None | MISSING_TYPE = MISSING
-
Width of the plot in pixels. If
None
orMISSING
, the width will be determined by the size of the correspondingoutput_plot
. (You should not need to use this argument in most Shiny apps–set the desired width onoutput_plot
instead.) height : float | None | MISSING_TYPE = MISSING
-
Height of the plot in pixels. If
None
orMISSING
, the height will be determined by the size of the correspondingoutput_plot
. (You should not need to use this argument in most Shiny apps–set the desired height onoutput_plot
instead.) ****kwargs** :
object
= {}-
Additional keyword arguments passed to the relevant method for saving the image (e.g., for matplotlib, arguments to
savefig()
; for PIL and plotnine, arguments tosave()
).
Returns
:
-
A decorator for a function that returns any of the following: 1. A
matplotlib.figure.Figure
instance. 2. Anmatplotlib.artist.Artist
instance. 3. A list/tuple of Figure/Artist instances. 4. An object with a ‘figure’ attribute pointing to amatplotlib.figure.Figure
instance. 5. APIL.Image.Image
instance. : It’s also possible to use the
matplotlib.pyplot
interface; in that case, your: function should just call pyplot functions and not return anything. (Note that if
: the decorated function is async, then it’s not safe to use pyplot. Shiny will detect
: this case and throw an error asking you to use matplotlib’s object-oriented
: interface instead.)
Tip
The name of the decorated function (or @output(id=...)
) should match the id
of a output_plot
container (see output_plot
for example usage).
See Also
output_plot
image