devpontes/view

View é um componente simples para renderização de templates com PHP nativo

Maintainers

Details

github.com/moisespontes/view

Source

Issues

Installs: 32

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 0

Open Issues: 0

v4.0.0 2025-02-18 18:26 UTC

Requires

  • php: >=8.0

MIT ef6329342fa0dcfc2ac3de2d458efc4331457f82

  • Moises Pontes <sesiom_assis.woop@hotmail.com>

twigtemplatesviewsbladeplates

This package is auto-updated.

Last update: 2025-05-18 19:20:49 UTC

README

Maintainer Source Code PHP from Packagist Latest Version Software License Build Quality Score Total Downloads

About View componet

View is a simple component for rendering templates with native PHP.

View é um componente simples para renderização de templates com PHP nativo.

Highlights

  • Renderização simples de templates. (simple rendering of templates)
  • Controle dinâmico de ativos de JS e CSS. (dynamic Control of JS and CSS Assets)
  • Controle dinâmico do template HTML. (dynamic control of the HTML template)

Installation

View is available via Composer:

"devpontes/view": "4.0.*"

or run

composer require devpontes/view

Documentation

To use View you need to define the path to the views folder.
  1. Para utilizar o View você precisa definir o caminho para a pasta de views.
$viewPath = 'views';
At initialization, we need to pass the path to the views folder and the extension to the template file type as an argument.
  1. Na inicialização precisamos passar como argumento o caminho para a pasta de views e a extensão para o tipo de arquivo de templates.
$v = new \DevPontes\View\View($viewPath, 'php');
Use modifier methods to dynamically include parts of the template. Then, use the render method passing an array of data and the selected view. You can use either the slash (/) or the period (.) as a directory separator. For more details, see the example folder in the component directory.
  1. Use os métodos modificadores para incluir dinamicamente partes do template. Em seguida, utilize o método render passando um array de dados e a view selecionada. Você pode usar tanto a barra (/), quanto o ponto(.), como separador de diretórios. Para mais detalhes, veja a pasta de exemplo no diretório do componente.

Basic usage

/** set view data */
$user  = new \stdClass();
$user->name = "John Doe";
$user->age = 25;

$data['user'] = $user;

$v = new \DevPontes\View\View($viewPath, 'php');

$v->setHead('includes.head');
$v->setAside('includes.aside');
$v->setHeader('includes.header');
$v->setFooter('includes.footer');

$v->render('home', $data);

In the template

<main>
  <h5><?= "My name is {$user->name}, i am {$user->age} years" ?></h5>
</main>

Use the insert method to insert a component directly into the template

<?php $this->insert('components/article') ?>
Call addAssets by injecting an Assets object to manipulate JS and CSS assets through the makeScript and makeStyle methods. You can omit addAssets if the assets are inserted in the template itself, see
  1. Chame addAssets injetando um objeto de Assets para manipular os ativos de JS e CSS através dos métodos makeScript e makeStyle. Você pode omitir o addAssets caso os ativos sejam inseridos no próprio template, veja:

Add assets

/** assets array */
$css = ['style'];
$js = ['script'];

/** soucer path */
$source = 'assets';

/** define cache */
$cache = false;

$a = new \DevPontes\View\Assets('assets', false);

$v->addAssets($a);
$v->assets->makeScript($js);
$v->assets->makeStyle($css);

The default path for styles and scripts folders (css and js). Use modifier methods to change the pattern

  • O caminho padrão para pastas de estilos e scripts (css e js). Use métodos modificadores para alterar o padrão.
$v->setStylePath('style');
$v->setScriptPath('script');

Add CSS in <head>

<head>
  <title>View</title>
  <!-- add CSS -->
  <?= $this->assets->getStyles() ?>
</head>

Add JS in <body>

<body>
  ...
  <!-- add JS -->
  <?= $this->assets->getScripts() ?>
</body>

Credits

License

The MIT License (MIT).