Download the PHP package pys/laravel-blade-lottie without Composer

On this page you can find all versions of the php package pys/laravel-blade-lottie. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-blade-lottie

顾名思义,laravel-blade-lottie 可以让你更方便的在 blade 模板中使用 lottie animation json files,也可以使用 iconfont.cn Lottie 库中的动画。

用法

安装包

composer require ys/laravel-blade-lottie

发布必要文件

php artisan lottie:publish

这个操作会把配置文件复制为 config/lottie.php,还会把需要用到的前端文件发布到 public/vendor/lottie

引入 app.js

在需要用到页面中添加 <script src="{{ asset('vendor/lottie/app.js') }}" defer></script>。但是通常来说,把它添加到 views/layouts/app.blade.php 中会比较方便。

引入 lottie animation files

lottie files 官方网站上可以免费下载 json 文件。下载文件需要注册一个账号,我在这里提供了一个测试用的 json,将其中的内容复制到 storage/app/public/lottiefiles/hello.json

使用组件

views/layouts/app.blade.php 引入 <x-lottie-hello/>,打开你的项目地址,就可以看到:

关于 app.js

首先,lottie-web 是必不可少的,另外我还使用了 alpinejs,用于实现一些 js 的操作。我把他们打包到了 public/vendor/lottie/app.js 中,你可以直接使用。

你也可以在自己的 app.js 中打包 lottie-webalpinejs,如果这样做,那么上面提到的的 <script src="{{ asset('vendor/lottie/app.js') }}" defer></script> 就没必要再引入了。

如何控制动画

这取决与 lottie-web,它提供了一些属性和方法,用于控制动画。

loop 属性

config/lottie.php 中可以定义全局的是否循环播放属性,如果为每个组件单独定义,可以这样做:

或者简写为:

autoplay 属性

config/lottie.php 中可以定义全局的是否自动播放属性,如果为每个组件单独定义,可以这样做:

或者简写为:

调用方法

在 blade 组件中,初始化 alpinejs 的时候,lottie-web 实例被绑定给了 animation。所以,可以使用 animation 来调用 lottie-web 提供的方法,从而控制动画。

例如,如果想要单击动画停止播放,可以在 click 事件中,通过调用 animation.stop() 来实现。click 是 alpinejs 提供的,在 alpinejs#use 可以查看更多用法。

自定义 class

自定 class 的会被追加到动画的容器上,参考 laravel 文档

例如,可以自定义 class:

自定义非 class 属性

自定属性的会被添加到动画容器上,如果已存在相同属性,则会把原来的覆盖,参考 laravel 文档

例如,可以自定义 style:

关于 data_source

支持配置 url 和 content。选择 url ,浏览器会发请求去获取 json 数据,意味着会增加网络开销;而选择 content,则 json 数据会通过后端渲染,附加到 HTML 中发送给前端,如果 json 数据很大,则你的 HTML 页面可能也会变得很大,但是我没有测试。

如果使用 url 的方式,不要忘了在 .env 文件中配置正确的 APP_URL,以及执行 php artisan storage:link


All versions of laravel-blade-lottie with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4|^8.0
illuminate/contracts Version ^6.0|^7.0|^8.0|^9.0|^10.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package pys/laravel-blade-lottie contains the following files

Loading the files please wait ....