popphp/pop-view

Pop View Component for Pop PHP Framework

Monday, January 29, 2018
by nicksagona
Repository
1 Watchers
2 Stars
1,808 Installations

PHP
5 Dependents
1 Suggesters
0 Forks
0 Open issues
16 Versions
3 % Grown

The README.md

pop-view

, _(*1)

, _(*2)

Overview
Install
Quickstart
File Template
Stream Template

Overview

pop-view is the view template component that can be used as the "V" in an MVC stack or independently as well. It supports using both PHP-file based templates and stream templates. Within the stream templates, there is basic support for logic and iteration for dynamic control over the view template., _(*3)

pop-view is a component of the Pop PHP Framework., _(*4)

Top, _(*5)

Install

Install pop-view using Composer., _(*6)

composer require popphp/pop-view

Or, require it in your composer.json file, _(*7)

"require": {
    "popphp/pop-view" : "^4.0.3"
}

Top, _(*8)

Quickstart

Consider a phtml template file like this:, _(*9)

<html>
<body>
    <h1><?=$title; ?></h1>
</body>
</html>

You can set up a view object and populate data like this:, _(*10)

use Pop\View\View;
use Pop\View\Template\File;

$view        = new View(new File('hello.phtml'));
$view->title = 'Hello World!';

echo $view;

which will produce:, _(*11)

<html>
<body>
    <h1>Hello World!</h1>
</body>
</html>

Top, _(*12)

File Template

A file template simply uses PHP variables to deliver the data and content to template to be rendered. With a file template, you have full access to the PHP environment to write any additional code or helper scripts. However, in using this, you must make sure to adhere to the best practices and standards regarding the security of the application., _(*13)

hello.phtml

<!DOCTYPE html>
<html>
<head>
    <title><?=$title; ?></title>
</head>
<body>
    <h1><?=$title; ?></h1>
    <p><?=$content; ?></p>
</body>
</html>

You can set up the view object like this:, _(*14)

use Pop\View\View;
use Pop\View\Template\File;

$view = new View(new File('hello.phtml'));
$view->title   = 'Hello World!';
$view->content = 'This is a test!';

echo $view;

Top, _(*15)

Stream Template

A stream template uses a formatted string placeholder to deliver the data and content to template to be rendered:, _(*16)

hello.html

<!DOCTYPE html>
<html>
<head>
    <title>[{title}]</title>
</head>
<body>
    <h1>[{title}]</h1>
    <p>[{content}]</p>
</body>

</html>

You can set up the view object in a similar way and it will render the exact same as the file template example., _(*17)

use Pop\View\View;
use Pop\View\Template\Stream;

$view = new View(new Stream('hello.html'));
$view->title   = 'Hello World!';
$view->content = 'This is a test!';

echo $view;

Top, _(*18)

Includes

Stream templates support includes to allow you to include other templates within them., _(*19)

header.html


<!DOCTYPE html>
<html>

<head>
    <title>[{title}]</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>

<body>
    <header>This is the header</header>

footer.html


    <footer>This is the footer</footer>
</body>

</html>

index.html

<!-- index.html //-->
{{@include header.html}}
    <h1>[{title}]</h1>
    <p>[{content}]</p>
{{@include footer.html}}

You can set up the view object like before:, _(*20)

use Pop\View\View;
use Pop\View\Template\Stream;

$view = new View(new Stream('index.html'));
$view->title   = 'Hello World!';
$view->content = 'This is a test!';

echo $view;

Top, _(*21)

Inheritance

Stream templates support inheritance to allow you to extend other templates., _(*22)

parent.html


<!DOCTYPE html>
<html>

<head>
{{header}}
    <title>[{title}]</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
{{/header}}
</head>

<body>
    <h1>[{title}]</h1>
    [{content}]
</body>

</html>

child.html


{{@extends parent.html}}

{{header}}
{{parent}}
    <style>
        body { margin: 0; padding: 0; color: #bbb;}
    </style>
{{/header}}

You can set up the view object like before:, _(*23)

use Pop\View\View;
use Pop\View\Template\Stream;

$view = new View(new Stream('child.html'));
$view->title   = 'Hello World!';
$view->content = 'This is a test!';

echo $view;

Top, _(*24)

Iteration

Iteration is possible in stream templates when working with arrays and array-like objects., _(*25)


<!DOCTYPE html>
<html>

<head>
    <title>[{title}]</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>

<body>

[{items}]



[{key}]: [{value}]


[{/items}]

</body>

</html>

use Pop\View\View;
use Pop\View\Template\Stream;

$data = [
    'items' => [
        'hello' => 'world',
        'foo'   => 'bar',
        'baz'   => 123
    ]
];

$view = new View(new Stream('index.html'), $data);

echo $view;

Top, _(*26)

Conditionals

Conditional logic is possible within a stream template as well., _(*27)


<!DOCTYPE html>
<html>

<head>
    <title>[{title}]</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>

<body>

[{if(foo)}]


The variable 'foo' is set to [{foo}]., _(*28)


[{else}]


The variable 'foo' is not set., _(*29)


[{/if}]

</body>

</html>

use Pop\View\View;
use Pop\View\Template\Stream;

$data = ['foo' => 'bar'];

$view = new View(new Stream('index.html'), $data);

echo $view;

Top, _(*30)

The Versions

29/01 2018

dev-master

9999999-dev http://www.popphp.org/

Pop View Component for Pop PHP Framework

library pop-view

Pop View Component for Pop PHP Framework

popphp/pop-view

The README.md

pop-view

Overview

Install

Quickstart

File Template

hello.phtml

Stream Template

hello.html

Includes

header.html

footer.html

index.html

Inheritance

parent.html

child.html

Iteration

Conditionals

The Versions

dev-master

The Requires

The Development Requires

by Nick Sagona

dev-v3-dev

The Requires

The Development Requires

by Nick Sagona

3.0.2

The Requires

The Development Requires

by Nick Sagona

v2.x-dev

The Requires

The Development Requires

by Nick Sagona

3.0.1

The Requires

The Development Requires

by Nick Sagona

3.0.0

The Requires

The Development Requires

by Nick Sagona

2.1.1

The Requires

The Development Requires

by Nick Sagona

2.1.0

The Requires

The Development Requires

by Nick Sagona

2.0.0p7

The Requires

The Development Requires

by Nick Sagona

2.0.0p6

The Requires

The Development Requires

by Nick Sagona

2.0.0p5

The Requires

The Development Requires

by Nick Sagona

2.0.0p4

The Requires

The Development Requires

by Nick Sagona

2.0.0p3

The Requires

The Development Requires

by Nick Sagona

2.0.0p2

The Requires

The Development Requires

by Nick Sagona

2.0.0p1

The Requires