yonder (version 0.0.5)

dropdown: Dropdown menus

Description

Dropdown menus are a container for buttons, text, and form inputs. See argument ... for details on composing dropdown menus.

Usage

dropdown(label, ..., direction = "down", align = "left")

Arguments

label

A character string specifying the label of the dropdown's button.

...

Character strings or vectors, header tag elements, button inputs, or form inputs specifying the elements of the dropdown. These elements may be grouped into lists to create a menu with sections. h6() is the recommended heading level for menu headers. Character vectors are converted into paragraphs of text. To format menu text use p() and utility functions.

Additional named arguments are passed as HTML attributes to the parent element.

direction

One of "up", "right", "down", or "left" specifying the direction in which the menu opens, defaults to "down".

align

One of "left" or "right" specifying which side of the button to align the dropdown menu to, defaults to "left".

See Also

Other content: alert, badge, blockquote, card, collapsiblePane, d1, img, jumbotron, modal, navContent, popover, pre, progressOutlet, toast, tooltip

Examples

# NOT RUN {
### Simple options w/ buttons

dropdown(
  label = "Choices",
  buttonInput("choice1", "Choice 1"),
  buttonInput("choice2", "Choice 2"),
  buttonInput("choice3", "Choice 3")
)

### Grouped sections

dropdown(
  label = "Sections",
  list(
    h6("Section 1"),
    buttonInput("addA", "Add A"),
    buttonInput("addB", "Add B")
  ),
  list(
    h6("Section 2"),
    buttonInput("calcC", "Calculate C"),
    buttonInput("calcD", "Calculate D")
  )
)

### Direction variations

div(
  lapply(
    c("up", "down", "left", "right"),
    function(d) {
      dropdown(
        label = d,
        direction = d,
        buttonInput(NULL, "Nam euismod"),
        buttonInput(NULL, "Nunc eleifend"),
        buttonInput(NULL, "Nullam eu")
      ) %>%
        margin(3)
    }
  )
) %>%
  display("flex")

### Include forms

dropdown(
  label = "Sign in",
  formInput(
    id = "login",
    formGroup(
      label = "Email address",
      textInput(
        id = "email",
        placeholder = "[e-mail]"
      )
    ),
    formGroup(
      label = "Password",
      passwordInput(
        id = "password",
        placeholder = "*****"
      )
    ),
    submit = submitInput(
      label = "Sign in"
    )
  ) %>%
    padding(3, 4, 3, 4)
)

# }