Skip to content

forcedotcom/sf-skills / skills/design-systems-slds-apply

design-systems-slds-apply

Unverified

Apply SLDS-compliant UI using the correct blueprints, styling hooks, utility classes, and icons. Use when building any UI that needs SLDS, choosing between Lightning Base Components and SLDS Blueprints, applying styling hooks for theming, using utility classes for layout and spacing, or selecting icons. Triggers include "build a modal", "create a form", "data table", "SLDS styling", "style with hooks", "add an icon".

FileKindSize
SKILL.mdskill md14.6 KB
assets/README.mdmarkdown2.3 KB
assets/blueprints/components/accordion.yamlconfig15.0 KB
assets/blueprints/components/activity-timeline.yamlconfig3.8 KB
assets/blueprints/components/alert.yamlconfig4.4 KB
assets/blueprints/components/app-launcher.yamlconfig3.8 KB
assets/blueprints/components/avatar-group.yamlconfig3.2 KB
assets/blueprints/components/avatar.yamlconfig3.5 KB
assets/blueprints/components/badges.yamlconfig3.3 KB
assets/blueprints/components/brand-band.yamlconfig12.9 KB
assets/blueprints/components/breadcrumbs.yamlconfig4.0 KB
assets/blueprints/components/builder-header.yamlconfig10.1 KB
assets/blueprints/components/button-groups.yamlconfig3.1 KB
assets/blueprints/components/button-icons.yamlconfig12.9 KB
assets/blueprints/components/buttons.yamlconfig9.4 KB
assets/blueprints/components/cards.yamlconfig4.6 KB
assets/blueprints/components/carousel.yamlconfig6.0 KB
assets/blueprints/components/chat.yamlconfig9.7 KB
assets/blueprints/components/checkbox-button-group.yamlconfig8.3 KB
assets/blueprints/components/checkbox-button.yamlconfig13.8 KB
assets/blueprints/components/checkbox-toggle.yamlconfig7.7 KB
assets/blueprints/components/checkbox.yamlconfig4.4 KB
assets/blueprints/components/color-picker.yamlconfig8.5 KB
assets/blueprints/components/combobox.yamlconfig5.5 KB
assets/blueprints/components/counter.yamlconfig6.6 KB
assets/blueprints/components/data-tables.yamlconfig6.0 KB
assets/blueprints/components/datepickers.yamlconfig6.1 KB
assets/blueprints/components/datetime-picker.yamlconfig7.4 KB
assets/blueprints/components/docked-composer.yamlconfig13.3 KB
assets/blueprints/components/docked-form-footer.yamlconfig6.1 KB
assets/blueprints/components/docked-utility-bar.yamlconfig10.9 KB
assets/blueprints/components/drop-zone.yamlconfig4.5 KB
assets/blueprints/components/dueling-picklist.yamlconfig8.8 KB
assets/blueprints/components/dynamic-icons.yamlconfig5.0 KB
assets/blueprints/components/dynamic-menu.yamlconfig7.7 KB
assets/blueprints/components/expandable-section.yamlconfig4.6 KB
assets/blueprints/components/expression.yamlconfig7.3 KB
assets/blueprints/components/feeds.yamlconfig5.7 KB
assets/blueprints/components/file-selector.yamlconfig6.8 KB
assets/blueprints/components/files.yamlconfig4.8 KB
assets/blueprints/components/form-element.yamlconfig6.1 KB
assets/blueprints/components/global-header.yamlconfig4.7 KB
assets/blueprints/components/global-navigation.yamlconfig4.3 KB
assets/blueprints/components/icons.yamlconfig5.1 KB
assets/blueprints/components/illustration.yamlconfig8.5 KB
assets/blueprints/components/input.yamlconfig5.4 KB
assets/blueprints/components/list-builder.yamlconfig6.2 KB
assets/blueprints/components/lookups.yamlconfig5.8 KB
assets/blueprints/components/map.yamlconfig5.0 KB
assets/blueprints/components/menus.yamlconfig5.5 KB
assets/blueprints/components/modals.yamlconfig6.1 KB
assets/blueprints/components/notifications.yamlconfig3.1 KB
assets/blueprints/components/page-headers.yamlconfig6.0 KB
assets/blueprints/components/panels.yamlconfig6.8 KB
assets/blueprints/components/path.yamlconfig6.4 KB
assets/blueprints/components/picklist.yamlconfig5.2 KB
assets/blueprints/components/pills.yamlconfig5.9 KB
assets/blueprints/components/popovers.yamlconfig4.6 KB
assets/blueprints/components/progress-bar.yamlconfig4.4 KB
assets/blueprints/components/progress-indicator.yamlconfig5.6 KB
assets/blueprints/components/progress-ring.yamlconfig4.0 KB
assets/blueprints/components/prompt.yamlconfig5.5 KB
assets/blueprints/components/publishers.yamlconfig7.0 KB
assets/blueprints/components/radio-button-group.yamlconfig7.3 KB
assets/blueprints/components/radio-group.yamlconfig5.0 KB
assets/blueprints/components/rich-text-editor.yamlconfig6.0 KB
assets/blueprints/components/scoped-notifications.yamlconfig7.6 KB
assets/blueprints/components/scoped-tabs.yamlconfig3.7 KB
assets/blueprints/components/select.yamlconfig4.3 KB
assets/blueprints/components/setup-assistant.yamlconfig8.8 KB
assets/blueprints/components/slider.yamlconfig4.2 KB
assets/blueprints/components/spinners.yamlconfig5.4 KB
assets/blueprints/components/split-view.yamlconfig4.4 KB
assets/blueprints/components/summary-detail.yamlconfig4.1 KB
assets/blueprints/components/tabs.yamlconfig6.1 KB
assets/blueprints/components/textarea.yamlconfig4.6 KB
assets/blueprints/components/tiles.yamlconfig4.0 KB
assets/blueprints/components/timepicker.yamlconfig5.1 KB
assets/blueprints/components/toast.yamlconfig6.5 KB
assets/blueprints/components/tooltips.yamlconfig4.1 KB
assets/blueprints/components/tree-grid.yamlconfig4.9 KB
assets/blueprints/components/trees.yamlconfig4.8 KB
assets/blueprints/components/trial-bar.yamlconfig4.2 KB
assets/blueprints/components/vertical-navigation.yamlconfig5.2 KB
assets/blueprints/components/vertical-tabs.yamlconfig6.9 KB
assets/blueprints/components/visual-picker.yamlconfig6.8 KB
assets/blueprints/components/welcome-mat.yamlconfig5.5 KB
assets/hooks-index.jsonconfig141.1 KB
assets/icon-metadata.jsonconfig919.3 KB
assets/utilities-index.jsonconfig508.6 KB
references/README.mdmarkdown5.8 KB
references/blueprints-index.mdmarkdown9.0 KB
references/checklists.mdmarkdown3.8 KB
references/component-selection.mdmarkdown3.7 KB
references/examples.mdmarkdown8.1 KB
references/icons-decision-guide.mdmarkdown3.8 KB
references/icons-guidance.mdmarkdown6.2 KB
references/overviews/borders.mdmarkdown11.0 KB
references/overviews/color.mdmarkdown12.0 KB
references/overviews/display-density.mdmarkdown18.7 KB
references/overviews/icons.mdmarkdown9.3 KB
references/overviews/illustrations.mdmarkdown10.3 KB
references/overviews/shadows.mdmarkdown7.0 KB
references/overviews/spacing.mdmarkdown9.8 KB
references/overviews/typography.mdmarkdown14.8 KB
references/overviews/utilities.mdmarkdown23.9 KB
references/slds-development-guide.mdmarkdown8.8 KB
references/styling-decision-guide.mdmarkdown9.3 KB
references/styling-hooks/borders.mdmarkdown9.0 KB
references/styling-hooks/color/expressive-palette-hooks.mdmarkdown6.7 KB
references/styling-hooks/color/index.mdmarkdown6.5 KB
references/styling-hooks/color/semantic/accent-hooks.mdmarkdown9.9 KB
references/styling-hooks/color/semantic/feedback-hooks.mdmarkdown33.4 KB
references/styling-hooks/color/semantic/surface-hooks.mdmarkdown17.1 KB
references/styling-hooks/color/system-hooks.mdmarkdown5.8 KB
references/styling-hooks/index.mdmarkdown10.8 KB
references/styling-hooks/shadows.mdmarkdown8.3 KB
references/styling-hooks/spacing.mdmarkdown12.3 KB
references/styling-hooks/typography.mdmarkdown17.8 KB
references/utilities-quick-ref.mdmarkdown3.7 KB
references/utilities/alignment.mdmarkdown3.7 KB
references/utilities/borders.mdmarkdown4.0 KB
references/utilities/box.mdmarkdown4.3 KB
references/utilities/color.mdmarkdown7.7 KB
references/utilities/dark-mode.mdmarkdown3.5 KB
references/utilities/description-list.mdmarkdown5.5 KB
references/utilities/floats.mdmarkdown3.8 KB
references/utilities/grid.mdmarkdown9.7 KB
references/utilities/horizontal-list.mdmarkdown3.7 KB
references/utilities/hyphenation.mdmarkdown2.3 KB
references/utilities/index.mdmarkdown6.6 KB
references/utilities/interactions.mdmarkdown3.1 KB
references/utilities/layout.mdmarkdown3.6 KB
references/utilities/line-clamp.mdmarkdown4.3 KB
references/utilities/margin.mdmarkdown5.2 KB
references/utilities/media-object.mdmarkdown5.3 KB
references/utilities/name-value-list.mdmarkdown4.8 KB
references/utilities/padding.mdmarkdown5.3 KB
references/utilities/position.mdmarkdown5.9 KB
references/utilities/print.mdmarkdown3.0 KB
references/utilities/scrollable.mdmarkdown4.1 KB
references/utilities/sizing.mdmarkdown5.7 KB
references/utilities/themes.mdmarkdown4.0 KB
references/utilities/truncate.mdmarkdown3.7 KB
references/utilities/typography.mdmarkdown4.6 KB
references/utilities/vertical-list.mdmarkdown5.1 KB
references/utilities/visibility.mdmarkdown6.1 KB
scripts/search-blueprints.cjsscript3.6 KB
scripts/search-hooks.cjsscript4.4 KB
scripts/search-icons.cjsscript6.1 KB
scripts/search-utilities.cjsscript5.3 KB

