boruta/star-rating-bundle

Symfony 7 的星评级组件

安装: 69

依赖: 0

建议者: 0

安全: 0

星数: 0

关注者: 0

分支: 40

类型:symfony-bundle

7.0.0 2024-05-25 20:07 UTC

This package is auto-updated.

Last update: 2024-09-25 20:51:42 UTC


README

这是基于blackknight467和brokoskokoli的StarRatingBundle改进的分支,已修改以支持Symfony 7!

示例输出

alt tag

安装步骤

步骤 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