calcite_label: Create a Calcite Label Component

In calcite: Bindings to the Calcite Design System 'JavaScript' Component Library

Create a Calcite Label Component

Description

Creates a label component that wraps and provides accessible text for form controls and other interactive elements.

Usage

calcite_label(
  label,
  ...,
  target_id = NULL,
  id = NULL,
  alignment = NULL,
  layout = NULL,
  scale = NULL
)

Arguments

label	The label text (required)
...	Child components to wrap within the label (e.g., calcite_input_text())
target_id	The id of the component this label is bound to (only needed when the labeled component is outside the label). Maps to the for HTML attribute
id	Component ID (optional)
alignment	Specifies the text alignment of the component: "start", "center", or "end" (default: "start")
layout	Defines the layout of the label: "block", "default", "inline", or "inline-space-between" (default: "default"). Note: "default" is deprecated, use "block" instead
scale	Specifies the size of the component: "s" (small), "m" (medium), or "l" (large) (default: "m")

Value

An object of class calcite_component

References

Official Documentation

Examples

# Label wrapping an input
calcite_label(
  label = "Username",
  calcite_input_text(
    id = "username",
    placeholder = "Enter username"
  )
)

# Label with inline layout
calcite_label(
  label = "Subscribe",
  layout = "inline",
  calcite_checkbox(id = "subscribe")
)

# Label with external component (using target_id)
htmltools::tagList(
  calcite_label(
    label = "Password",
    target_id = "password"
  ),
  calcite_input_text(id = "password", placeholder = "Enter password")
)

calcite documentation built on March 3, 2026, 5:07 p.m.