注意：此文档目前还是半成品。如遇到缺失或有误导的部分敬请谅解，并且勇于在聊天室寻求帮助，这些教程会更加完善。那么，开始学习吧：

以下页面包含详细的API说明文档，主要是给已经初步接触过Svelte的人们提供的资源。

如果你还没有接触过Svelte，你可以在查阅这些资料前先访问这个可交互的教程或者例子。

组件是Svelte应用的内置区块，是使用HTML的扩展格式的语言写成.svelte文件

一共分为三个区域、script、style和标签（选填）

一个`script`区域含有一个组件实例创建时的运行Javascript代码。

变量申明（或者引入的变量）在组件标签顶部显示申明。

这里有4条规则：

1. export 用来申明组件的属性

Svelte 使用 export 这个关键字标识一个变量申明作为组件的属性prop，这意味着组件的使用者通过属性可以访问它。

赋值分配是响应式的

改变组件的state并触发组件重新渲染，只需要给本地的已申明变量赋值

使用表达式（count += 1）更新count的值和给属性赋值（obj.x = y）是等效的。

因为Svelte的响应式是基于赋值操作的，使用属性方法如 .push 和 .splice 将不会自动触发更新。有关解决此问题的选项，可以参考此教程

3 使用 $ 将表达式设为响应式的

任何顶层的表达式（不包含代码块和函数申明）可以通过一个$符号设置成响应式的。这是js的标签语法。当响应式表达式依赖的值发生变化时，它们会在组件更新前立即执行。

如果一个表达式是一条由完全未申明的变量组成的赋值语句，Svelte会替你插入一个let申明。

4 为Store添加$前缀来访问它们的值

任何时候，对于任意一个Store，你都可以在组件内部为该Store的引用添加$字符前缀来访问它的值。这会导致Svelte申明有前缀的变量，并且会设置一个Store订阅然后再适当的时候会取消这个订阅。

要注意，必须在组件的顶层申明Store，并且不可以包含在if代码块中

本地申明的变量（不代指store的值）不允许还有$前缀

一个带有`context="module"`属性的`<script>`标签的模块只会执行一次，而不是每次都生成组件实例。在此模块中申明的Values可以被正常的`<script>`标签访问到（包括组件标签）但是反之则无法这么使用。

你可以从此区块中 导出 这些绑定值，并且他们会成为编译的模块的导出值

你不能 export default 因为默认导出的是组件本身

写在`<style>`中的CSS与组件外部是隔离的

这个功能是通过给元素添加带有组件style哈希的class来实现的。eg（svelte-123xyz）

可以通过使用`:global(...)`修饰符将样式作用域全局