caio-brendo/rating-input

此软件包最新版本(v1.0.1)没有可用的许可证信息。

渲染选择星级组件,对于处理评价非常有用。

安装: 3

依赖项: 0

建议者: 0

安全: 0

星级: 0

关注者: 1

分支: 0

开放问题: 0

类型:yii2-extension

v1.0.1 2021-01-10 13:31 UTC

This package is auto-updated.

Last update: 2024-09-11 10:35:42 UTC


README

评价输入


评价输入是yii2框架的一个小部件,用于渲染评价输入。

Latest Stable Version Total Downloads

目录结构

  src/             contains source code of widget
  src/assets       contains assets definition
  src/views        contains view files

需求

此项目模板的最低要求是您的Web服务器支持PHP 5.6.0。

安装

通过Composer安装

如果您没有Composer,您可以按照getcomposer.org上的说明进行安装。

然后您可以使用以下命令安装此小部件

composer require caio-brendo/rating-input

使用方法

与模型一起使用

如果您有一个模型,可以使用以下代码

<?php 
use yii\widgets\ActiveForm;
use caiobrendo\Rating;
$form = ActiveForm::begin(['id' => 'rating-form']); ?>
    <div class="row">
        <div class="col-md-12">
            <?= $form->field($model, 'rating')->widget(Rating::class) ?>
        </div>     
    </div>
ActiveForm::end();

不与模型一起使用

如果您没有模型,可以使用以下代码

<?php 
use caiobrendo\Rating;
?>
    <div class="row">
        <div class="col-md-12">
            <?= Rating::widget([
                'name' => 'rating',
                'id' => 'rating-id'
            ])?>
        </div>     
    </div>

JavaScript事件

$('.input-rating').on('beforeChange', (event) => {
    console.log('beforeChange', event);
})

$('.input-rating').on('afterChange', (event) => {
    console.log('afterChange', event);
})

设置

该小部件支持所有可传递给任何Yii Input Widget的参数。特别可用于评价输入小部件配置的附加参数设置有

  • model: 渲染输入的模型。
  • attribute: 渲染输入的属性。
  • value: 评价的初始值或实际值。
  • name: 条目的名称。用于无模型的组件。
  • qtdStar: 要选择的星级数量;
  • starHeight: 星星的高度。必须是有效的CSS高度。
  • starSpace: 星星之间的空间。必须是有效的CSS。