laravel-frontend-presets / stimulus
Laravel 5.5+ 前端预设用于 Stimulus
Requires
- laravel/framework: ^5.5
This package is auto-updated.
Last update: 2024-08-29 04:20:17 UTC
README
此包使得在 Laravel 5.5+ 中使用 Stimulus,一个针对现有 HTML 的简单 JavaScript 框架变得容易。
关于 Stimulus 的起源,请参阅 这里。
内容
安装/使用
要在您的 Laravel 应用程序上安装此预设,只需运行
composer require laravel-frontend-presets/stimulus php artisan preset stimulus npm install # or yarn install npm run dev # or yarn dev
这将
- 添加 Stimulus 预设包
- 删除除
bootstrap.js
之外的所有 JavaScript 文件 - 添加用于利用 Stimulus 的 JavaScript 文件
- 安装 Node.js 依赖项
- 构建前端资源
完成后,请确保在您的 public
目录中加载了构建的 js/app.js
文件,例如
<script type="text/javascript" defer src="{{ mix('/js/app.js') }}"></script>
resources/assets/js/controllers
(或 Laravel 5.7+ 中的 resources/js/controllers
)中定义的 Stimulus 控制器将在运行时可用。
注意:在更新定义的 Stimulus 控制器后,请记住重新构建前端资源以反映您的更改。
您的 Stimulus 控制器将通过 Webpack 的 require.context
功能和 Stimulus 助手自动包含在项目中。如果您不使用 Laravel Mix 或其他基于 Webpack 的构建工具,请查阅 Stimulus 手册中的 替代集成步骤。
Stimulus 基于 HTML 数据属性运行,因此请更新您的视图以使用定义的 Stimulus 控制器。对于默认的 hello-controller
,必要的 HTML 可能类似于
<div data-controller="hello"> <input data-target="hello.name" type="text"> <button data-action="click->hello#greet">Greet</button> </div>
通过阅读 手册 和/或 参考 来了解更多关于 Stimulus 的信息。
选项
-
with-turbolinks
- 通过 Turbolinks 加速您的 web 应用程序导航。示例
php artisan preset stimulus --option=with-turbolinks
贡献
有关详细信息,请参阅我们网站上的 贡献规则。
致谢
许可协议
此项目受 MIT 许可证许可。有关详细信息,请参阅 LICENSE。