Package 'shinyHierarchy'

Build a hierarchical tree from tabular data

Description

Converts a data frame and an ordered set of columns into a nested hierarchy suitable for the Shiny input component.

Usage

buildHierarchyTree(data, levels)

Arguments

data	A data frame containing the hierarchy columns.
levels	A character vector with column names, ordered from highest to lowest hierarchy level.

Value

A list representing the hierarchy tree.

Examples

data <- data.frame(
  year = c(2026, 2026, 2026),
  month = c("January", "January", "February"),
  day = c(1, 2, 1)
)
buildHierarchyTree(data, c("year", "month", "day"))

---

Hierarchical tree input for Shiny

Description

Creates a hierarchical slicer-style input similar to a Power BI date hierarchy. The input value is a structured object (schema version 1) with resolved, rollup, explicit, and summary fields.

Usage

hierarchyInput(
  inputId,
  label = NULL,
  data,
  levels,
  selected = NULL,
  expanded = NULL,
  placeholder = "Selección múltiple",
  display = c("inline", "dropdown"),
  search = FALSE,
  searchPlaceholder = "Buscar...",
  selectAll = TRUE,
  selectAllLabel = "Seleccionar todo",
  expand = c("first", "all", "none"),
  width = "100%",
  height = "360px"
)

Arguments

inputId	The input slot that will be used to access the value.
label	Optional label displayed above the component.
data	A data frame containing the hierarchy columns.
levels	Character vector with column names, ordered from highest to lowest hierarchy level.
selected	Optional character vector of node ids to select initially.
expanded	Optional character vector of node ids to expand initially.
placeholder	Text shown when nothing is selected.
display	Visual presentation: "inline" keeps the tree visible, while "dropdown" opens it in a floating panel.
search	Whether to show a search box above the tree.
searchPlaceholder	Placeholder for the search field.
selectAll	Whether to show the select-all row.
selectAllLabel	Label for the select-all control.
expand	Initial expansion mode: first level, all levels, or none.
width	CSS width of the component.
height	CSS max-height of the tree area.

Details

The value received from the browser is user-controlled and must not be used as an authorization mechanism. Applications that filter sensitive data must validate selected ids against the server-side hierarchy and permissions.

Value

A Shiny HTML object.

---

Extract path values at a given hierarchy level

Description

Extract path values at a given hierarchy level

Usage

hierarchyPath(value, level_name)

Arguments

value	Value returned by a hierarchy input (input$...).
level_name	Name of the hierarchy level column.

Value

A character vector of unique values at that level among resolved selections.

---

Extract resolved leaf selections from a hierarchy input value

Description

Extract resolved leaf selections from a hierarchy input value

Usage

hierarchyResolved(value)

Arguments

value

Value returned by a hierarchy input (input$...).

Value

A list of resolved node records, or an empty list.

---

Extract rollup selections from a hierarchy input value

Description

Extract rollup selections from a hierarchy input value

Usage

hierarchyRollup(value)

Arguments

value

Value returned by a hierarchy input (input$...).

Value

A list of rollup node records, or an empty list.

---

Update a hierarchical input from the server

Description

Update a hierarchical input from the server

Usage

updateHierarchyInput(
  session = shiny::getDefaultReactiveDomain(),
  inputId,
  data = NULL,
  levels = NULL,
  selected = NULL,
  expanded = NULL,
  clear = FALSE,
  open = NULL
)

Arguments

session	Shiny session object.
inputId	The input id to update.
data	Optional new data frame.
levels	Optional hierarchy column names (required if data is set).
selected	Optional vector of node ids to select (cascades to descendants).
expanded	Optional vector of node ids to expand.
clear	If TRUE, clears the current selection.
open	If TRUE or FALSE, opens or closes the dropdown panel.

Value

No useful return value, invisibly NULL.

---