Moduł do tworzenia elementów widoku Opcje

[slawooo]

Chciałbym zaprezentować i poddać Waszej ocenie moduł ułatwiający oprogramowanie warstwy prezentacji (widoku) w modelu MVC.

W odróżnieniu od tego jak to standardowo bywa w różnych frameworkach PHP, tutaj widok nie jest "gołym" szablonem, nakładki typu smarty czy twig też nie mają z moim pomysłem nic wspólnego. Główna idea opiera się na potraktowaniu warstwy widoku jako kodu w pełni obiektowego, a więc korzystającego ze wszystkich korzyści z niego płynących, takich jak dziedziczenie, enkapsulacja itp.

Cała koncepcja opiera się na obiektach, które nazwałem komponentami. Chodzi tu po prostu o pewne odrębne elementy interfejsu - "komponenty" wizualne, rozumiane zupełnie dowolnie, jak np. menu, okno logowania, komentarze, galeria zdjęć czy cokolwiek innego widocznego na ekranie. Każdy z takich komponentów może składać się z zagnieżdżonych innych komponentów, a na samym "dole" znajdują się gotowe komponenty będące zwykłymi tagami HTML (lub w wyjątkowych przypadkach mogą to być też klasyczne szablony). Dzięki takiemu podejściu, budowanie elementów interfejsu jest prostsze, nie prowadzi do duplikowania kodu, no i kod nie wygląda jak oparty na include z PHP 4.x ;]

Moduł powstał przy tworzeniu aplikacji zbudowanej na frameworku kohana, ale bez większych akrobacji można go dopasować do własnych zastosowań.

Link do źródeł: https://github.com/SlawomirOlchawa/components

Ciekawy jestem Waszych opinii odnośnie takiego rozwiązania, odnośnie samego kodu również.
Przy okazji, jeśli ktoś spotkał się z podobnym podejściem w jakimś z frameworków to chętnie dowiem się więcej na ten temat.

Dla lepszego zrozumienia, przykładowe fragmenty kodu:

Widok:

[PHP] pobierz, plaintext 
class Component_Category_Info extends Tag_Block
{
    /**
     * @var Model_Category
     */
    protected $_category;
 
    /**
     * @param Model_Category $category
     */
    public function __construct(Model_Category $category)
    {
        parent::__construct();
 
        $this->_category = $category;
        Helper_Includer::addCSS('media/app/css/category.css');
    }
 
    /**
     * @return string
     */
    protected function _render()
    {
        $this->addCSSClass('category_info');
 
        $descriptionBlock = new Tag_Block($this->_category->description);
        $descriptionBlock->addCSSClass('lightBg');
        $descriptionBlock->addCSSClass('description');
 
        $this->add($descriptionBlock);
 
        return parent::_render();
    }
}
[PHP] pobierz, plaintext 

Kontroler:

[PHP] pobierz, plaintext 
class Controller_Category extends Controller_Entity
{
    public function action_index()
    {
        $info = new Component_Category_Info($this->_entity);
        $info->cache($this->_entity->getURL().'/info');
        $this->layout->add($info);
    }
}
[PHP] pobierz, plaintext 

Ten post edytował slawooo 5.11.2015, 02:08:34

[slawooo]

[PHP] pobierz, plaintext 
class Component_List extends Tag_Block
{
    /**
     * @var Model_Abstract_Entity
     */
    protected $_entities;
 
    /**
     * @var string
     */
    protected $_noResultsInfo = 'Brak wyników do wyświetlenia.';
 
    /**
     * @param Model_Abstract_Entity $entities
     */
    public function __construct(Model_Abstract_Entity $entities)
    {
        parent::__construct();
 
        $this->_entities = $entities;
    }
 
    /**
     * @param Model_Abstract_Entity $entity
     * @return Tag_HyperLink
     */
    protected function _getListItem(Model_Abstract_Entity $entity)
    {
        return new Tag_HyperLink($entity->name, $entity->getURL());
    }
 
    /**
     * @return string
     */
    protected function _render()
    {
        $entityList = $this->_entities->findAll();
 
        if ($entityList->count() === 0)
        {
            $info = new Tag_Paragraph($this->_noResultsInfo);
            $info->addCSSClass('light');
            $this->add($info);
        }
        else
        {
            $list = new Tag_List();
            $list->addCSSClass('light');
            $this->add($list);
 
            foreach ($entityList as $entity)
            {
                $link = $this->_getListItem($entity);
                $list->add($link);
            }
        }
 
        return parent::_render();
    }
}
[PHP] pobierz, plaintext 

[PHP] pobierz, plaintext 
class Component_ListWithPhotosSmall extends Component_List
{
    /**
     * @param Model_Abstract_Entity $entities
     */
    public function __construct(Model_Abstract_Entity $entities)
    {
        parent::__construct($entities);
 
        $this->addCSSClass('smallphoto_list');
 
        Helper_Includer::addCSS('media/mod/photos/css/main.css');
    }
 
    /**
     * @param Model_Abstract_Entity $entity
     * @return Tag_HyperLink
     */
    protected function _getListItem(Model_Abstract_Entity $entity)
    {
        $tile = new Component_Photo_TileSmall($entity->main_photo);
        $name = new Tag_HyperLink(Text::limit_chars($entity->name,45), $entity->getURL());
        $name->addCSSClass('name');
 
        $result = new Tag_Block();
        $result->add($tile);
        $result->add($name);
 
        return $result;
    }
}
[PHP] pobierz, plaintext 

Przykład komponentu zawierającego listę elementów. Komponent występuje w dwóch wersjach:
1) lista zawiera odnośniki tekstowe (klasa Component_List)
2) lista zawiera odnośniki graficzne (klasa Component_ListWithPhotosSmall)

Druga klasa dziedziczy po pierwszej całą logikę tworzenia i wyświetlania listy, nadpisując jedynie metodę wyświetlającą pojedynczy element listy.