Day9 - Astro Series: Client Side Script

Astro 系列文章第九天:脚本

一个漂亮的渐变背景,上面有一个标题:「脚本」

前言

到目前为止,我们还没有接触过如何在组件中执行客户端 JavaScript,本节将介绍「本地脚本」与「外部脚本」两种方式。通常操作 DOM 的逻辑都会放在客户端脚本中,比如事件监听、动画、Ajax……一切与浏览器密切相关的逻辑都会放在这里。

在 Astro 中使用脚本

可以通过在组件模板中添加 <script> 标签,将 JavaScript 引入组件。默认情况下,Astro 会对组件模板中的 <script> 进行以下处理,并将其注入 <head> 中,同时添加 type="module"。

  • 任何通过 import 引入的本地文件或 Node 包都会一并打包
  • 支持 TypeScript
  • 即使组件在同一页面中被多次引入,脚本实际上也只会被引入一次
---
---
<script>
console.log('欢迎使用浏览器控制台!');
</script>

如果不希望 Astro 管理组件中的脚本,也可以使用 is:inline 指令,将这段脚本直接插入 HTML 中,但必须注意,使用该指令会导致组件每次被重复引入时,脚本也会重复执行。

<script is:inline>
// 将直接写入 HTML 中,包导入将无法正常工作,且每当组件被重复使用时,该片段也会重复执行
</script>

引入本地脚本

当脚本放在 src/ 中时,可以直接引用该文件,Astro 同样会对其进行打包处理。

<!-- 脚本路径: `src/scripts/local.js` -->
<script src="../scripts/local.js"></script>
<!-- 同样支持 TypeScript -->
<script src="./script-with-types.ts"></script>

引入外部脚本

当脚本放在 public 或 CDN 上时,同样可以使用 is:inline,将其不经处理地添加到页面中。

<!-- 脚本路径: `public/my-script.js` -->
<script is:inline src="/my-script.js"></script>
<!-- 指向远程服务器的脚本地址 -->
<script is:inline src="https://my-analytics.com/script.js"></script>

总结

当你希望 Astro 处理脚本时,可以直接在组件模板中编写 <script> 标签;当需要直接插入内联脚本时,可以使用 is:inline🔗 模板指令。试着用客户端脚本为你的页面实现一些功能吧!比如:

这些都会是很好的小练习。

延伸阅读