Getting Started 快速开始

环境要求

需要 Svelte 5(runes)。组件以 runes 模式编写,依赖 Svelte 5 的响应式系统。

安装

pnpm add @chenzy-design/svelte @chenzy-design/tokens

引入设计令牌

在应用入口(如 +layout.svelte)引入设计令牌 CSS。这一步是必须的,否则组件没有样式。

<script>
  import '@chenzy-design/tokens/tokens.css';
  let { children } = $props();
</script>

{@render children()}

使用组件

在任意页面按需引入并使用组件:

<script lang="ts">
  import { Button, Input } from '@chenzy-design/svelte';
  let text = $state('');
</script>

<Button type="primary">主要按钮</Button>
<Input bind:value={text} placeholder="请输入" />

暗色模式

给根元素 html 设置 data-theme="dark" 即可切换到暗色主题:

document.documentElement.setAttribute('data-theme', 'dark');

去掉该属性或设为 light 即回到亮色主题。Token 体系会自动响应。

下一步