Security News
Opengrep Emerges as Open Source Alternative Amid Semgrep Licensing Controversy
Opengrep forks Semgrep to preserve open source SAST in response to controversial licensing changes.
By Sarah Gooding - Jan 28, 2025
New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More →
carbon-components-svelte
Advanced tools
carbon-components-svelte
Carbon Components Svelte is a Svelte component library that implements the Carbon Design System, an open source design system by IBM.
Design systems facilitate design and development through reuse, consistency, and extensibility.
The Carbon Svelte portfolio also includes:
- Carbon Icons Svelte: 7000+ Carbon icons as Svelte components
- Carbon Pictograms Svelte: 700+ Carbon pictograms as Svelte components
- Carbon Charts Svelte: 20+ charts, powered by d3
- Carbon Preprocess Svelte: Collection of Svelte preprocessors for Carbon
Documentation
The documentation site is deployed to Render as a Static Site. See render.yaml for details.
Other forms of documentation are auto-generated:
- TypeScript definitions: Component TypeScript definitions
- Component Index: Component API in Markdown format
- Component API: Component API in JSON format
Installation
Install carbon-components-svelte as a development dependency.
Yarn
yarn add -D carbon-components-svelte
NPM
npm i -D carbon-components-svelte
pnpm
pnpm i -D carbon-components-svelte
Usage
Styling
Before importing components, you will need to first apply Carbon component styles. The Carbon Design System supports five themes (2 light, 3 dark).
- white.css: Default Carbon theme (light)
- g10.css: Gray 10 theme (light)
- g80.css: Gray 80 theme (dark)
- g90.css: Gray 90 theme (dark)
- g100.css: Gray 100 theme (dark)
- all.css: All themes (White, Gray 10, Gray 90, Gray 100) using CSS variables
Each StyleSheet is generated from the flagship carbon-components library.
The compiled CSS is generated from the following .scss files:
CSS StyleSheet
// White theme
import "carbon-components-svelte/css/white.css";
// Gray 10 theme
import "carbon-components-svelte/css/g10.css";
// Gray 80 theme
import "carbon-components-svelte/css/g80.css";
// Gray 90 theme
import "carbon-components-svelte/css/g90.css";
// Gray 100 theme
import "carbon-components-svelte/css/g100.css";
// All themes
import "carbon-components-svelte/css/all.css";
CDN
An alternative to loading styles is to link an external StyleSheet from a Content Delivery Network (CDN) like unpkg.com.
This is best suited for rapid prototyping.
HTML
<!DOCTYPE html>
<html>
<head>
<link
rel="stylesheet"
href="https://unpkg.com/carbon-components-svelte/css/white.css"
/>
</head>
</html>
svelte:head
<svelte:head>
<link
rel="stylesheet"
href="https://unpkg.com/carbon-components-svelte/css/white.css"
/>
</svelte:head>
SCSS
The most performant method to load styles is to import SCSS directly from carbon-components. Although it requires more set up, you can reduce the size of the bundle CSS by importing individual component styles instead of a pre-compiled CSS StyleSheet.
Refer to the official Carbon guide on SASS for documentation.
Dynamic theming
Use the "all.css" StyleSheet for dynamic, client-side theming.
import "carbon-components-svelte/css/all.css";
Update the theme by setting the theme attribute on the html element. The default theme is "white".
<!DOCTYPE html>
<html lang="en" theme="g10">
<body>
...
</body>
</html>
Programmatically switch between each of the five Carbon themes by setting the "theme" attribute on the HTML element.
<script>
let theme = "white"; // "white" | "g10" | "g80" | "g90" | "g100"
$: document.documentElement.setAttribute("theme", theme);
</script>
Importing components
Import components from carbon-components-svelte in the script tag of your Svelte file. Visit the documentation site for examples.
<!-- App.svelte -->
<script>
import { Accordion, AccordionItem } from "carbon-components-svelte";
</script>
<Accordion>
<AccordionItem title="Section 1" open> Content 1 </AccordionItem>
<AccordionItem title="Section 2"> Content 2 </AccordionItem>
<AccordionItem title="Section 3"> Content 3 </AccordionItem>
</Accordion>
Refer to COMPONENT_INDEX.md for component API documentation.
Preprocessors
carbon-preprocess-svelte is a collection of Svelte preprocessors for Carbon.
Yarn
yarn add -D carbon-preprocess-svelte
NPM
npm i -D carbon-preprocess-svelte
pnpm
pnpm i -D carbon-preprocess-svelte
optimizeImports
optimizeImports is a script preprocessor that rewrites base imports from Carbon components/icons/pictograms packages to their source Svelte code paths. This can greatly speed up compile times during development while preserving typeahead and autocompletion hinting offered by integrated development environments (IDE) like VSCode.
The preprocessor optimizes imports from the following packages:
Example
- import { Button } from "carbon-components-svelte";
- import { Add16 } from "carbon-icons-svelte";
- import { Airplane } from "carbon-pictograms-svelte";
+ import Button from "carbon-components-svelte/src/Button/Button.svelte";
+ import Add16 from "carbon-icons-svelte/lib/Add16/Add16.svelte";
+ import Airplane from "carbon-pictograms-svelte/lib/Airplane/Airplane.svelte";
Usage
// svelte.config.js
import { optimizeImports } from "carbon-preprocess-svelte";
export default {
preprocess: [optimizeImports()],
};
Examples
TypeScript support
TypeScript definitions are generated by sveld.
Contributing
Refer to the Contributing guidelines.
Changelog
License
0.59.0 - 2022-02-21
Features
- add
maxCountprop toTextArea - add
disabledprop toFileUploader - add
filesprop toFileUploaderDropContainer - add
filesprop toFileUploaderButton
Fixes
- change
add,changeevents inFileUploaderDropContainerto dispatchFile[]instead ofFileList - update
filesprop description inFileUploader
Documentation
- add
TextArea"Maximum character count" example - add
FileUploaderdisabled state example - add
FileUploader"Clear files" example - document
validateFilesprop forFileUploaderDropContainer - add descriptions for
FileUploaderButton,FileUploaderexamples
Housekeeping
- upgrade
carbon-componentsto v10.53.0
FAQs
Svelte implementation of the Carbon Design System
The npm package carbon-components-svelte receives a total of 12,260 weekly downloads. As such, carbon-components-svelte popularity was classified as popular.
We found that carbon-components-svelte demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Package last updated on 21 Feb 2022
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Security News
Node.js EOL Versions CVE Dubbed the "Worst CVE of the Year" by Security Experts
Critics call the Node.js EOL CVE a misuse of the system, sparking debate over CVE standards and the growing noise in vulnerability databases.
By Sarah Gooding - Jan 24, 2025
Security News
cURL Project and Go Security Teams Reject CVSS as Broken
cURL and Go security teams are publicly rejecting CVSS as flawed for assessing vulnerabilities and are calling for more accurate, context-aware approaches.
By Sarah Gooding - Jan 24, 2025