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\Signal;
use ILIAS\UI\Component\ViewControl\Pagination as PaginationInterface;
use ILIAS\UI\Implementation\Component\ComponentHelper;
use ILIAS\UI\Implementation\Component\SignalGeneratorInterface;
use ILIAS\UI\Implementation\Component\Triggerer;
use ILIAS\UI\Implementation\Component\JavaScriptBindable;
 
use ILIAS\Data\Range;
 
class Pagination implements PaginationInterface
{
    use ComponentHelper;
    use JavaScriptBindable;
    use Triggerer;
 
    protected $total_entries = 0;
 
    protected $page_size;
 
    protected $current_page = 0;
 
    protected $internal_signal;
 
    protected $target_url;
 
    protected $parameter_name = "pagination_offset";
 
    protected $max_pages_shown;
 
    protected $dd_threshold;
 
    protected $dropdown_label;
 
    protected $signal_generator;
 
    public function __construct(SignalGeneratorInterface $signal_generator)
    {
        $this->signal_generator = $signal_generator;
        $this->initSignals();
        $this->dropdown_label = self::DEFAULT_DROPDOWN_LABEL;
    }
 
    public function withResetSignals()
    {
        $clone = clone $this;
        $clone->initSignals();
        return $clone;
    }
 
    protected function initSignals()
    {
        $this->internal_signal = $this->signal_generator->create();
    }
 
    public function getInternalSignal() : Signal
    {
        return $this->internal_signal;
    }
 
    public function withTargetURL(string $url, string $parameter_name) : PaginationInterface
    {
        $this->checkStringArg("url", $url);
        $this->checkStringArg("parameter_name", $parameter_name);
        $clone = clone $this;
        $clone->target_url = $url;
        $clone->parameter_name = $parameter_name;
        return $clone;
    }
 
    public function getTargetURL()
    {
        return $this->target_url;
    }
 
    public function getParameterName() : string
    {
        return $this->parameter_name;
    }
 
    public function withTotalEntries(int $total) : PaginationInterface
    {
        $this->checkIntArg("total", $total);
        $clone = clone $this;
        $clone->total_entries = $total;
        return $clone;
    }
 
    public function withPageSize(int $size) : PaginationInterface
    {
        $this->checkIntArg("size", $size);
        //raise, if size < 1
        $clone = clone $this;
        $clone->page_size = $size;
        return $clone;
    }
 
    public function getPageSize() : int
    {
        return $this->page_size;
    }
 
    public function withCurrentPage(int $page) : PaginationInterface
    {
        $this->checkIntArg("page", $page);
        $clone = clone $this;
        $clone->current_page = $page;
        return $clone;
    }
 
    public function getCurrentPage() : int
    {
        return $this->current_page;
    }
 
    protected function getOffset() : int
    {
        $offset = $this->page_size * $this->current_page;
        return $offset;
    }
 
    public function withOnSelect(Signal $signal) : PaginationInterface
    {
        return $this->withTriggeredSignal($signal, 'select');
    }
 
    public function getNumberOfPages() : int
    {
        $pages = ceil($this->total_entries / $this->page_size);
        return (int) $pages;
    }
 
    public function withMaxPaginationButtons(int $amount) : PaginationInterface
    {
        $this->checkIntArg("amount", $amount);
        $clone = clone $this;
        $clone->max_pages_shown = $amount;
        return $clone;
    }
 
    public function getMaxPaginationButtons()
    {
        return $this->max_pages_shown;
    }
 
    protected function getPageLength() : int
    {
        if ($this->getOffset() + $this->page_size > $this->total_entries) {
            return $this->total_entries - $this->getOffset();
        }
        return $this->page_size;
    }
 
    public function withDropdownAt(int $amount) : PaginationInterface
    {
        $this->checkIntArg("amount", $amount);
        $clone = clone $this;
        $clone->dd_threshold = $amount;
        return $clone;
    }
 
    public function getDropdownAt()
    {
        return $this->dd_threshold;
    }
 
    public function withDropdownLabel(string $template) : PaginationInterface
    {
        $clone = clone $this;
        $clone->dropdown_label = $template;
        return $clone;
    }
 
    public function getDropdownLabel() : string
    {
        return $this->dropdown_label;
    }
 
    public function getDefaultDropdownLabel() : string
    {
        return self::DEFAULT_DROPDOWN_LABEL;
    }
 
    public function getRange() : Range
    {
        $f = new \ILIAS\Data\Factory();
        return $f->range($this->getOffset(), $this->getPageLength());
    }
}