php重寫分頁器CLinkPager的範例程式碼分享

php 重寫分頁器 CLinkPager的執行個體

1、自訂的分頁器類放在哪裡？

有兩個位置可以放，

第一種是放在 protected/extensions 中，在使用是import進來，或在config檔案中import進來；

第二種是放在 protected/components 中，作為組件存在，不需要import

2、用派生方式是最好的

class MyPager extends CLinkPager

入口函數是：public function run() ，當顯示分頁器時run()被調用，裡面的輸出就會顯示在相應位置；

其他的完全自訂，如果你不知道上一頁、下一頁、首頁、尾頁、總頁數、當前頁碼等資訊，可以參考CLinkPager的源碼，yii/frameworks/web/widgets/pagers/CLinkPager.php

<?phpclass MyPager extends CLinkPager{  const CSS_FIRST_PAGE='first';  const CSS_LAST_PAGE='last';  const CSS_PREVIOUS_PAGE='previous';  const CSS_NEXT_PAGE='next';  const CSS_INTERNAL_PAGE='page';  const CSS_HIDDEN_PAGE='hidden';  const CSS_SELECTED_PAGE='selected';  /**   * @var string the CSS class for the first page button. Defaults to 'first'.   * @since 1.1.11   */  public $firstPageCssClass=self::CSS_FIRST_PAGE;  /**   * @var string the CSS class for the last page button. Defaults to 'last'.   * @since 1.1.11   */  public $lastPageCssClass=self::CSS_LAST_PAGE;  /**   * @var string the CSS class for the previous page button. Defaults to 'previous'.   * @since 1.1.11   */  public $previousPageCssClass=self::CSS_PREVIOUS_PAGE;  /**   * @var string the CSS class for the next page button. Defaults to 'next'.   * @since 1.1.11   */  public $nextPageCssClass=self::CSS_NEXT_PAGE;  /**   * @var string the CSS class for the internal page buttons. Defaults to 'page'.   * @since 1.1.11   */  public $internalPageCssClass=self::CSS_INTERNAL_PAGE;  /**   * @var string the CSS class for the hidden page buttons. Defaults to 'hidden'.   * @since 1.1.11   */  public $hiddenPageCssClass=self::CSS_HIDDEN_PAGE;  /**   * @var string the CSS class for the selected page buttons. Defaults to 'selected'.   * @since 1.1.11   */  public $selectedPageCssClass=self::CSS_SELECTED_PAGE;  /**   * @var integer maximum number of page buttons that can be displayed. Defaults to 10.   */  public $maxButtonCount=10;  /**   * @var string the text label for the next page button. Defaults to 'Next >'.   */  public $nextPageLabel;  /**   * @var string the text label for the previous page button. Defaults to '< Previous'.   */  public $prevPageLabel;  /**   * @var string the text label for the first page button. Defaults to '<< First'.   */  public $firstPageLabel;  /**   * @var string the text label for the last page button. Defaults to 'Last >>'.   */  public $lastPageLabel;  /**   * @var string the text shown before page buttons. Defaults to 'Go to page: '.   */  public $header;  /**   * @var string the text shown after page buttons.   */  public $footer='';  /**   * @var mixed the CSS file used for the widget. Defaults to null, meaning   * using the default CSS file included together with the widget.   * If false, no CSS file will be used. Otherwise, the specified CSS file   * will be included when using this widget.   */  public $cssFile;  /**   * @var array HTML attributes for the pager container tag.   */  public $htmlOptions=array();  /**   * Initializes the pager by setting some default property values.   */  public function init()  {    if($this->nextPageLabel===null)      $this->nextPageLabel=Yii::t('yii','Next >');    if($this->prevPageLabel===null)      $this->prevPageLabel=Yii::t('yii','< Previous');    //if($this->firstPageLabel===null)    // $this->firstPageLabel=Yii::t('yii','<< First');    //if($this->lastPageLabel===null)    // $this->lastPageLabel=Yii::t('yii','Last >>');    if($this->header===null)      $this->header=Yii::t('yii','Go to page: ');    if(!isset($this->htmlOptions['id']))      $this->htmlOptions['id']=$this->getId();    if(!isset($this->htmlOptions['class']))      $this->htmlOptions['class']='yiiPager';  }  /**   * Executes the widget.   * This overrides the parent implementation by displaying the generated page buttons.   */  public function run()  {    $this->registerClientScript();    $buttons=$this->createPageButtons();    if(empty($buttons))      return;    echo $this->header;//   echo CHtml::tag('ul',$this->htmlOptions,implode("\n",$buttons));    echo implode("\n",$buttons);    echo $this->footer;  }  /**   * Creates the page buttons.   * @return array a list of page buttons (in HTML code).   */  protected function createPageButtons()  {    if(($pageCount=$this->getPageCount())<=1)      return array();    list($beginPage,$endPage,$ellipsis)=$this->getPageRange();    $currentPage=$this->getCurrentPage(false); // currentPage is calculated in getPageRange()    $buttons=array();    // first page    //$buttons[]=$this->createPageButton($this->firstPageLabel,0,$this->firstPageCssClass,$currentPage<=0,false);    // prev page    if(($page=$currentPage-1)<0)      $page=0;    if($currentPage == 0){      $buttons[] = "<span style='background:#a3a3a3'><上一頁</span>";    }else{      $buttons[]=$this->createPageButton($this->prevPageLabel,$page,$this->previousPageCssClass,$currentPage<=0,false);    }    // internal pages start    // first    $buttons[]=$this->createPageButton(1,0,$this->internalPageCssClass,false,$i==$currentPage);    //middle    if($ellipsis == 'both'){      $buttons[] = "<span style='background:#a3a3a3'>...</span>";    }    for($i=$beginPage;$i<=$endPage;++$i){      if($ellipsis == 'left' && $i == $beginPage){        $buttons[] = "<span style='background:#a3a3a3'>...</span>";      }      $buttons[]=$this->createPageButton($i+1,$i,$this->internalPageCssClass,false,$i==$currentPage);      if($ellipsis == 'right' && $i == $endPage){        $buttons[] = "<span style='background:#a3a3a3'>...</span>";      }    }      if($ellipsis == 'both'){      $buttons[] = "<span style='background:#a3a3a3'>...</span>";    }    // last    $buttons[]=$this->createPageButton($pageCount,$pageCount - 1,$this->internalPageCssClass,false,$i==$currentPage);    // internal pages end    // next page    if(($page=$currentPage+1)>=$pageCount-1)      $page=$pageCount-1;    if($currentPage == ($pageCount-1)){      $buttons[] = "<span style='background:#a3a3a3'>下一頁></span>";    }else{      $buttons[]=$this->createPageButton($this->nextPageLabel,$page,$this->nextPageCssClass,$currentPage>=$pageCount-1,false);    }    // last page    //$buttons[]=$this->createPageButton($this->lastPageLabel,$pageCount-1,$this->lastPageCssClass,$currentPage>=$pageCount-1,false);    return $buttons;  }  /**   * Creates a page button.   * You may override this method to customize the page buttons.   * @param string $label the text label for the button   * @param integer $page the page number   * @param string $class the CSS class for the page button.   * @param boolean $hidden whether this page button is visible   * @param boolean $selected whether this page button is selected   * @return string the generated button   */  protected function createPageButton($label,$page,$class,$hidden,$selected)  {    if($hidden || $selected)      $class.=' '.($hidden ? $this->hiddenPageCssClass : $this->selectedPageCssClass);    if ($selected) {      $result = "<span>" . ++$page . "</span>";    } else {      $result = CHtml::link($label,$this->createPageUrl($page));    }    return $result;  }  /**   * @return array the begin and end pages that need to be displayed.   */  protected function getPageRange()  {    $currentPage=$this->getCurrentPage();    $pageCount=$this->getPageCount();    /*$beginPage=max(0, $currentPage-(int)($this->maxButtonCount/2));    if(($endPage=$beginPage+$this->maxButtonCount-1)>=$pageCount)    {      $endPage=$pageCount-1;      $beginPage=max(0,$endPage-$this->maxButtonCount+1);    }*/    if($pageCount > $this->maxButtonCount){      if($currentPage > 4 && $currentPage < ($pageCount - 4)){        // print_r('a');        $beginPage = $currentPage - 2;        $endPage = $currentPage + 2;        $ellipsis = 'both';      }else{        $beginPage=max(1, $currentPage-(int)($this->maxButtonCount/2));        if($beginPage == 1){          $ellipsis = 'right';        }else{          $ellipsis = 'left';        }        if(($endPage=$beginPage+$this->maxButtonCount-1)>=$pageCount)        {          // print_r('b');          $endPage=$pageCount-2;          $beginPage=max(1,$endPage-$this->maxButtonCount+1);        }elseif(($endPage=$beginPage+$this->maxButtonCount-1)>=$pageCount-2){          // print_r('c');          $endPage=$pageCount-2;        }      }    }else{      $beginPage=max(1, $currentPage-(int)($this->maxButtonCount/2));      if(($endPage=$beginPage+$this->maxButtonCount-1)>=$pageCount)      {        $endPage=$pageCount-2;        $beginPage=max(1,$endPage-$this->maxButtonCount+1);      }    }    return array($beginPage,$endPage, $ellipsis);  }  /**   * Registers the needed client scripts (mainly CSS file).   */  public function registerClientScript()  {    if($this->cssFile!==false)      self::registerCssFile($this->cssFile);  }  /**   * Registers the needed CSS file.   * @param string $url the CSS URL. If null, a default CSS URL will be used.   */  public static function registerCssFile($url=null)  {    if($url===null)      $url=CHtml::asset(Yii::getPathOfAlias('system.web.widgets.pagers.pager').'.css');    Yii::app()->getClientScript()->registerCssFile($url);  }}

3、調用方式

在View裡的相應widget，定義pager的class為自訂的分頁器類名即可，參考：

$this->widget('zii.widgets.CListView', array(  'dataProvider'=>$dataProvider,  'itemView'=>'_view_t',  'pager'=>array(  'class'=>'MyPager', )));