Le corps

Créer des tableaux de bord avec shinydashboard

Png Kee Seng

Researcher

Aperçu

L'essentiel de l'UI shinydashboard
En général, on y place les entrées et les sorties
- Comme les plats et commandes dans un restaurant
- Le serveur gère la communication
Défini par dashboardBody() et stocké par convention dans body

body <- dashboardBody(...)

Wireframing

Faire un wireframe
- Poser la structure avant d'ajouter le contenu
Dans un shinydashboard, décider d'abord des positions des objets

Le wireframe d'un zeppelin.

¹ Brett Jordan, Flickr

Ajouter des lignes et des boîtes : boîtes vides

Ajouter des lignes avec fluidRow()
Et des boîtes avec box()

Tableau de bord avec deux lignes, chacune avec deux boîtes vides.

body <- dashboardBody(

  fluidRow(

           box("Row 1, box 1"), 
           box("Row 1, box 2")

           ),
  fluidRow(

           box("Row 2, box 1"), 
           box("Row 2, box 2")

           )

)

Ajouter des lignes et des boîtes : contenu dans les boîtes

Corps avec quatre boîtes et du contenu dans certaines.

body <- dashboardBody(
  fluidRow(box("Row 1, box 1", 

               plotOutput('plot')),

           box("Row 1, box 2")),
  fluidRow(box("Row 2, box 1"), 
           box("Row 2, box 2", 

               selectInput("select", 
                           "Select team number:", 
                           choices = c(1,2))))

)

Éviter le dépassement des boîtes

Par défaut, chaque boîte occupe 6 des 12 unités horizontales
Pour éviter le dépassement, définir width
- Ici : largeurs 3, 5 et 4
Multiplier les box() est vivement recommandé

Plus de boîtes dans le corps

body <- dashboardBody(
  fluidRow(box("Row 1, box 1"), 
           box("Row 1, box 2"),
           box("Row 1, box 3")),
  fluidRow(box("Row 2, box 1"), 
           box("Row 2, box 2"))
)

body <- dashboardBody(
  fluidRow(box("Row 1, box 1", width = 3), 
           box("Row 1, box 2", width = 5),
           box("Row 1, box 3", width = 4)),
  fluidRow(box("Row 2, box 1"), 
           box("Row 2, box 2"))
)

valueBox et infoBox

Il existe aussi des boîtes pour de petites infos
- valueBox()
- infoBox()

valueBox et infoBox dans le corps.

body <- dashboardBody(
  fluidRow(valueBox(value = 3, 
                    subtitle = "Nb total de cartons rouges", 
                    icon = icon("user"),
                    color = "red"),

           infoBox(value = 158, 
                   title = "Nb total de buts marqués", 
                   icon = icon("futbol"))
           ))

valueBoxOutput et infoBoxOutput

Variantes de valueBox() et infoBox() : valueBoxOutput() et infoBoxOutput()
Ce sont des fonctions de sortie
Il existe aussi renderValueBox() et renderInfoBox()
valueBox() et infoBox() sont requis

valueBoxOutput et infoBoxOutput dans le corps. Le rendu est identique au précédent.

body <- dashboardBody(
  fluidRow(valueBoxOutput(outputId = "valuebox1"),
           infoBoxOutput(outputId = "infobox1")
           ))

server <- function(input, output){
  output$valuebox1 <- renderValueBox(
    valueBox(3, "Nb total de cartons rouges",
                icon = icon("user"), color = "red"))
  output$infobox1 <- renderInfoBox(
    infoBox(158, 
                   title = "Nb total de buts marqués", 
                   icon = icon("futbol")))
}

Analogie entre valueBoxOutput et plotOutput

plotOutput() :
- Placé dans l'UI
- Détermine sa position dans le shinydashboard
renderPlot() :
- Placé dans server()
- Contient un objet ggplot()

valueBoxOutput() :
- Placé dans l'UI
- Détermine sa position dans le shinydashboard
renderValueBox() :
- Placé dans server()
- Contient un objet valueBox()

Lier la barre latérale et le corps

Rappelez‑vous : une barre latérale avec deux boutons « charts » et « statistics »
Pour les lier au corps, ajouter tabItems()
- Chaque page est définie par un tabItem()
- Les libellés de chaque paire menuItem()‑tabItem() doivent correspondre

Le corps et la barre latérale sont maintenant liés

sidebar <- dashboardSidebar(
  sidebarMenu(
    id = "pages",

    menuItem("Many charts", tabName = "charts", 
             icon = icon("chart-line"),
             badgeLabel = "New content!", badgeColor = "green"),

    menuItem("Statistics", icon = icon("file-excel"), 
             tabName = "statistics", 
             badgeLabel = "urgent", badgeColor = "red")
 ))

body <- dashboardBody(
  tabItems(

    tabItem("charts",
      "Charts go here."
    ),
    tabItem("statistics",
      "Statistics go here."
)))

Onglets dans le corps

Dans une shinyApp, un ensemble d'onglets peut aussi être défini avec tabsetPanel()
- Chaque onglet est défini par tabPanel()
À ne pas confondre avec tabItems() et tabItem()

Ajout de jeux d'onglets dans le corps

body <- dashboardBody(tabsetPanel(

    tabPanel("Distributions", 
             box(plotOutput("dist"))),
    tabPanel("Statistics", 
             dateInput("matchdate", 
                       "Enter the match date:", 
                       value = "2022-11-20"),
             valueBoxOutput("red"), 
             valueBoxOutput("yellow")),
    tabPanel("Data", "Data goes here.", 
             tableOutput("data"))

))

server <- function(input, output){
  output$red <- renderValueBox(valueBox(0, "Red cards"))
  output$yellow <- renderValueBox(valueBox(6, "Yellow cards"))
}

Passons à la pratique !

Créer des tableaux de bord avec shinydashboard