ui.page_auto
ui.page_auto(*args,
=MISSING,
title=MISSING,
window_title=MISSING,
lang=MISSING,
theme=MISSING,
fillable=False,
full_width=None,
page_fn**kwargs,
)
A page container which automatically decides which page function to use.
If there is a top-level nav_panel, page_auto will use page_navbar. Otherwise, if there is a top-level sidebar, page_sidebar is used.
If there are neither top-level nav panels nor sidebars, this will use the fillable
and full_width
arguments to determine which page function to use:
- If
fillable
isTrue
, page_fillable is used. - Otherwise, if
full_width
isTrue
, page_fluid is used. - If neither are
True
, page_fixed is used.
Parameters
*args : TagChild | TagAttrs = ()
-
UI elements. These are used to determine which page function to use, and they are also passed along to that page function.
title : str | MISSING_TYPE = MISSING
-
A title shown on the page.
window_title : str | MISSING_TYPE = MISSING
-
The browser window title. If no value is provided, this will use the value of
title
. lang : str | MISSING_TYPE = MISSING
-
ISO 639-1 language code for the HTML page, such as
"en"
or"ko"
. This will be used as the lang in the<html>
tag, as in<html lang="en">
. The default,None
, results in an empty string. theme : str | Path |
Theme
|ThemeProvider
| MISSING_TYPE = MISSING-
A custom Shiny theme created using the Theme class, or a path to a local or online CSS file that will replace the Bootstrap CSS bundled by default with a Shiny app. This file should be a complete
bootstrap.css
orbootstrap.min.css
file. For advanced uses, you can also pass a Tagifiable object. In this case, Shiny will suppress the default Bootstrap CSS. To modify the theme of an app without replacing the Bootstrap CSS entirely, use include_css to add custom CSS. fillable : bool | MISSING_TYPE = MISSING
-
If there is a top-level sidebar or nav, then the value is passed through to the page_sidebar or page_navbar function. Otherwise, if
True
, use page_fillable, where the content fills the window; ifFalse
(the default), the value offull_width
will determine which page function is used. full_width : bool = False
-
This has an effect only if there are no sidebars or top-level navs, and
fillable
isFalse
. If this isFalse
(the default), use use page_fixed; ifTrue
, use page_fillable. page_fn : Callable[…, Tag] | None = None
-
The page function to use. If
None
(the default), will automatically choose one based on the arguments provided. If notNone
, this will override all heuristics for choosing page functions. ****kwargs** :
object
= {}-
Additional arguments, which are passed to the page function.
Returns
: Tag
-
A UI element.