Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pollen-solutions/partial
Pollen Solutions - Partial Component - Layer and tools for creating reusable web user interfaces
https://github.com/pollen-solutions/partial
partial php
Last synced: 6 days ago
JSON representation
Pollen Solutions - Partial Component - Layer and tools for creating reusable web user interfaces
- Host: GitHub
- URL: https://github.com/pollen-solutions/partial
- Owner: pollen-solutions
- License: mit
- Created: 2021-08-17T09:37:28.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-08-18T07:21:33.000Z (over 3 years ago)
- Last Synced: 2024-05-05T00:40:20.490Z (7 months ago)
- Topics: partial, php
- Language: PHP
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Partial Component
[](https://packagist.org/packages/pollen-solutions/partial)
[](LICENSE.md)
[](https://www.php.net/supported-versions.php)
Pollen Solutions **Partial** Component provides layer and tools for creating reusable web user interfaces.
## Installation
```bash
composer require pollen-solutions/partial
```
## Basic Usage
### From a callable
```php
use Pollen\Partial\PartialManager;
$partial = new PartialManager();
$partial->register('hello', function () {
return 'Hello World !';
});
echo $partial->get('hello');
```
### From the default partial tag driver
```php
use Pollen\Partial\PartialManager;
$partial = new PartialManager();
$partial->register('hello');
echo $partial->get('hello', ['content' => 'Hello World !']);
```
### From a custom driver
```php
use Pollen\Partial\PartialDriver;
use Pollen\Partial\PartialManager;
class HelloPartial extends PartialDriver
{
public function render() : string{
return 'Hello World !';
}
}
$partial = new PartialManager();
$partial->register('hello', HelloPartial::class);
echo $partial->get('hello');
```
### Through a PSR-11 depency injection container
```php
use Pollen\Container\Container;
use Pollen\Partial\PartialDriver;
use Pollen\Partial\PartialManager;
$container = new Container();
$partial = new PartialManager();
$partial->setContainer($container);
class HelloPartial extends PartialDriver
{
public function render() : string{
return 'Hello World !';
}
}
$container->add('helloPartialService', HelloPartial::class);
$partial->register('hello', 'helloPartialService');
echo $partial->get('hello');
```
### Shows a partial driver instance with custom parameters
```php
use Pollen\Partial\PartialDriverInterface;
use Pollen\Partial\PartialManager;
$partial = new PartialManager();
$partial->register('hello', function (PartialDriverInterface $driver) {
return 'Hello '. $driver->get('name') .' !';
});
echo $partial->get('hello', ['name' => 'John Doe']);
```
### Recalls the same partial driver instance with keeped custom parameters
```php
use Pollen\Partial\PartialDriverInterface;
use Pollen\Partial\PartialManager;
$partial = new PartialManager();
$partial->register('hello', function (PartialDriverInterface $driver) {
return 'Hello '. $driver->get('name') .' !
';
});
echo $partial->get('hello', 'HelloJohn', ['name' => 'John Doe']);
echo $partial->get('hello', 'HelloJane', ['name' => 'Jane Doe']);
echo $partial->get('hello', 'HelloJohn');
```
## Partial driver API
### Partial driver parameters of call
```php
use Pollen\Partial\PartialDriverInterface;
use Pollen\Partial\PartialManager;
$partial = new PartialManager();
$tag = $partial->get('tag', [
/**
* Common driver parameters.
* --------------------------------------------------------------------------
*/
/**
* Main container HTML tag attributes.
* @var array $attrs
*/
'attrs' => [
'class' => '%s MyAppendedClass'
],
/**
* Content displayed after the main container.
* @var string|callable $after
*/
'after' => 'content show after',
/**
* Content displayed before the main container.
* @var string|callable $before
*/
'before' => function (PartialDriverInterface $driver) {
return 'content show before'
},
/**
* List of parameters of the template view|View instance.
* {@internal See below in the View API usage section.}
* @var array|ViewInterface $view
*/
'view' => [],
/**
* Tag partial driver parameters
* --------------------------------------------------------------------------
*/
/**
* HTML tag.
* @var string $tag div|span|a|... default div.
*/
'tag' => 'div',
/**
* HTML tag content.
* @var string|callable $content
*/
'content' => '',
/**
* Enable tag as singleton.
* {@internal Auto-resolve if null based on list of known singleton tags.}
* @var bool|null $singleton
*/
'singleton' => null,
]);
echo $tag;
```
### Partial driver instance methods
```php
use Pollen\Field\FieldManager;
$field = new FieldManager();
$field->register('hello', function () {
return 'Hello World';
});
if ($hello = $partial->get('hello')) {
// Gets alias identifier.
printf('alias: %s
', $hello->getAlias());
// Gets the base prefix of HTML class.
printf('base HTML class: %s
', $hello->getBaseClass());
// Gets the unique identifier.
printf('identifier: %s
', $hello->getId());
// Gets the index in related partial manager.
printf('index: %s
', $hello->getIndex());
}
```
### View API usage
#### Plates view engine
Partial driver used Plates as default template engine.
1. Creates a view file for the partial driver.
```php
// /var/www/html/views/partial/hello.plates.php file
/**
* \Pollen\Partial\PartialTemplateInterface $this
*/
echo 'Hello World !';
```
2. Creates and call a partial driver with this above file directory as view directory.
```php
use Pollen\Partial\PartialDriver;
use Pollen\Partial\PartialManager;
$partial = new PartialManager();
$partial->register('hello', new class extends PartialDriver{});
echo $partial->get('hello', ['view' => [
/**
* View directory absolute path (required).
* @var string
*/
'directory' => '/var/www/html/views/partial/',
/**
* View override directory absolute path.
* @var string|null
*/
'override_dir' => null,
/**
* View render main template name. index is used by default if its null.
* @var string|null
*/
'template_name' => 'hello'
]]);
```
#### Uses another view engine
Your are free to used your own instance of Pollen\View\ViewInterface as the partial driver view parameter if needed. In
this example Twig engine is used instead Plates.
1. Creates a view file for the partial driver.
```html
Hello World !
```
2. Creates and call a partial driver with this above file directory as view directory.
```php
use Pollen\View\ViewManager;
use Pollen\Partial\PartialDriver;
use Pollen\Partial\PartialManager;
$partial = new PartialManager();
$partial->register('hello', new class extends PartialDriver{});
$viewEngine = (new ViewManager())->createView('twig')->setDirectory('/var/www/html/views/partial/hello/');
echo $partial->get('hello', ['view' => $viewEngine]);
```
### Routing API usage
In some cases, partial driver should be able to send a response through a controller, for example to respond from a rest
api call.
Fortunately, all partial driver instance are related to a route stack and have a reponseController method to do that.
The partial driver route stack is created for all known HTTP methods (GET, POST, PATH, OPTIONS, DELETE) and for a
particular api method that works with XHR HTTP request.
1. Creates a partial driver and gets its route url for the get http method.
```php
use Pollen\Http\Response;
use Pollen\Http\ResponseInterface;
use Pollen\Partial\PartialDriver;
use Pollen\Partial\PartialManager;
$partial = new PartialManager();
$partial->register('hello', new class extends PartialDriver {
public function responseController(...$args) : ResponseInterface {
return new Response('Hello World !');
}
});
// Gets the route url for the get HTTP method
echo $partial->getRouteUrl('hello', null, [], 'get');
```
2. Now you can call the route url in your browser.
[Get the partial response](/_partial/hello/responseController)
Obviously, you are free to use your own routing stack and them controller methods instead.