前言
Svelte，一个非常“有趣”、用起来“很爽”的前端框架。从 Svelte 诞生之初，就备受开发者的喜爱，根据统计，从 2019 年到 2024 年，连续 6 年一直是开发者最感兴趣的前端框架 No.1：
Svelte 以其独特的编译时优化机制著称，具有轻量级、高性能、易上手等特性，非常适合构建轻量级 Web 项目，也是我做个人项目的首选技术栈。
目前 Svelte 基于 Svelte 5 发布了最新的官方文档，但却缺少对应的中文文档。为了帮助大家学习 Svelte，为爱发电翻译了官方文档。
我同时搭建了 Svelte 最新的中文文档站点：https://svelte.yayujs.com ，如果需要辅助学习，也可以入手我的小册《Svelte 开发指南》，语法篇、实战篇、原理篇三大篇章带你系统掌握 Svelte！
虽说是翻译，但个人并不喜欢严格遵守原文，为了保证中文阅读流畅，会删减部分语句，对难懂的部分也会另做补充解释，希望能给大家带来一个好的中文学习体验。
欢迎围观我的“朋友圈”、加入“低调务实优秀中国好青年”前端社群，分享技术，带你成长。
{#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}
复制代码
（块不必只包裹元素，它们也可以包裹元素内的文本。）
{#each ...}
<!--- 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 ...}
{#key expression}...{/key}
复制代码
当表达式的值发生变化时，Key 块会销毁并重新创建其内容。当用在组件时，这将导致组件被重新实例化和重新初始化：
{#key value} <Component />{/key}
复制代码
如果你想要在值发生变化时播放过渡效果，这也很有用：
{#key value} <div transition:fade>{value}</div>{/key}
复制代码
{#await ...}
{#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
通过文字建立交流本身就是一种缘分，欢迎围观我的“朋友圈”、加入“低调务实优秀中国好青年”前端社群，分享技术，带你成长。
评论