phpMv UI
Callista 2.4.16 release
Biblioteca de componentes visuais (JQuery UI, Twitter Bootstrap, Semantic-UI) para frameworks php e php MVC
Site phpMv-UI
phpMv-UI é uma biblioteca de componentes visuais para php: um wrapper php para jQuery e componentes de UI (jQuery, Twitter Bootstrap, Semantic-UI).
Utilizando a injeção de dependência, o objeto jQuery pode ser injetado no contêiner do framework php , permitindo a geração de scripts jQuery em controladores, respeitando o padrão de design MVC.
Instale o Composer em um local comum ou em seu projeto:
curl -s http://getcomposer.org/installer | phpCrie o arquivo compositor.json no diretório app da seguinte forma:
{
"require" : {
"phpmv/php-mv-ui" : " ^2.3 "
}
}No diretório do aplicativo, execute o instalador do compositor:
php composer.phar installBasta clonar o repositório em um local comum ou dentro do seu projeto:
git clone https://github.com/phpMv/phpMv-UI.git
phpMv-UI está em conformidade com as recomendações PSR-4 para classes de carregamento automático. Qualquer que seja o framework php utilizado, com o "composer", basta integrar o arquivo autoload do Composer.
require_once ( " vendor/autoload.php " );A biblioteca já está carregada por padrão no arquivo de configuração app/config/config.php :
" di " => array (
" @exec " => array ( " jquery " => function ( $ controller ){
return Ajax php ubiquity JsUtils:: diSemantic ( $ controller );
})
),Exemplo de criação de um botão Semantic-UI
/**
* @property AjaxphpubiquityJsUtils $jquery
*/
class ExempleController extends Controller{
public function index (){
$ semantic = $ this -> jquery -> semantic ();
$ button = $ semantic -> htmlButton ( " btTest " , " Test Button " );
echo $ button ;
}
}Sem o Composer, é possível carregar a biblioteca com o arquivo app/config/loader.php :
$ loader = new Phalcon Loader ();
$ loader -> registerNamespaces ( array (
' Ajax ' => __DIR__ . ' /../vendor/phpmv/php-mv-ui/Ajax/ '
))-> register ();É necessário injetar o serviço JQuery na inicialização da aplicação, no arquivo de serviço app/config/services.php , e se necessário instanciar Semantic, Bootstrap ou Jquery-ui :
$ di -> set ( " jquery " , function (){
$ jquery = new Ajax php phalcon JsUtils ();
$ jquery -> semantic ( new Ajax Semantic ()); //for Semantic UI
return $ jquery ;
});Exemplo de criação de um botão Semantic-UI
use Phalcon Mvc Controller ;
use Ajax php phalcon JsUtils ;
/**
* @property JsUtils $jquery
*/
class ExempleController extends Controller{
public function indexAction (){
$ semantic = $ this -> jquery -> semantic ();
$ button = $ semantic -> htmlButton ( " btTest " , " Test Button " );
echo $ button ;
}
} Se você quiser que o CodeIgniter use um carregador automático do Composer, basta definir $config['composer_autoload'] como TRUE ou um caminho personalizado em application/config/config.php .
Então é necessário criar uma biblioteca para a classe JsUtils
Crie a biblioteca XsUtils (o nome é gratuito) na pasta application/libraries
use Ajax php ci JsUtils ;
class XsUtils extends Ajax php ci JsUtils{
public function __construct (){
parent :: __construct ([ " semantic " => true , " debug " => false ]);
}
}Adicione o carregamento da biblioteca XsUtils no arquivo application/config/autoload.php
O membro jquery estará acessível nos controladores
$ autoload [ ' libraries ' ] = array ( ' XsUtils ' => ' jquery ' );Depois de carregado, você pode acessar sua classe nos controladores usando o membro $jquery :
$ this -> jquery -> some_method ();Se você não usa o arquivo autoloader do Composer, você também pode carregar o phpMv-UI com o compositor.json :
"autoload" : {
"classmap" : [
...
],
"psr-4" : {
"Ajax \ " : " vendor/phpmv/php-mv-ui/Ajax "
}
},Registre um Singleton no arquivo bootstrap/app.php :
$ app -> singleton ( Ajax php laravel JsUtils::class, function ( $ app ){
$ result = new Ajax php laravel JsUtils ();
$ result -> semantic ( new Ajax Semantic ());
return $ result ;
});Então é possível injetar a classe JsUtils no construtor dos controladores da classe base:
use Ajax php laravel JsUtils ;
class Controller extends BaseController{
use AuthorizesRequests, AuthorizesResources, DispatchesJobs, ValidatesRequests;
protected $ jquery ;
public function __construct ( JsUtils $ js ){
$ this -> jquery = $ js ;
}
public function getJquery () {
return $ this -> jquery ;
}
}As classes nos pacotes instalados do Composer podem ser carregadas automaticamente usando o autoloader do Composer. Certifique-se de que o script de entrada do seu aplicativo contenha as seguintes linhas para instalar o autoloader do Composer:
require ( __DIR__ . ' /../vendor/autoload.php ' );
require ( __DIR__ . ' /../vendor/yiisoft/yii2/Yii.php ' );No mesmo arquivo, registre uma nova dependência:
Yii:: $ container -> setSingleton ( " AjaxphpyiiJsUtils " ,[ " bootstrap " => new Ajax Semantic ()]);O singleton JsUtils pode então ser injetado nos controladores
namespace app controllers ;
use yii web Controller ;
use Ajax php yii JsUtils ;
class SiteController extends Controller{
protected $ jquery ;
public function __construct ( $ id , $ module , JsUtils $ js ){
parent :: __construct ( $ id , $ module );
$ this -> jquery = $ js ;
}
}Se você não usa o arquivo autoloader do Composer, você também pode carregar o phpMv-UI com Ps4ClassLoader :
use Symfony Component ClassLoader Psr4ClassLoader ;
require __DIR__ . ' /lib/ClassLoader/Psr4ClassLoader.php ' ;
$ loader = new Psr4ClassLoader ();
$ loader -> addPrefix ( ' Ajax \' , __DIR__ . ' /lib/phpmv/php-mv-ui/Ajax ' );
$ loader -> register (); Crie um serviço herdado de JquerySemantic
namespace App Services semantic ;
use Ajax php symfony JquerySemantic ;
class SemanticGui extends JquerySemantic{
}Verifique se a ligação automática está ativada em config/services.yml :
services :
# default configuration for services in *this* file
_defaults :
autowire : true # Automatically injects dependencies in your services.Você pode então usar injeção de dependência em propriedades, construtores ou setters:
namespace App Controller ;
use Symfony Bundle FrameworkBundle Controller AbstractController ;
use App Services semantic SemanticGui ;
BarController extends AbstractController{
/**
* @var SemanticGui
*/
protected $ gui ;
public function loadViewWithAjaxButtonAction (){
$ bt = $ this -> gui -> semantic ()-> htmlButton ( ' button1 ' , ' a button ' );
$ bt -> getOnClick ( " /url " , ' #responseElement ' );
return $ this -> gui -> renderView ( " barView.html.twig " );
}
}Crie 2 serviços no arquivo app/config/services.yml :
parameters :
jquery.params :
semantic : true
services :
jquery :
class : AjaxphpsymfonyJsUtils
arguments : [%jquery.params%,'@router']
scope : request
app.default_controller :
class : AppBundleControllerDefaultController
arguments : ['@service_container','@jquery']É então possível injetar o contêiner Symfony e o serviço JsUtils no construtor do controlador:
namespace AppBundle Controller ;
use Sensio Bundle FrameworkExtraBundle Configuration Route ;
use Symfony Bundle FrameworkBundle Controller Controller ;
use Symfony Component DependencyInjection ContainerInterface ;
use Ajax php symfony JsUtils ;
use AppBundle AppBundle ;
/**
* @Route(service="app.default_controller")
*/
class DefaultController extends Controller{
/**
* @var AjaxphpsymfonyJsUtils
*/
protected $ jquery ;
public function __construct ( ContainerInterface $ container , JsUtils $ js ){
$ this -> container = $ container ;
$ this -> jquery = $ js ;
}
}Copie o arquivo JsUtilsComponent.php localizado em vendor/phpmv/php-mv-ui/Ajax/php/cakephp para a pasta src/controller/component do seu projeto
Adicione o carregamento do componente JsUtils no método de inicialização do controlador base AppController , localizado em src/controller/appController.php
public function initialize (){
parent :: initialize ();
$ this -> loadComponent ( ' RequestHandler ' );
$ this -> loadComponent ( ' Flash ' );
$ this -> loadComponent ( ' JsUtils ' ,[ " semantic " => true ]);
} o objeto jquery no controlador estará acessível em $this->JsUtils->jquery
Com a maioria dos IDEs (como Eclipse ou phpStorm), para obter a conclusão do código na instância $jquery , você deve adicionar a seguinte propriedade na documentação do controlador:
/**
* @property AjaxJsUtils $jquery
*/
class MyController{
}
