README

适用于 Yii2 的简单过滤器，可将过滤值应用于 ActivQuery

安装

安装此扩展的首选方式是通过 Composer。

可以运行

composer require --prefer-dist kr0lik/yii2-list-filter "*"

或者添加

"kr0lik/yii2-list-filter": "*"

到您的 composer.json 文件的 require 部分。

使用方法

在控制器中创建过滤器

<?php
use yii\web\Controller;
use kr0lik\listFilter\Filter;
use app\models\YourModel;

class YourController extends Controller
{
    public function actionIndex()
    {
	$query = YourModel::find();
		
	$filter = new Filter();
		
	$filter->add('default')->setTitle('Parameter Default')->setScope('byParameter');
        $filter->add('collection', Filter::PARAMETER_COLLECTION)->setScope('byCollectionParameter');
        $filter->add('price', Filter::PARAMETER_RANGE)->setTitle('Range Parameter')->setScope('byPrice')->setUnit('$');
        $filter->add('hasPrice', Filter::PARAMETER_BOOLEAN)->setScope(function($query, $select) {
            return $select ? $query->hasPrice() : $query;
        })->addValue(true, 'Checked by default')->addSelect(true);
		
	$filter->getParameter('default')->addValue('id', 'checkbox', 'Url', 'title');
		
	$filter->getParameter('price')
	    ->setMinValue(0)
            ->setMaxValue(100)
	    ->setStep(1);
		
	$filter->getParameter('collection')
            ->add('collection1')
            ->setTitle('Collection 1')
	    ->addValue(true, 'Checked by default')->addSelect(true);
			
	$filter->getParameter('collection')
            ->add('collection2', Filter::PARAMETER_RANGE)
            ->setTitle('Collection 2');	
				
		
	$filter->getParameter('collection')->getParameter('collection2')
	    ->setMinValue(1)
            ->setMaxValue(12.5)
	    ->setStep(0.5);
		
	$dataProvider = new ActiveDataProvider([
            'query' => $query->byFilter($filter),
	    ...
	]);
		
	return $this->render('index', ['filter' => $filter, 'dataProvider' => $dataProvider]);
    }
}

在您的模型查询类中添加 FilterQueryTrait

<?php
use yii\db\ActiveQuery;
use kr0lik\listFilter\FilterQueryTrait;

class YourModelQuery extends ActiveQuery
{
    use FilterQueryTrait;
}

在视图中创建过滤器

<?php
use yii\helpers\Html;
use yii\widgets\ListView;
use kr0lik\listFilter\Filter;
?>

<?php foreach ($filter->getSelectedValues() as $value): ?>
	<?= $value->getName() ?><br />
<?php endforeach; ?>

<?= Html::beginForm() ?>
    <?php foreach ($filter->getParameters() as $parameter): ?>
        <?php if (! $parameter->hasValues()) continue; ?>
        <h2><?= $parameter->getTitle() ?></h2>

        <?php if ($parameter::getType() === Filter::PARAMETER_COLLECTION): ?>
            <?php foreach ($parameter->getParameters() as $parameter): ?>
                <?php if (! $parameter->hasValues()) continue; ?>
                <h4><?= $parameter->getTitle() ?></h4>
                <?php if ($parameter::getType() === Filter::PARAMETER_RANGE) :?>
			<?= Html::input('range', $parameter->getInputNameFrom(), $parameter->getValueFrom()) ?>
			-
			<?= Html::input('number', $parameter->getInputNameTo(), $parameter->getValueTo()) ?>
                <?php else: ?>
			<?php if ($parameter::getType() === Filter::PARAMETER_BOOLEAN) :?>
				<?= Html::hiddenInput($parameter->getInputName(), false); ?>
			<?php endif; ?>
				
			<?php foreach($parameter->getValues() as $value): ?>
				<?= Html::checkbox($parameter->getInputName(), $value->isSelected(), ['id' => $value->getId(), 'value' => $value->getValue()]) ?>
				<?= Html::label($value->getName(), $value->getId()) ?>
			<?php endforeach; ?>
                <?php endif; ?>

            <?php endforeach; ?>
        <?php else: ?>
            <?php if (! $parameter->hasValues()) continue; ?>

            <?php if ($parameter::getType() === Filter::PARAMETER_RANGE) :?>
			<?= Html::input('range', $parameter->getInputName(), current($parameter->getSelections()), ['min' => $parameter->getMinValue(), 'max' => $parameter->getMaxValue(), 'step' => $parameter->getStep()]) ?>
            <?php else: ?>
			<?php if ($parameter::getType() === Filter::PARAMETER_BOOLEAN) :?>
				<?= Html::hiddenInput($parameter->getInputName(), false); ?>
			<?php endif; ?>
				
			<?php foreach($parameter->getValues() as $value): ?>
				<?= Html::checkbox($parameter->getInputName(), $value->isSelected(), ['id' => $value->getId(), 'value' => $value->getValue()]) ?>
                <?= Html::label($value->getName(), $value->getId()) ?>
			<?php endforeach; ?>
            <?php endif; ?>

        <?php endif; ?>
    <?php endforeach; ?>
    
    <?= Html::submitButton('Submit') ?>
<?= Html::endForm() ?>

<?= ListView::widget(['dataProvider' => $dataProvider]) ?>