Documentation

Table Of Contents

Previous topic

< Class Phalcon\Session\Exception

Next topic

Class Phalcon\Tag\Exception >

This Page

Class Phalcon\Tag

Phalcon\Tag is designed to simplify building of HTML tags. It provides a set of helpers to generate HTML in a dynamic way. This component is an abstract class that you can extend to add more helpers.

Constants

integer HTML32

integer HTML401_STRICT

integer HTML401_TRANSITIONAL

integer HTML401_FRAMESET

integer HTML5

integer XHTML10_STRICT

integer XHTML10_TRANSITIONAL

integer XHTML10_FRAMESET

integer XHTML11

integer XHTML20

integer XHTML5

Methods

public static getEscaper (unknown $params)

Obtains the ‘escaper’ service if required

public static string renderAttributes (unknown $code, unknown $attributes)

Renders parameters keeping order in their HTML attributes

public static setDI (unknown $dependencyInjector)

Sets the dependency injector container.

public static Phalcon\DiInterface getDI ()

Internally gets the request dispatcher

public static Phalcon\Mvc\UrlInterface getUrlService ()

Returns a URL service from the default DI

public static Phalcon\EscaperInterface getEscaperService ()

Returns an Escaper service from the default DI

public static setAutoescape (unknown $autoescape)

Set autoescape mode in generated html

public static setDefault (unknown $id, unknown $value)

Assigns default values to generated tags by helpers

<?php

 //Assigning "peter" to "name" component
 Phalcon\Tag::setDefault("name", "peter");

 //Later in the view
 echo Phalcon\Tag::textField("name"); //Will have the value "peter" by default

public static setDefaults (unknown $values, [unknown $merge])

Assigns default values to generated tags by helpers

<?php

 //Assigning "peter" to "name" component
 Phalcon\Tag::setDefaults(array("name" => "peter"));

 //Later in the view
 echo Phalcon\Tag::textField("name"); //Will have the value "peter" by default

public static displayTo (unknown $id, unknown $value)

Alias of Phalcon\Tag::setDefault

public static boolean hasValue (unknown $name)

Check if a helper has a default value set using Phalcon\Tag::setDefault or value from _POST

public static mixed getValue (unknown $name, [unknown $params])

Every helper calls this function to check whether a component has a predefined value using Phalcon\Tag::setDefault or value from _POST

public static resetInput ()

Resets the request and internal values to avoid those fields will have any default value

public static string linkTo (unknown $parameters, [unknown $text], [unknown $local])

Builds a HTML A tag using framework conventions

<?php

echo Phalcon\Tag::linkTo("signup/register", "Register Here!");
echo Phalcon\Tag::linkTo(array("signup/register", "Register Here!"));
echo Phalcon\Tag::linkTo(array("signup/register", "Register Here!", "class" => "btn-primary"));
echo Phalcon\Tag::linkTo("http://phalconphp.com/", "Phalcon", FALSE);
echo Phalcon\Tag::linkTo(array("http://phalconphp.com/", "Phalcon Home", FALSE));
echo Phalcon\Tag::linkTo(array("http://phalconphp.com/", "Phalcon Home", "local" =>FALSE));

final protected static string _inputField (unknown $type, unknown $parameters, [unknown $asValue])

Builds generic INPUT tags

final protected static string _inputFieldChecked (unknown $type, unknown $parameters)

Builds INPUT tags that implements the checked attribute

public static string colorField (unknown $parameters)

Builds a HTML input[type=”color”] tag

public static string textField (unknown $parameters)

Builds a HTML input[type=”text”] tag

<?php

echo Phalcon\Tag::textField(array("name", "size" => 30));

public static string numericField (unknown $parameters)

Builds a HTML input[type=”number”] tag

<?php

echo Phalcon\Tag::numericField(array("price", "min" => "1", "max" => "5"));

public static string rangeField (unknown $parameters)

Builds a HTML input[type=”range”] tag

public static string emailField (unknown $parameters)

Builds a HTML input[type=”email”] tag

<?php

echo Phalcon\Tag::emailField("email");

public static string dateField (unknown $parameters)

Builds a HTML input[type=”date”] tag

<?php

echo Phalcon\Tag::dateField(array("born", "value" => "14-12-1980"))

public static string dateTimeField (unknown $parameters)

Builds a HTML input[type=”datetime”] tag

public static string dateTimeLocalField (unknown $parameters)

Builds a HTML input[type=”datetime-local”] tag

public static string monthField (unknown $parameters)

Builds a HTML input[type=”month”] tag

public static string timeField (unknown $parameters)

Builds a HTML input[type=”time”] tag

public static string weekField (unknown $parameters)

Builds a HTML input[type=”week”] tag

public static string passwordField (unknown $parameters)

Builds a HTML input[type=”password”] tag

<?php

 echo Phalcon\Tag::passwordField(array("name", "size" => 30));

