Code Block
Provides syntax highlighting, line numbers, and copy to clipboard functionality for code blocks.
The CodeBlock component provides syntax highlighting, line numbers, and copy to clipboard functionality for code blocks. It's fully composable, allowing you to customize the header, actions, and content.
Install using CLI
Install Manually
Copy and paste the following files into the same folder.
Usage
The CodeBlock is fully composable. Here's a basic example:
Features
- Syntax highlighting with Shiki
- Line numbers (optional)
- Copy to clipboard functionality
- Automatic light/dark theme switching via CSS variables
- Language selector for multi-language examples
- Fully composable architecture
- Accessible design
Examples
Dark Mode
To use the CodeBlock component in dark mode, wrap it in a div with the dark class.
Language Selector
Add a language selector to switch between different code implementations:
Props
<CodeBlock />
<CodeBlockHeader />
Container for the header row. Uses flexbox with justify-between.
<CodeBlockTitle />
Left-aligned container for icon and filename. Uses flexbox with gap-2.
<CodeBlockFilename />
Displays the filename in monospace font.
<CodeBlockActions />
Right-aligned container for action buttons. Uses flexbox with gap-2.
<CodeBlockCopyButton />
<CodeBlockLanguageSelector />
Wrapper for the language selector. Extends shadcn/ui Select.
<CodeBlockLanguageSelectorTrigger />
Trigger button for the language selector dropdown. Pre-styled for code block header.
<CodeBlockLanguageSelectorValue />
Displays the selected language value.
<CodeBlockLanguageSelectorContent />
Dropdown content container. Defaults to align="end".
<CodeBlockLanguageSelectorItem />
Individual language option in the dropdown.
<CodeBlockContainer />
Low-level container component with performance optimizations (contentVisibility). Used internally by CodeBlock.
<CodeBlockContent />
Low-level component that handles syntax highlighting. Used internally by CodeBlock, but can be used directly for custom layouts.