Svelte 最新中文文档翻译（6）—— if、each、key、await 逻辑区块

前言

Svelte，一个非常“有趣”、用起来“很爽”的前端框架。从 Svelte 诞生之初，就备受开发者的喜爱，根据统计，从 2019 年到 2024 年，连续 6 年一直是开发者最感兴趣的前端框架 No.1：

Svelte 以其独特的编译时优化机制著称，具有轻量级、高性能、易上手等特性，非常适合构建轻量级 Web 项目，也是我做个人项目的首选技术栈。

目前 Svelte 基于 Svelte 5 发布了最新的官方文档，但却缺少对应的中文文档。为了帮助大家学习 Svelte，为爱发电翻译了官方文档。

我同时搭建了 Svelte 最新的中文文档站点：https://svelte.yayujs.com ，如果需要辅助学习，也可以入手我的小册《Svelte 开发指南》，语法篇、实战篇、原理篇三大篇章带你系统掌握 Svelte！

虽说是翻译，但个人并不喜欢严格遵守原文，为了保证中文阅读流畅，会删减部分语句，对难懂的部分也会另做补充解释，希望能给大家带来一个好的中文学习体验。

欢迎围观我的“朋友圈”、加入“低调务实优秀中国好青年”前端社群，分享技术，带你成长。

{#if ...}

{#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}

（块不必只包裹元素，它们也可以包裹元素内的文本。）

{#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

通过文字建立交流本身就是一种缘分，欢迎围观我的“朋友圈”、加入“低调务实优秀中国好青年”前端社群，分享技术，带你成长。