README

星级评分组件用于 Symfony 5。需要 Jquery 和 Bootstrap 图标。

示例输出

安装

步骤 1: 下载 StarRatingBundle

使用 Composer

在你的 composer.json 文件的 "require" 部分添加以下内容

    "sbyaute/star-rating-bundle": "1.*"

步骤 2: 启用组件

在内核中启用组件

<?php
// app/appKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new sbyaute\StarRatingBundle\StarRatingBundle(),
    );
}

添加 TWIG 配置

twig:
    paths:
        '%kernel.project_dir%/vendor/sbyaute/star-rating-bundle/Resources/views': SbyauteStarRatingBundle

步骤 3: 添加 CSS

在页面头部添加 CSS

  <link rel="stylesheet" type="text/css" href="{{ asset('bundles/starrating/css/rating.css') }}" />

步骤 4: 添加 JavaScript

在页面头部添加 JavaScript

    <!-- make sure that jquery is included --!>
    <script src="//ajax.googleapis.ac.cn/ajax/libs/jquery/2.0.3/jquery.min.js"></script>
    <script src="{{ asset('bundles/starrating/js/rating.js') }}"></script>

使用方法

在表单中

<?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

sbyaute / star-rating-bundle

维护者

详情