简介
﹟ 关于 Stimulus
Stimulus 是一个目标适中的 JavaScript 框架。与其他前端框架不同,Stimulus 旨在通过使用简单的注释将 JavaScript 对象连接到页面上的元素,来增强静态或服务器渲染的 HTML(“你已有的 HTML”)。
这些 JavaScript 对象称为控制器,Stimulus 会持续监视页面,等待 HTML data-controller
属性出现。对于每个属性,Stimulus 会查看属性的值以查找相应的控制器类,创建该类的实例,并将其连接到元素。
你可以这样理解:就像 class
属性是连接 HTML 到 CSS 的桥梁一样,Stimulus 的 data-controller
属性是连接 HTML 到 JavaScript 的桥梁。
除了控制器之外,其他三个主要的 Stimulus 概念是
- 操作,它使用
data-action
属性将控制器方法连接到 DOM 事件 - 目标,它在控制器中找到重要的元素
- 值,它读取、写入和观察控制器元素上的数据属性
Stimulus 使用数据属性的方式有助于将内容与行为分开,就像 CSS 将内容与呈现分开一样。此外,Stimulus 的约定自然会鼓励你按名称对相关代码进行分组。
反过来,Stimulus 帮助你构建小巧、可重用的控制器,为你提供足够的结构,以防止你的代码退化为“JavaScript 大杂烩”。
﹟ 关于本书
本手册将通过演示如何编写几个完全功能的控制器来指导您了解 Stimulus 的核心概念。每一章都建立在前一章的基础上;从头到尾,您将学习如何
- 打印一个文本字段中名称的问候语
- 在单击按钮时将文本从文本字段复制到系统剪贴板
- 浏览具有多个幻灯片的幻灯片放映
- 自动从服务器获取 HTML 到页面上的元素
- 在您自己的应用程序中设置 Stimulus
完成此处的练习后,您可能会发现参考文档有助于了解 Stimulus API 的技术细节。
让我们开始吧!