assets/blueprints/components/checkbox-button-group.yaml

View on GitHub
name: "Checkbox Button Group"

description: "A styled checkable input group that communicates if an option(s) are true, false or indeterminate. A set of checkbox buttons wrapped in a fieldset that is also a form element."

category: "Input"

slds_classes:
  root: "slds-checkbox_button-group"
  elements:
    - class: "slds-checkbox_button"
      description: "Individual checkbox button within the group"
      purpose: "Container for each checkbox option in the button group"
    - class: "slds-checkbox_faux"
      description: "Visual checkbox replacement styled as a button"
      purpose: "Custom-styled checkbox appearance that looks like a button"
    - class: "slds-checkbox_button__label"
      description: "Label element for the checkbox button"
      purpose: "Provides clickable area and contains the checkbox faux element"
  modifiers: []
  states:
    - class: "slds-has-error"
      description: "Error state styling for the form element"
      trigger: "When checkbox group validation fails"
    - class: "slds-is-disabled"
      description: "Disabled state styling"
      trigger: "When checkbox group is not interactive"

variants:
  - name: "Base"
    description: "Standard checkbox button group"
    classes: ["slds-checkbox_button-group"]
    usage_context: "Default checkbox button group implementation"
    differences: "Group of checkbox buttons with shared border and styling"

