class AlphaPaginationCharacter in Views Alpha Pagination 8.2

Class AlphaPaginationCharacter.

Hierarchy

• class \Drupal\alpha_pagination\AlphaPaginationCharacter

File

src/AlphaPaginationCharacter.php, line 11

Namespace

Drupal\alpha_pagination

class AlphaPaginationCharacter {

  /**
   * Flag determining if character is currently active.
   *
   * @var bool
   */
  protected $active = FALSE;

  /**
   * The AlphaPagination object reference.
   *
   * @var \AlphaPagination
   */
  protected $alphaPagination;

  /**
   * Flag determining if character is currently enabled.
   *
   * @var bool
   */
  protected $enabled = FALSE;

  /**
   * The human readable label of the character.
   *
   * @var string
   */
  protected $label;

  /**
   * The raw value of the character.
   *
   * @var string
   */
  protected $value;

  /**
   * AlphaPaginationCharacter constructor.
   *
   * @param \Drupal\alpha_pagination\AlphaPagination $alpha_pagination
   *   The pagination handler class.
   * @param string $label
   *   The human readable label of the character.
   * @param string $value
   *   The raw value of the character.
   */
  public function __construct(AlphaPagination $alpha_pagination, string $label, string $value) {
    $this->alphaPagination = $alpha_pagination;
    $this->label = $label;
    $this->value = $value;
  }

  /**
   * Builds a render array of the character.
   *
   * @param bool $render
   *   Flag determining whether to render the character.
   *
   * @return array|string
   *   A render array or a string of rendered markup if $render is TRUE.
   */
  public function build($render = FALSE) {

    // Render a link.
    if ($this
      ->isLink()) {
      $build = $this
        ->buildLink();
    }
    else {
      $build = [
        '#type' => 'html_tag',
        // '#theme' => 'html_tag__alpha_pagination__inactive',
        '#tag' => 'span',
        '#value' => $this
          ->getLabel(),
      ];
    }
    return $render ? \Drupal::service('renderer')
      ->render($build) : $build;
  }

  /**
   * Builds a link render array based on current text, value and options.
   *
   * @param array $options
   *   Optional. Array of options to pass to url().
   *
   * @return array
   *   A render array for the link.
   */
  public function buildLink(array $options = []) {

    // Merge in options.
    $options = NestedArray::mergeDeep([
      'attributes' => [],
      'html' => FALSE,
      'query' => \Drupal::request()->query
        ->all(),
    ], $options);

    // Merge in classes.
    $this->alphaPagination
      ->addClasses($this
      ->getOption('paginate_link_class'), $options['attributes']);
    $token = \Drupal::service('token');
    $tokens = $this->alphaPagination
      ->getTokens($this
      ->getValue());
    $path = $token
      ->replace($this
      ->getOption('paginate_link_path'), $tokens);

    // Determine if link is external (automatically enforcing for anchors).
    if ($this
      ->getOption('paginate_link_external') || $path && $path[0] === '#') {
      $options['external'] = TRUE;
    }
    else {
      $path = 'internal:/' . $path;
    }

    // Add in additional attributes.
    if ($this
      ->getOption('paginate_link_attributes')) {
      $attributes = $this->alphaPagination
        ->parseAttributes($this
        ->getOption('paginate_link_attributes'), $tokens);

      // Remove any class attributes (should use the dedicated class option).
      unset($attributes['class']);

      // Merge in the attributes.
      $options['attributes'] = NestedArray::mergeDeep($options['attributes'], $attributes);
    }

    // Build link render array.
    return [
      //      '#theme' => 'link__alpha_pagination',
      '#type' => 'link',
      '#title' => $this
        ->getLabel(),
      '#url' => Url::fromUri($path),
      '#options' => $options,
    ];
  }

  /**
   * Retrieves the set label for the character.
   *
   * @return string
   */
  public function getLabel() {
    return $this->label;
  }

  /**
   * Retrieves an option from the view handler.
   *
   * @param string $name
   *   The option name to retrieve.
   * @param mixed $default
   *   The default value to return if not set.
   *
   * @return string
   *   The option value or $default if not set.
   *
   * @see \AlphaPagination::getOption()
   */
  protected function getOption($name, $default = '') {
    return $this->alphaPagination
      ->getOption($name, $default);
  }

  /**
   * Retrieves the set value for the character.
   *
   * @return string
   *   The character value.
   */
  public function getValue() {
    return $this->value;
  }

  /**
   * Determines if character is currently active.
   *
   * @return bool
   *   The acrive state.
   */
  public function isActive() {
    return $this->active;
  }

  /**
   * Determines if character is the "all" type.
   *
   * @return bool
   *   TRUE when value is "all".
   */
  public function isAll() {
    return $this
      ->getOption('paginate_all_value', 'all') === $this->value;
  }

  /**
   * Determines if character is currently enabled.
   *
   * @return bool
   *   The enabled state.
   */
  public function isEnabled() {
    return $this
      ->isAll() || $this
      ->isActive() || $this->enabled;
  }

  /**
   * Determines if character should render as a link.
   *
   * @return bool
   *   TRUE when the character should render as link.
   */
  public function isLink() {
    return !$this->active && ($this
      ->isEnabled() || $this
      ->isAll());
  }

  /**
   * Determines if character is numeric.
   *
   * @return bool
   *   TRUE for numeric character type.
   */
  public function isNumeric() {
    return $this->alphaPagination
      ->isNumeric($this->value);
  }

  /**
   * Sets whether character is enabled.
   *
   * @param mixed $enabled
   *   TRUE or FALSE.
   *
   * @return $this
   */
  public function setEnabled($enabled) {
    $this->enabled = (bool) $enabled;
    return $this;
  }

  /**
   * Sets whether character is active.
   *
   * @param mixed $active
   *   TRUE or FALSE.
   *
   * @return $this
   */
  public function setActive($active) {
    $this->active = (bool) $active;
    return $this;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
AlphaPaginationCharacter::$active	protected	property	Flag determining if character is currently active.
AlphaPaginationCharacter::$alphaPagination	protected	property	The AlphaPagination object reference.
AlphaPaginationCharacter::$enabled	protected	property	Flag determining if character is currently enabled.
AlphaPaginationCharacter::$label	protected	property	The human readable label of the character.
AlphaPaginationCharacter::$value	protected	property	The raw value of the character.
AlphaPaginationCharacter::build	public	function	Builds a render array of the character.
AlphaPaginationCharacter::buildLink	public	function	Builds a link render array based on current text, value and options.
AlphaPaginationCharacter::getLabel	public	function	Retrieves the set label for the character.
AlphaPaginationCharacter::getOption	protected	function	Retrieves an option from the view handler.
AlphaPaginationCharacter::getValue	public	function	Retrieves the set value for the character.
AlphaPaginationCharacter::isActive	public	function	Determines if character is currently active.
AlphaPaginationCharacter::isAll	public	function	Determines if character is the "all" type.
AlphaPaginationCharacter::isEnabled	public	function	Determines if character is currently enabled.
AlphaPaginationCharacter::isLink	public	function	Determines if character should render as a link.
AlphaPaginationCharacter::isNumeric	public	function	Determines if character is numeric.
AlphaPaginationCharacter::setActive	public	function	Sets whether character is active.
AlphaPaginationCharacter::setEnabled	public	function	Sets whether character is enabled.
AlphaPaginationCharacter::__construct	public	function	AlphaPaginationCharacter constructor.