Char.php

Go to the documentation of this file.

<?php

namespace Rsi\Fred\Controller\Widget;

class Char extends \Rsi\Fred\Controller\Widget{

  //format options
  const SIZE = 'size'; //!< Size of field.
  const PLACEHOLDER = 'placeholder';
  const SUGGEST = 'suggest'; //!< Suggestion optiones. This can be an assoc.array, a callback function (called with all extra
    // parameters as an array), an SQL query, a reference to a database field in 'table.field' format, or a translatable string
    // (options split by line feed, key and value seperated by '=').
  const NOTATION = 'notation'; //!< Regular expression describing the prefered notation style (e.g. '/^[A-z]/' = start with a
    // capital).
  const TRANSFORM = 'transform'; //!< Transform the value (see \\Rsi\\Str::TRANSFORM_* constants).
  const TRIM = 'trim'; //!< Strip these characters from the beginning and end of the value (true for regular whitespace).

  //checks
  const REGEX = 'regex';

  public $regex = null;
  public $size = null;
  public $placeholder = null;
  public $suggest = null;
  public $suggestLimit = 10;
  public $notation = null;
  public $transform = null;
  public $trim = null;

  public function clientConfig(){
    $config = array_merge(parent::clientConfig(),$this->get([self::NOTATION,self::TRANSFORM,self::REGEX,self::TRIM]));
    if($this->suggest) $config[self::SUGGEST] = true;
    return $config;
  }

  public function formatTag($value){
    return $this->local->formatInt($value);
  }

  protected function purgeBase($value){
    return $value && is_string($value) ? $value : null;
  }

  protected function purgeTransform($value){
    return $this->transform && !$this->nothing($value) ? \Rsi\Str::transform($value,$this->transform) : $value;
  }

  protected function purgeTrim($value){
    return $this->trim ? trim($value,$this->trim === true ? " \t\n\r" : $this->trim) : $value;
  }

  protected function checkMin($value,$index = null){
    return !$this->min || (mb_strlen($value) >= $this->min);
  }

  protected function checkMax($value,$index = null){
    return !$this->max || (mb_strlen($value) <= $this->max);
  }

  protected function checkRegex($value,$index = null){
    return !$this->regex || preg_match($this->regex,$value);
  }

  protected function actionSuggest(){
    if(is_callable($suggest = $this->suggest))
      $suggest = call_user_func($suggest,$this->params);
    elseif(is_string($suggest)){
      if($this->db->isSelection($suggest))
        $suggest = $this->db->record($suggest,$this->params);
      elseif(!preg_match('/^(\\w+)\\.(\\w+)$/',$suggest,$match))
        $suggest = \Rsi\Record::explode($this->trans->str($suggest),"\n",'=');
      elseif(($count = count($suggest = $this->db->record(
        $this->db->limit($sql = "
          select distinct(`$match[2]`) from `$match[1]`
          where `$match[2]` like :this
          order by `$match[2]`",
          $this->suggestLimit
        ),
        ['this' => $value = $this->params['this'] . '%']
      ))) < $this->suggestLimit) $suggest = array_merge($suggest,$this->db->record(
        $this->db->limit($sql,$this->suggestLimit - $count),
        ['this' => '_%' . $value]
      ));
    }
    $this->request->result = ['suggest' => $suggest];
  }

  protected function getParams(){
    return array_merge(parent::getParams(),['this' => $this->request->this]);
  }

}