前言
Svelte，一个非常“有趣”、用起来“很爽”的前端框架。从 Svelte 诞生之初，就备受开发者的喜爱，根据统计，从 2019 年到 2024 年，连续 6 年一直是开发者最感兴趣的前端框架 No.1：
Svelte 以其独特的编译时优化机制著称，具有轻量级、高性能、易上手等特性，非常适合构建轻量级 Web 项目，也是我做个人项目的首选技术栈。
目前 Svelte 基于 Svelte 5 发布了最新的官方文档，但却缺少对应的中文文档。为了帮助大家学习 Svelte，为爱发电翻译了官方文档。
我同时搭建了 Svelte 最新的中文文档站点：https://svelte.yayujs.com ，如果需要辅助学习，也可以入手我的小册《Svelte 开发指南》，语法篇、实战篇、原理篇三大篇章带你系统掌握 Svelte！
虽说是翻译，但个人并不喜欢严格遵守原文，为了保证中文阅读流畅，会删减部分语句，对难懂的部分也会另做补充解释，希望能给大家带来一个好的中文学习体验。
欢迎围观我的“朋友圈”、加入“低调务实优秀中国好青年”前端社群，分享技术，带你成长。
{#if expression}...{/if}
{#if expression}...{:else if expression}...{/if}
{#if expression}...{:else}...{/if}
需要条件渲染的内容可以包装在 if 块中。
{#if answer === 42}<p>问题是什么？</p>
{/if}
可以使用 {:else if expression} 添加额外的条件，最后可以选择性地以 {:else} 子句结束。
{#if porridge.temperature > 100}<p>太热了！</p>
{:else if 80 > porridge.temperature}<p>太冷了！</p>
{:else}<p>刚刚好！</p>
{/if}
（块不必只包裹元素，它们也可以包裹元素内的文本。）
<!--- copy: false --->
{#each expression as name}...{/each}
<!--- copy: false --->
{#each expression as name, index}...{/each}
遍历值可以通过 each 块来完成。这些值可以是数组、类数组对象（即任何具有 length 属性的对象），或者可迭代对象如 Map 和 Set —— 换句话说，任何可以用 Array.from 处理的对象都可以。
<h1>购物清单</h1>
<ul>{#each items as item}<li>{item.name} x {item.qty}</li>{/each}
</ul>
each 块还可以指定一个 index，相当于 array.map(...) 回调中的第二个参数：
{#each items as item, i}<li>{i + 1}: {item.name} x {item.qty}</li>
{/each}
带键的 each 块
<!--- copy: false --->
{#each expression as name (key)}...{/each}
<!--- copy: false --->
{#each expression as name, index (key)}...{/each}
如果提供了一个 key 表达式（必须能唯一标识每个列表项），当数据发生变化时，Svelte 将使用它对列表进行差异比较，而不是在末尾添加或删除条目。key 可以是任何对象，但建议使用字符串和数字，因为它们允许在对象本身发生变化时保持标识继续存在。
{#each items as item (item.id)}<li>{item.name} x {item.qty}</li>
{/each}<!-- 或带有额外的索引值 -->
{#each items as item, i (item.id)}<li>{i + 1}: {item.name} x {item.qty}</li>
{/each}
你可以在 each 块中自由使用解构和剩余模式。
{#each items as { id, name, qty }, i (id)}<li>{i + 1}: {name} x {qty}</li>
{/each}{#each objects as { id, ...rest }}<li><span>{id}</span><MyComponent {...rest} /></li>
{/each}{#each items as [id, ...rest]}<li><span>{id}</span><MyComponent values={rest} /></li>
{/each}
不带条目的 each 块
<!--- copy: false --->
{#each expression}...{/each}
<!--- copy: false --->
{#each expression, index}...{/each}
如果你只是想渲染某些内容 n 次，可以省略 as 部分（demo）：
<div class="chess-board">{#each { length: 8 }, rank}{#each { length: 8 }, file}<div class:black={(rank + file) % 2 === 1}></div>{/each}{/each}
</div>
Else 块
<!--- copy: false --->
{#each expression as name}...{:else}...{/each}
each 块还可以有一个 {:else} 子句，当列表为空时会渲染该子句。
{#each todos as todo}<p>{todo.text}</p>
{:else}<p>今天没有任务！</p>
{/each}
{#key expression}...{/key}
当表达式的值发生变化时，Key 块会销毁并重新创建其内容。当用在组件时，这将导致组件被重新实例化和重新初始化：
{#key value}<Component />
{/key}
如果你想要在值发生变化时播放过渡效果，这也很有用：
{#key value}<div transition:fade>{value}</div>
{/key}
{#await expression}...{:then name}...{:catch name}...{/await}
{#await expression}...{:then name}...{/await}
{#await expression then name}...{/await}
{#await expression catch name}...{/await}
Await 块允许你根据 Promise 的三种可能状态 — 等待中（pending）、已完成（fulfilled）或已拒绝（rejected） — 进行分支处理。
{#await promise}<!-- promise 正在等待中 --><p>等待 promise 解决中...</p>
{:then value}<!-- promise 已完成或不是一个 Promise --><p>值是 {value}</p>
{:catch error}<!-- promise 被拒绝 --><p>出现错误: {error.message}</p>
{/await}
[!NOTE] 在服务端渲染期间，只会渲染等待中分支。
如果提供的表达式不是一个
Promise，则只会渲染:then分支，包括在服务端渲染期间。
如果你不需要在 promise 被拒绝时渲染任何内容（或不可能出现错误），可以省略 catch 块。
{#await promise}<!-- promise 正在等待中 --><p>等待 promise 解决中...</p>
{:then value}<!-- promise 已完成 --><p>值是 {value}</p>
{/await}
如果你不关心等待状态，你也可以省略初始块。
{#await promise then value}<p>值是 {value}</p>
{/await}
同样，如果你只想显示错误状态，你可以省略 then 块。
{#await promise catch error}<p>错误是 {error}</p>
{/await}
[!NOTE] 你可以将
#await和import(...)一起使用实现组件懒加载：{#await import('./Component.svelte') then { default: Component }}<Component /> {/await}
Svelte 中文文档
本篇已收录在掘金专栏 《Svelte 中文文档》，该系列预计 40 篇。
系统学习 Svelte，欢迎入手小册《Svelte 开发指南》。语法篇、实战篇、原理篇三大篇章带你系统掌握 Svelte！
此外我还写过 JavaScript 系列、TypeScript 系列、React 系列、Next.js 系列、冴羽答读者问等 14 个系列文章， 全系列文章目录：https://github.com/mqyqingfeng/Blog
通过文字建立交流本身就是一种缘分，欢迎围观我的“朋友圈”、加入“低调务实优秀中国好青年”前端社群，分享技术，带你成长。