lightning_component:
  name: ""
  url: "https://developer.salesforce.com/docs/component-library/overview/components"
  mapping_notes: "No direct Lightning Base Component - use checkbox-button components in a group"

accessibility:
  keyboard_support:
    - "Tab to navigate between checkbox buttons"
    - "Space to toggle checkbox state"
    - "Arrow keys may navigate between options in some implementations"
  screen_reader:
    - "Fieldset legend announced as group label"
    - "Checkbox state announced (checked/unchecked)"
    - "Label text read with each checkbox"
    - "Error messages associated and announced"
  aria_attributes:
    - "aria-describedby for error messages"
    - "aria-invalid when validation fails"
    - "aria-required for required checkbox groups"
    - "fieldset and legend for group semantics"

usage_guidelines:
  when_to_use:
    - "When users need to select multiple options from a related set"
    - "For compact selection interfaces where button styling is preferred"
    - "When options are closely related and benefit from visual grouping"
    - "For scheduling, filtering, or multi-select scenarios"
  when_not_to_use:
    - "For mutually exclusive options (use radio button group instead)"
    - "When only one option can be selected"
    - "For simple binary choices (use single checkbox)"
    - "When space is very limited (consider dropdown instead)"
  best_practices:
    - "Use clear, descriptive legend text for the group"
    - "Keep option labels short and concise"
    - "Group related options logically"
    - "Provide immediate visual feedback for selections"
    - "Ensure adequate touch target size for mobile"
    - "Use error states to indicate validation issues"
  common_mistakes:
    - "Using checkbox button group for mutually exclusive options"
    - "Making labels too long or unclear"
    - "Not providing proper fieldset/legend structure"
    - "Missing error state handling"
    - "Inadequate spacing between buttons"

