NV Elements Catalog Starters Repo System Themes About Getting Started Changelog Metrics Support Accessibility Contributions Requests Migration Deprecations Integrations Installation MCP CLI Lint Angular Bundles Extensions Go Hugo Import Maps Lit NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue Foundations Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Forms Validation Actions Control Icon Icon Button Input Input Group Logo Menu Month Notification Page Page Header Page Loader Pagination Panel Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Onboarding Panel Responsive Search Subheader Trend Code Codeblock Monaco Input Diff Input Editor Diff Editor Problems Markdown Markdown CSS Utility Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Slots

Slots enable rendering dynamic content into the template of a given element.

📘 Tip: general rule, if the text is visible to the user then likely the API should use a Slot.

📘 Tip: slot projection of text content, enables apps to use i18n strategy of their choice

Flexibility

Slots provide flexibility for content controlled by the host application that a specific element API cannot guarantee to represent accurately.

Composition

Slots enable an easy way for component composition and decoupling from precise use cases that are application specific. This also decouples layout behaviors such as icon and button placement, giving the application control on DOM ordering.

Avoid exposing slot APIs as part of the public API. Rather than requiring the consumer to set a slot name on elements, have the element assign its own slot automatically.

If the footer element assigns its own slot it prevents the consumer from having to know or remember the underlying slot names reducing the API surface area.

🎓 Case Study: example of automatic slot assignment

Rendering

Composition based APIs also provide flexibility for the host application to choose the most appropriate render strategy for large lists of elements. For example, a tree view component can have hundreds or thousands of potential nodes of varying complexity.

By leveraging composition the host application has full render control in their native framework API.

This enables full control of conditional rendering of tree nodes as well as more advanced features like lazy and virtual scrolling.