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/dueling-picklist.yaml

View on GitHub
name: "Dueling Picklist"

description: "A dueling-picklist is used to move options between two lists and is often referred to as a multi-select. Sometimes, the list options can then be re-ordered, depending on the use case."

category: "Input"

slds_classes:
  root: "slds-dueling-list"
  elements:
    - class: "slds-dueling-list__column"
      description: "Column container for each list and button group"
      purpose: "Organizes the two lists and control buttons in a flex layout"
    - class: "slds-dueling-list__options"
      description: "Bounding visual container for listbox of options"
      purpose: "Contains the selectable options list with border and scrollable area"
  modifiers:
    - class: "slds-dueling-list__column_responsive"
      description: "Responsive layout modifier for dueling picklist columns"
      usage: "Applied to columns containing options to make them responsive and flexible"
  states:
    - class: "slds-is-selected"
      description: "Selected state of a listbox option"
      trigger: "When an option is selected (aria-selected='true')"
    - class: "slds-is-grabbed"
      description: "Grabbed state of a listbox option during drag"
      trigger: "When an option is being dragged"
    - class: "slds-is-disabled"
      description: "Disabled state for the entire dueling picklist"
      trigger: "When the component is not interactive"

variants:
  - name: "Base"
    description: "Standard dueling picklist with two lists and move buttons"
    classes: ["slds-dueling-list"]
    usage_context: "Default dueling picklist implementation"
    differences: "Two side-by-side lists with buttons to move items between them"
  - name: "Responsive"
    description: "Responsive dueling picklist that adapts to available space"
    classes: ["slds-dueling-list", "slds-dueling-list__column_responsive"]
    usage_context: "Use in narrow regions or responsive layouts"
    differences: "Columns flex to available space, items truncate with ellipsis"

lightning_component:
  name: ""
  url: "https://developer.salesforce.com/docs/component-library/overview/components"
  mapping_notes: "No direct Lightning Base Component - use custom implementation with SLDS classes"

accessibility:
  keyboard_support:
    - "Tab to navigate between lists and buttons"
    - "Up/Down arrows to move focus and selection within a list"
    - "Shift + Up/Down to extend selection"
    - "Ctrl + Up/Down to move focus without changing selection"
    - "Ctrl + Space to toggle selection on focused option"
    - "Ctrl + A to select all options in a list"
    - "Cmd/Ctrl + Left/Right to move selected items between lists"
    - "Space to toggle Drag and Drop mode"
    - "In Drag mode: Up/Down arrows move selected items within current list"
  screen_reader:
    - "List labels announced via aria-labelledby"
    - "Operation instructions announced via aria-describedby"
    - "Selected state announced for each option"
    - "Drag and drop mode announced"
  aria_attributes:
    - "role='listbox' on each options container"
    - "aria-multiselectable='true' on each listbox"
    - "aria-selected on each option (true/false)"
    - "aria-labelledby pointing to list label"
    - "aria-describedby for operation instructions"
    - "tabindex='0' on selected items, '-1' on others"
    - "role='group' on form-element wrapper"
    - "aria-labelledby on group pointing to group label ID"

usage_guidelines:
  when_to_use:
    - "When users need to select multiple options from a large set"
    - "For moving items between available and selected lists"
    - "When reordering selected items is needed"
    - "For complex multi-select scenarios"
  when_not_to_use:
    - "For single selection (use select or combobox)"
    - "When only a few options exist (use checkboxes)"
    - "In very constrained spaces"
    - "When drag and drop is not supported"
  best_practices:
    - "Use group labels (fieldset/legend pattern) for accessibility"
    - "Provide clear operation instructions"
    - "Support both button and keyboard interactions"
    - "Implement proper focus management"
    - "Handle drag and drop gracefully with fallbacks"
    - "Use responsive variant for narrow layouts"
    - "Provide visual feedback for all interactions"
  common_mistakes:
    - "Not implementing proper ARIA listbox patterns"
    - "Missing keyboard navigation support"
    - "Inadequate focus management"
    - "Not providing operation instructions"
    - "Missing group labels for accessibility"