code_examples:
  - title: "Basic Checkbox Button Group"
    code: |
      <fieldset class="slds-form-element">
        <legend class="slds-form-element__legend slds-form-element__label">
          Scheduled Day(s)
        </legend>
        <div class="slds-form-element__control">
          <div class="slds-checkbox_button-group">
            <span class="slds-button slds-checkbox_button">
              <input type="checkbox" name="checkbox" id="checkbox-monday" value="monday" />
              <label class="slds-checkbox_button__label" for="checkbox-monday">
                <span class="slds-checkbox_faux">Monday</span>
              </label>
            </span>
            <span class="slds-button slds-checkbox_button">
              <input type="checkbox" name="checkbox" id="checkbox-tuesday" value="tuesday" />
              <label class="slds-checkbox_button__label" for="checkbox-tuesday">
                <span class="slds-checkbox_faux">Tuesday</span>
              </label>
            </span>
            <span class="slds-button slds-checkbox_button">
              <input type="checkbox" name="checkbox" id="checkbox-wednesday" value="wednesday" />
              <label class="slds-checkbox_button__label" for="checkbox-wednesday">
                <span class="slds-checkbox_faux">Wednesday</span>
              </label>
            </span>
          </div>
        </div>
      </fieldset>
    description: "Basic checkbox button group with three day options"
  - title: "Checkbox Button Group with Error State"
    code: |
      <fieldset class="slds-form-element slds-has-error">
        <legend class="slds-form-element__legend slds-form-element__label">
          Select at least one option
        </legend>
        <div class="slds-form-element__control">
          <div class="slds-checkbox_button-group">
            <span class="slds-button slds-checkbox_button">
              <input type="checkbox" name="checkbox" id="checkbox-error-1" value="option1" aria-describedby="checkbox-error-message" />
              <label class="slds-checkbox_button__label" for="checkbox-error-1">
                <span class="slds-checkbox_faux">Option 1</span>
              </label>
            </span>
            <span class="slds-button slds-checkbox_button">
              <input type="checkbox" name="checkbox" id="checkbox-error-2" value="option2" />
              <label class="slds-checkbox_button__label" for="checkbox-error-2">
                <span class="slds-checkbox_faux">Option 2</span>
              </label>
            </span>
          </div>
        </div>
        <div id="checkbox-error-message" class="slds-form-element__help">This field is required</div>
      </fieldset>
    description: "Checkbox button group with error state and validation message"
  - title: "Disabled Checkbox Button Group"
    code: |
      <fieldset class="slds-form-element">
        <legend class="slds-form-element__legend slds-form-element__label">
          Disabled Options
        </legend>
        <div class="slds-form-element__control">
          <div class="slds-checkbox_button-group">
            <span class="slds-button slds-checkbox_button">
              <input type="checkbox" name="checkbox" id="checkbox-disabled-1" value="option1" disabled />
              <label class="slds-checkbox_button__label" for="checkbox-disabled-1">
                <span class="slds-checkbox_faux">Disabled Option 1</span>
              </label>
            </span>
            <span class="slds-button slds-checkbox_button">
              <input type="checkbox" name="checkbox" id="checkbox-disabled-2" value="option2" disabled checked />
              <label class="slds-checkbox_button__label" for="checkbox-disabled-2">
                <span class="slds-checkbox_faux">Disabled Option 2 (Checked)</span>
              </label>
            </span>
          </div>
        </div>
      </fieldset>
    description: "Checkbox button group with disabled state options"

styling_hooks: []

dependencies:
  css_files: ["checkbox-button-group.css", "form-element.css", "checkbox-button.css"]
  javascript: []
  icons: []
  other_components: ["form-element", "checkbox-button"]

related_components:
  - name: "Checkbox Button"
    relationship: "similar"
    description: "Individual checkbox buttons that make up the group"
  - name: "Radio Button Group"
    relationship: "alternative"
    description: "For mutually exclusive options"
  - name: "Checkbox"
    relationship: "similar"
    description: "Standard checkbox input for single selections"

references:
  official_docs: "https://v1.lightningdesignsystem.com/components/checkbox-button-group/"
  design_guidelines: "https://v1.lightningdesignsystem.com/components/checkbox-button-group/"
metadata:
  version: "1.0.0"
  last_updated: "2025-01-15"
  author: "SLDS Documentation Team"
  slds_version: "2.27.2"
  review_status: "complete"
  source: "official-slds"
  notes: "Created from official SLDS documentation and design-system-internal source code with CSS selector annotations"

brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall