Table des matières

View Helpers

La classe Phalcon\Tag fourni un ensemble de méthodes facilitant l'écriture des vues, avec phtml ou avec volt.

Elle est définie en tant que service et est accessible depuis les vues et les controlleurs.

-- Doctype

Définition du doctype dans le contrôleur : 

...
public function testAction(){
    $this->tag->setDoctype(\Phalcon\Tag::HTML401_STRICT);
    echo $this->view->render("test");
}

Utilisation du docType dans la vue : 

<?php echo $this->tag->getDocType();


{{ get_doctype() }}

Résultat 

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
	"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head></head>
...

-- Génération de liens

<!-- for the default route -->
<?= $this->tag->linkTo("products/search", "Search") ?>

<!-- with CSS attributes -->
<?= $this->tag->linkTo(array('products/edit/10', 'Edit', 'class' => 'edit-btn')) ?>

<!-- for a named route -->
<?= $this->tag->linkTo(array(array('for' => 'show-product', 'title' => 123, 'name' => 'carrots'), 'Show')) ?>

-- Création de formulaires

phtml

<?php
    $this->tag->form(array("products/search", "method" => "get"));
    $this->tag->endForm();

volt

{{ form("products/search", "method": "get") }}
{{end_form()}}

-- Éléments de formulaires

phtml

<?php 
echo $this->tag->textField("username");

echo $this->tag->textArea(array(
    "comment",
    "This is the content of the text-area",
    "cols" => "6",
    "rows" => 20
));

echo $this->tag->passwordField(array(
    "password",
    "size" => 30
));

echo $this->tag->hiddenField(array(
    "parent_id",
    "value"=> "5"
));

volt

{{ text_field("username") }}

{{ text_area("comment", "This is the content", "cols": "6", "rows": 20) }}

{{ password_field("password", "size": 30) }}

{{ hidden_field("parent_id", "value": "5") }}

-- Modification des valeurs des éléments

Les éléments de formulaire possédant un attribut value peuvent être affectés à la création :

phtml

<?php 
echo $this->tag->textField(array("username",value:"SMITH"));
echo $this->tag->textArea(array(
    "comment",
    "This is the content of the text-area",
    "cols" => "6",
    "rows" => 20
)) ?>

volt

{{ text_field("username","value":"SMITH") }}

{{ text_area("comment", "This is the content", "cols": "6", "rows": 20) }}

Il est également possible, préférable (pour l'architecture MVC) et inévitable pour certains tags (select par exemple) de faire cette affectation dans le contrôleur : 

class ProductsController extends Controller
{
    public function indexAction()
    {
        $this->tag->setDefault("username", "SMITH");
    }
}

-- Contenus statiques

Feuilles de style

phtml

<?php
    echo Phalcon\Tag::stylesheetLink("http://fonts.googleapis.com/css?family=Rosario", false);
    echo Phalcon\Tag::stylesheetLink("css/style.css");

volt

    {{ stylesheet_link("http://fonts.googleapis.com/css?family=Rosario", false) }}
    {{ stylesheet_link("css/style.css") }}

javascript file

phtml

<?php

         echo Phalcon\Tag::javascriptInclude("http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js", false);
         echo Phalcon\Tag::javascriptInclude("javascript/jquery.js");

volt

 {{ javascript_include("http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js", false) }}
 {{ javascript_include("javascript/jquery.js") }}

Images

phtml

<?php

         echo Phalcon\Tag::image("img/bg.png");
         echo Phalcon\Tag::image(array("img/photo.jpg", "alt" => "Some Photo"));

volt


         {{ image("img/bg.png") }}
         {{ image("img/photo.jpg", "alt": "Some Photo") }}
         {{ image("http://static.mywebsite.com/img/bg.png", false) }}