boruta / star-rating-bundle
Symfony 7 的星评级组件
7.0.0
2024-05-25 20:07 UTC
Requires
- php: >=8.2
- twig/twig: >=3.8
Requires (Dev)
- symfony/framework-bundle: >=7.0
This package is auto-updated.
Last update: 2024-09-25 20:51:42 UTC
README
这是基于blackknight467和brokoskokoli的StarRatingBundle改进的分支,已修改以支持Symfony 7!
示例输出
安装步骤
步骤 1:下载StarRatingBundle
使用Composer安装
使用Composer安装包
composer require boruta/star-rating-bundle
步骤 2:启用组件
在项目中启用组件(这可以自动完成)
<?php // config/bundles.php return [ // ... Boruta\StarRatingBundle\StarRatingBundle::class => ['all' => true], ];
步骤 3:配置Twig视图
将Twig配置添加到config/packages/twig.yaml
twig: paths: '%kernel.project_dir%/vendor/boruta/star-rating-bundle/Resources/views': BorutaStarRatingBundle
步骤 4:添加CSS
将CSS添加到页面头部
<link rel="stylesheet" type="text/css" href="{{ asset('bundles/starrating/css/rating.css') }}" />
步骤 5:添加JS
将评级脚本添加到页面头部
<script src="{{ asset('bundles/starrating/js/rating.js') }}"></script>
如果你还没有使用JQuery,也请添加JQuery
<script src="https//ajax.googleapis.ac.cn/ajax/libs/jquery/2.0.3/jquery.min.js"></script>
步骤 6:安装Font Awesome
安装Font Awesome(例如,使用NPM)。
使用方法
在Symfony表单中
<?php // ... $builder->add('rating', StarRatingType::class, [ 'label' => 'Rating' ]); // ...
或自定义评级尺度的使用
<?php // ... $builder->add('rating', StarRatingType::class, [ //... 'stars' => 4, //... ]); // ...
使用评级过滤器在Twig模板中显示
{{ someInteger|rating }}
或者如果你不使用5星尺度
{{ someInteger|rating(4) }}
如果你想使用font awesome图标大小
{{ someInteger|rating(5, "fa-3x") }}
如果你想使用最小尺寸,请使用"fa-norm"(在font awesome中,这等同于不提供尺寸类);不提供尺寸参数将字体大小设置为25px,介于"fa-lg"和"fa-2x"之间。要自定义尺寸,请自由覆盖CSS。
许可证
此组件受MIT许可证保护。请参阅组件中的完整许可证:LICENSE