October CMS - 快速入門 17 - 為組件添加選項

longmon 發(fā)布于2019-07-01 10:11 / 2875人閱讀

摘要：上一節(jié)我們通過組件為首頁添加了組件，顯示了演員的列表。但是，我們只是設(shè)置了選項，這個選項并沒有對數(shù)據(jù)進(jìn)行控制。演員排序?qū)ρ輪T排序以姓名升序排列以姓名降序排列好的，現(xiàn)在選項顯示出來。

上一節(jié)我們通過actor組件為首頁添加了組件，顯示了演員的列表。
下面我們將為組件添加一些屬性：defineProperties
這個函數(shù)會返回一個數(shù)組，數(shù)組里面的每個數(shù)組將返回的是每個選項

添加顯示演員個數(shù)限制的選項

File:plugins
aiseinfomoviescomponentsActors.php

    public function defineProperties()
    {
        return [
          "results" =>  [
              "title" => "顯示演員的個數(shù)",
              "description" => "您希望顯示多少個演員？",
              "default" => 0,
              "validationPattern" => "^[0-9]+$",
              "validationMessage" => "只允許輸入數(shù)字。"
          ]
        ];
    }

但是，我們只是設(shè)置了選項，這個選項并沒有對數(shù)據(jù)進(jìn)行控制。下面解決使用這個選項控制數(shù)據(jù)的顯示：

File:plugins
aiseinfomoviescomponentsActors.php

    protected function loadActors()
    {
        $query = Actor::all();
        if($this->property("results") > 0){
            $query = $query->take($this->property("results"));
        }
        return $query;
    }

控制演員排序規(guī)則

File:plugins
aiseinfomoviescomponentsActors.php

    public function defineProperties()
    {
        return [
          "results" =>  [
              "title" => "顯示演員的個數(shù)",
              "description" => "您希望顯示多少個演員？",
              "default" => 0,
              "validationPattern" => "^[0-9]+$",
              "validationMessage" => "只允許輸入數(shù)字。"
          ],

          "sortOrder" => [
              "title" => "演員排序",
              "description" => "對演員排序",
              "type" => "dropdown",
              "default" => "name asc"
          ]

        ];
    }

File:plugins
aiseinfomoviescomponentsActors.php

    public function getSortOrderOptions()
    {
        return [
            "name asc" => "以姓名升序排列",
            "name desc" => "以姓名降序排列"
        ];
    }

好的，現(xiàn)在選項顯示出來。接下來實現(xiàn)對數(shù)據(jù)的控制

File:plugins
aiseinfomoviescomponentsActors.php

protected function loadActors()
    {
        $query = Actor::all();

        if($this->property("sortOrder") == "name asc"){
            $query = $query->sortBy("name");
        }

        if($this->property("sortOrder") == "name desc"){
            $query = $query->sortByDesc("name");
        }

        if($this->property("results") > 0){
            $query = $query->take($this->property("results"));
        }
        return $query;
    }