public static string hiddenField (unknown $parameters)

Builds a HTML input[type=”hidden”] tag

<?php

 echo Phalcon\Tag::hiddenField(array("name", "value" => "mike"));

public static string fileField (unknown $parameters)

Builds a HTML input[type=”file”] tag

<?php

 echo Phalcon\Tag::fileField("file");

public static string searchField (unknown $parameters)

Builds a HTML input[type=”search”] tag

public static string telField (unknown $parameters)

Builds a HTML input[type=”tel”] tag

public static string urlField (unknown $parameters)

Builds a HTML input[type=”url”] tag

public static string checkField (unknown $parameters)

Builds a HTML input[type=”check”] tag

<?php

 echo Phalcon\Tag::checkField(array("terms", "value" => "Y"));

public static string radioField (unknown $parameters)

Builds a HTML input[type=”radio”] tag

<?php

 echo Phalcon\Tag::radioField(array("weather", "value" => "hot"))

Volt syntax:

<?php

 {{ radio_field("Save") }}

public static string imageInput (unknown $parameters)

Builds a HTML input[type=”image”] tag

<?php

 echo Phalcon\Tag::imageInput(array("src" => "/img/button.png"));

Volt syntax:

<?php

 {{ image_input("src": "/img/button.png") }}

public static string submitButton (unknown $parameters)

Builds a HTML input[type=”submit”] tag

<?php

 echo Phalcon\Tag::submitButton("Save")

Volt syntax:

<?php

 {{ submit_button("Save") }}

public static string selectStatic (unknown $parameters, [unknown $data])

Builds a HTML SELECT tag using a PHP array for options

<?php

echo Phalcon\Tag::selectStatic("status", array("A" => "Active", "I" => "Inactive"))

public static string select (unknown $parameters, [unknown $data])

Builds a HTML SELECT tag using a Phalcon\Mvc\Model resultset as options

<?php

echo Phalcon\Tag::select(array(
    "robotId",
    Robots::find("type = "mechanical""),
    "using" => array("id", "name")
    ));

Volt syntax:

<?php

 {{ select("robotId", robots, "using": ["id", "name"]) }}

public static string textArea (unknown $parameters)

Builds a HTML TEXTAREA tag

<?php

 echo Phalcon\Tag::textArea(array("comments", "cols" => 10, "rows" => 4))

Volt syntax:

<?php

 {{ text_area("comments", "cols": 10, "rows": 4) }}

public static string form (unknown $parameters)

Builds a HTML FORM tag

<?php

 echo Phalcon\Tag::form("posts/save");
 echo Phalcon\Tag::form(array("posts/save", "method" => "post"));

Volt syntax:

<?php

 {{ form("posts/save") }}
 {{ form("posts/save", "method": "post") }}

public static string endForm ()

Builds a HTML close FORM tag

public static setTitle (unknown $title)

Set the title of view content

<?php

 Phalcon\Tag::setTitle("Welcome to my Page");

public static setTitleSeparator (unknown $titleSeparator)

Set the title separator of view content

<?php

 Phalcon\Tag::setTitleSeparator("-");

public static appendTitle (unknown $title)

Appends a text to current document title

public static prependTitle (unknown $title)

Prepends a text to current document title

public static string getTitle ([unknown $tags])

Gets the current document title

<?php

    echo Phalcon\Tag::getTitle();
<?php

    {{ get_title() }}

public static string getTitleSeparator ()

Gets the current document title separator

<?php

         echo Phalcon\Tag::getTitleSeparator();
<?php

         {{ get_title_separator() }}

public static string stylesheetLink ([unknown $parameters], [unknown $local])

Builds a LINK[rel=”stylesheet”] tag

<?php

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

Volt Syntax:

<?php

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

public static string javascriptInclude ([unknown $parameters], [unknown $local])

Builds a SCRIPT[type=”javascript”] tag

<?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 syntax:

<?php

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

public static string image ([unknown $parameters], [unknown $local])

Builds HTML IMG tags

<?php

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

Volt Syntax:

<?php

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

public static text friendlyTitle (unknown $text, [unknown $separator], [unknown $lowercase], [unknown $replace])

Converts texts into URL-friendly titles

<?php

 echo Phalcon\Tag::friendlyTitle("These are big important news", "-")

public static setDocType (unknown $doctype)

Set the document type of content

public static string getDocType ()

Get the document type declaration of content

public static string tagHtml (unknown $tagName, [unknown $parameters], [unknown $selfClose], [unknown $onlyStart], [unknown $useEol])

Builds a HTML tag

<?php

        echo Phalcon\Tag::tagHtml(name, parameters, selfClose, onlyStart, eol);

public static string tagHtmlClose (unknown $tagName, [unknown $useEol])

Builds a HTML tag closing tag

<?php

        echo Phalcon\Tag::tagHtmlClose("script", true)
Follow along: