Laravel 5.5+ 前端预设用于 Stimulus

0.1.0 2018-11-02 00:32 UTC

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