Pagination.php

Go to the documentation of this file.

<?php
/* Copyright (c) 2017 Nils Haagen <nils.haagen@concepts-and-training.de> Extended GPL, see docs/LICENSE */

namespace ILIAS\UI\Implementation\Component\ViewControl;

use ILIAS\UI\Component as C;
use ILIAS\UI\Implementation\Component\ComponentHelper;
use ILIAS\UI\Implementation\Component\SignalGeneratorInterface;
use ILIAS\UI\Implementation\Component\Triggerer;
use ILIAS\UI\Implementation\Component\JavaScriptBindable;

class Pagination implements C\ViewControl\Pagination
{
    use ComponentHelper;
    use JavaScriptBindable;
    use Triggerer;

    protected $total_entries = 0;

    protected $page_size;

    protected $current_page = 0;

    protected $internal_signal;

    protected $target_url;

    protected $paramter_name = "pagination_offset";

    protected $max_pages_shown;

    protected $dd_threshold;


    public function __construct(SignalGeneratorInterface $signal_generator)
    {
        $this->signal_generator = $signal_generator;
        $this->initSignals();
    }

    public function withResetSignals()
    {
        $clone = clone $this;
        $clone->initSignals();
        return $clone;
    }

    protected function initSignals()
    {
        $this->internal_signal = $this->signal_generator->create();
    }

    public function getInternalSignal()
    {
        return $this->internal_signal;
    }

    public function withTargetURL($url, $parameter_name)
    {
        $this->checkStringArg("url", $url);
        $this->checkStringArg("paramter_name", $parameter_name);
        $clone = clone $this;
        $clone->target_url = $url;
        $clone->paramter_name = $parameter_name;
        return $clone;
    }

    public function getTargetURL()
    {
        return $this->target_url;
    }

    public function getParameterName()
    {
        return $this->paramter_name;
    }

    public function withTotalEntries($total)
    {
        $this->checkIntArg("total", $total);
        $clone = clone $this;
        $clone->total_entries = $total;
        return $clone;
    }

    public function withPageSize($size)
    {
        $this->checkIntArg("size", $size);
        //raise, if size < 1
        $clone = clone $this;
        $clone->page_size = $size;
        return $clone;
    }

    public function getPageSize()
    {
        return $this->page_size;
    }

    public function withCurrentPage($page)
    {
        $this->checkIntArg("page", $page);
        $clone = clone $this;
        $clone->current_page = $page;
        return $clone;
    }

    public function getCurrentPage()
    {
        return $this->current_page;
    }

    public function getOffset()
    {
        $offset = $this->page_size * $this->current_page;
        return $offset;
    }

    public function withOnSelect(C\Signal $signal)
    {
        return $this->withTriggeredSignal($signal, 'select');
    }

    public function getNumberOfPages()
    {
        $pages = ceil($this->total_entries / $this->page_size);
        return (int) $pages;
    }

    public function withMaxPaginationButtons($amount)
    {
        $this->checkIntArg("amount", $amount);
        $clone = clone $this;
        $clone->max_pages_shown = $amount;
        return $clone;
    }

    public function getMaxPaginationButtons()
    {
        return $this->max_pages_shown;
    }

    public function getPageLength()
    {
        if ($this->getOffset() + $this->page_size > $this->total_entries) {
            return $this->total_entries - $this->getOffset();
        }
        return $this->page_size;
    }

    public function withDropdownAt($amount)
    {
        $this->checkIntArg("amount", $amount);
        $clone = clone $this;
        $clone->dd_threshold = $amount;
        return $clone;
    }

    public function getDropdownAt()
    {
        return $this->dd_threshold;
    }
}