anax/view

Anax View module.

Monday, April 23, 2018
by mikael_roos
Repository
1 Watchers
0 Stars
3,391 Installations

PHP
24 Dependents
0 Suggesters
2 Forks
1 Open issues
27 Versions
9 % Grown

The README.md

Anax View

, _(*1)

, _(*2)

, _(*3)

, _(*4)

Anax View module to supply a structure of views to a Anax website., _(*5)

About views, terminology and structure

The views, also known as template files, are pure PHP files and their purpose is to render content onto a html structure to create a web page., _(*6)

It works like this:, _(*7)

The content of the webpage is gathered as a collection of views.
The view collection is created in the router callbacks and controllers.
A view is a combination of variables (content), commonly known as $data, which is supplied to a template file, which is executed and renders the data onto a html structure.
Each view is a small part of html and content and rendered onto the web page.

You can see a sample of views in the directory view/anax/v2., _(*8)

Views are rendered in a layout

The views are rendered in an orderd fashion by a structured layout. This layout is in itself a view (template file and data), it is just a view which renders more views., _(*9)

You can see a sample of an layout view in view/anax/v2/layout., _(*10)

The layout views you above have organised each part of the web page as regions. Each view is rendered in a region., _(*11)

This code shows how a general region is setup in the layout file, and how it renders the views belonging to this region., _(*12)

<!-- flash -->
<?php if (regionHasContent("flash")) : ?>
<div class="outer-wrap outer-wrap-flash">
    <div class="inner-wrap inner-wrap-flash">
        <div class="row">
            <div class="region-flash">
                <?php renderRegion("flash") ?>
            </div>
        </div>
    </div>
</div>
<?php endif; ?>

You can optionally add a region, and a sort value, when you add the views to the collection. This is what decides where (region), and in what order the view is rendered., _(*13)

A template file for the view

A template file is an ordinary PHP-file. Here is the template file anax/v2/article/default., _(*14)

<article <?= classList($classes) ?>>
= $content ?>
</article>

The namespace makes it possible to access a list of built in view helper functions, for example helper functions to escape output or create urls into the framework or assets., _(*15)

namespace Anax\View;

The commented section can be uncommented for debugging what helper functions and what variables that are available., _(*16)

// Show incoming variables and view helper functions
//echo showEnvironment(get_defined_vars(), get_defined_functions());

The general idea is then to further prepare content through incoming variables., _(*17)

// Prepare classes
$classes[] = "article";
if (isset($class)) {
    $classes[] = $class;
}

Then finally render the output., _(*18)

<article <?= classList($classes) ?>>
<?= $content ?>
</article>

That is the general procedures of a template file., _(*19)

View helpers

The file View/ViewHelperFunctions holds the helper functions that eases work in the template files., _(*20)

Here are some essential helpers., _(*21)

Function	Details
`asset($url)`	Create a link to a static asset (css, img, php-file, pdf).
`e($str)`	A shortcut for `htmlentities().
`url($url)`	Create an url within the framework, for example `""` (home route) or `"doc/about"`.
`redirect($url)`	Redirect to another url (within the framework), for example `"game/init"`.

Review the helper files for details., _(*22)

Dumb views or fat views

A view can be "dumb" and only recive input from the framework, and render it with the html code., _(*23)

A view can also be "fat", or perhaps not so "smart", and make calls back into the framework., _(*24)

The general recomendation is to have dumb views and not make calls back into the framwork., _(*25)

Type of views

A view can generally render any type of result and is not limited to html only., _(*26)

License

This software carries a MIT license. See LICENSE.txt for details., _(*27)

 .  
..:  Copyright (c) 2013 - 2019 Mikael Roos, mos@dbwebb.se

The Versions

23/04 2018

dev-master

9999999-dev https://dbwebb.se/anax

Anax View module.

library view

Anax View module.

anax/view

The README.md

Anax View

About views, terminology and structure

Views are rendered in a layout

A template file for the view

View helpers

Dumb views or fat views

Type of views

License

The Versions

dev-master

The Requires

The Development Requires

by Mikael Roos

v1.0.26

The Requires

by Mikael Roos

v1.0.25

The Requires

by Mikael Roos

v1.0.24

The Requires

by Mikael Roos

v1.0.23

The Requires

by Mikael Roos

v1.0.22

The Requires

by Mikael Roos

v1.0.21

The Requires

by Mikael Roos

v1.0.20

The Requires

by Mikael Roos

v1.0.19

The Requires

by Mikael Roos

v1.0.18

The Requires

by Mikael Roos

v1.0.17

The Requires

by Mikael Roos

v1.0.16

The Requires

by Mikael Roos

v1.0.15

The Requires

by Mikael Roos

v1.0.14

The Requires

by Mikael Roos

v1.0.13

The Requires

by Mikael Roos

v1.0.12

The Requires

The Development Requires

by Mikael Roos

v1.0.11

The Requires

The Development Requires

by Mikael Roos

v1.0.10

The Requires

The Development Requires

by Mikael Roos

v1.0.9

The Requires

The Development Requires

by Mikael Roos

v1.0.8

The Requires

The Development Requires

by Mikael Roos

v1.0.7