code_examples:
  - title: "Basic Dueling Picklist"
    code: |
      <div class="slds-form-element" role="group" aria-labelledby="dueling-picklist-label">
        <div class="slds-form-element__label slds-form-element__legend" id="dueling-picklist-label">
          Select Options
        </div>
        <div class="slds-form-element__control">
          <div class="slds-dueling-list">
            <div class="slds-dueling-list__column">
              <span class="slds-form-element__label">Available</span>
              <div class="slds-dueling-list__options" role="listbox" aria-multiselectable="true" aria-labelledby="available-label">
                <div role="option" aria-selected="false" tabindex="0">Option 1</div>
                <div role="option" aria-selected="false" tabindex="-1">Option 2</div>
                <div role="option" aria-selected="false" tabindex="-1">Option 3</div>
              </div>
            </div>
            <div class="slds-dueling-list__column">
              <button class="slds-button slds-button_neutral">Move Right</button>
              <button class="slds-button slds-button_neutral">Move Left</button>
            </div>
            <div class="slds-dueling-list__column">
              <span class="slds-form-element__label">Selected</span>
              <div class="slds-dueling-list__options" role="listbox" aria-multiselectable="true" aria-labelledby="selected-label">
                <div role="option" aria-selected="false" tabindex="0">Option 4</div>
              </div>
            </div>
          </div>
        </div>
      </div>
    description: "Basic dueling picklist with two lists and move buttons"
  - title: "Responsive Dueling Picklist"
    code: |
      <div class="slds-form-element" role="group" aria-labelledby="responsive-picklist-label">
        <div class="slds-form-element__label slds-form-element__legend" id="responsive-picklist-label">
          Select Options
        </div>
        <div class="slds-form-element__control">
          <div class="slds-dueling-list">
            <div class="slds-dueling-list__column slds-dueling-list__column_responsive">
              <span class="slds-form-element__label">Available</span>
              <div class="slds-dueling-list__options" role="listbox" aria-multiselectable="true">
                <div role="option" aria-selected="false" tabindex="0">Option 1</div>
                <div role="option" aria-selected="false" tabindex="-1">Option 2</div>
              </div>
            </div>
            <div class="slds-dueling-list__column">
              <button class="slds-button slds-button_neutral">Move Right</button>
              <button class="slds-button slds-button_neutral">Move Left</button>
            </div>
            <div class="slds-dueling-list__column slds-dueling-list__column_responsive">
              <span class="slds-form-element__label">Selected</span>
              <div class="slds-dueling-list__options" role="listbox" aria-multiselectable="true">
                <div role="option" aria-selected="false" tabindex="0">Option 3</div>
              </div>
            </div>
          </div>
        </div>
      </div>
    description: "Responsive dueling picklist that adapts to available space"

styling_hooks: []

dependencies:
  css_files: ["dueling-picklist.css", "form-element.css", "listbox.css", "button.css"]
  javascript:
    - "Listbox selection management"
    - "Item movement between lists"
    - "Drag and drop functionality (optional)"
    - "Keyboard navigation"
    - "Focus management"
  icons: []
  other_components: ["form-element", "listbox", "button"]

related_components:
  - name: "Listbox"
    relationship: "depends-on"
    description: "ARIA listbox component used for each list"
  - name: "Select"
    relationship: "alternative"
    description: "For single selection scenarios"
  - name: "Multi-Select"
    relationship: "similar"
    description: "Alternative multi-select component"

references:
  official_docs: "https://v1.lightningdesignsystem.com/components/dueling-picklist/"
  design_guidelines: "https://v1.lightningdesignsystem.com/components/dueling-picklist/"
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. Follows ARIA listbox practices for accessibility."

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