Class Phalcon\Tag

Source on GitHub

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 EscaperInterface getEscaper (array $params)

Obtains the ‘escaper’ service if required

public static renderAttributes (mixed $code, array $attributes)

Renders parameters keeping order in their HTML attributes

public static setDI (Phalcon\DiInterface $dependencyInjector)

Sets the dependency injector container.

public static getDI ()

Internally gets the request dispatcher

public static getUrlService ()

Returns a URL service from the default DI

public static getEscaperService ()

Returns an Escaper service from the default DI

public static setAutoescape (mixed $autoescape)

Set autoescape mode in generated html

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

Assigns default values to generated tags by helpers

  1. <?php
  3. // Assigning "peter" to "name" component
  4. Phalcon\Tag::setDefault("name", "peter");
  6. // Later in the view
  7. echo Phalcon\Tag::textField("name"); // Will have the value "peter" by default

public static setDefaults (array $values, [mixed $merge])

Assigns default values to generated tags by helpers

  1. <?php
  3. // Assigning "peter" to "name" component
  4. Phalcon\Tag::setDefaults(
  5.     [
  6.         "name" => "peter",
  7.     ]
  8. );
  10. // Later in the view
  11. echo Phalcon\Tag::textField("name"); // Will have the value "peter" by default

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

Alias of Phalcon\Tag::setDefault

public static boolean hasValue (string $name)

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

public static mixed getValue (string $name, [array $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 linkTo (array | string $parameters, [string $text], [boolean $local])

Builds a HTML A tag using framework conventions

  1. <?php
  3. echo Phalcon\Tag::linkTo("signup/register", "Register Here!");
  5. echo Phalcon\Tag::linkTo(
  6.     [
  7.         "signup/register",
  8.         "Register Here!"
  9.     ]
  10. );
  12. echo Phalcon\Tag::linkTo(
  13.     [
  14.         "signup/register",
  15.         "Register Here!",
  16.         "class" => "btn-primary",
  17.     ]
  18. );
  20. echo Phalcon\Tag::linkTo("http://phalconphp.com/", "Phalcon", false);
  22. echo Phalcon\Tag::linkTo(
  23.     [
  24.         "http://phalconphp.com/",
  25.         "Phalcon Home",
  26.         false,
  27.     ]
  28. );
  30. echo Phalcon\Tag::linkTo(
  31.     [
  32.         "http://phalconphp.com/",
  33.         "Phalcon Home",
  34.         "local" => false,
  35.     ]
  36. );
  38. echo Phalcon\Tag::linkTo(
  39.     [
  40.         "action" => "http://phalconphp.com/",
  41.         "text"   => "Phalcon Home",
  42.         "local"  => false,
  43.         "target" => "_new"
  44.     ]
  45. );

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

Builds generic INPUT tags

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

Builds INPUT tags that implements the checked attribute

public static string colorField (array $parameters)

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

public static string textField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::textField(
  4.     [
  5.         "name",
  6.         "size" => 30,
  7.     ]
  8. );

public static string numericField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::numericField(
  4.     [
  5.         "price",
  6.         "min" => "1",
  7.         "max" => "5",
  8.     ]
  9. );

public static string rangeField (array $parameters)

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

public static string emailField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::emailField("email");

public static string dateField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::dateField(
  4.     [
  5.         "born",
  6.         "value" => "14-12-1980",
  7.     ]
  8. );

public static string dateTimeField (array $parameters)

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

public static string dateTimeLocalField (array $parameters)

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

public static string monthField (array $parameters)

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

public static string timeField (array $parameters)

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

public static string weekField (array $parameters)

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

public static string passwordField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::passwordField(
  4.     [
  5.         "name",
  6.         "size" => 30,
  7.     ]
  8. );

public static string hiddenField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::hiddenField(
  4.     [
  5.         "name",
  6.         "value" => "mike",
  7.     ]
  8. );

public static string fileField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::fileField("file");

public static string searchField (array $parameters)

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

public static string telField (array $parameters)

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

public static string urlField (array $parameters)

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

public static string checkField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::checkField(
  4.     [
  5.         "terms",
  6.         "value" => "Y",
  7.     ]
  8. );

Volt syntax:

  1. <?php
  3. {{ check_field("terms") }}

public static string radioField (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::radioField(
  4.     [
  5.         "weather",
  6.         "value" => "hot",
  7.     ]
  8. );

Volt syntax:

  1. <?php
  3. {{ radio_field("Save") }}

public static string imageInput (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::imageInput(
  4.     [
  5.         "src" => "/img/button.png",
  6.     ]
  7. );

Volt syntax:

  1. <?php
  3. {{ image_input("src": "/img/button.png") }}

public static string submitButton (array $parameters)

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

  1. <?php
  3. echo Phalcon\Tag::submitButton("Save")

Volt syntax:

  1. <?php
  3. {{ submit_button("Save") }}

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

Builds a HTML SELECT tag using a PHP array for options

  1. <?php
  3. echo Phalcon\Tag::selectStatic(
  4.     "status",
  5.     [
  6.         "A" => "Active",
  7.         "I" => "Inactive",
  8.     ]
  9. );

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

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

  1. <?php
  3. echo Phalcon\Tag::select(
  4.     [
  5.         "robotId",
  6.         Robots::find("type = "mechanical""),
  7.         "using" => ["id", "name"],
  8.     ]
  9. );

Volt syntax:

  1. <?php
  3. {{ select("robotId", robots, "using": ["id", "name"]) }}

public static string textArea (array $parameters)

Builds a HTML TEXTAREA tag

  1. <?php
  3. echo Phalcon\Tag::textArea(
  4.     [
  5.         "comments",
  6.         "cols" => 10,
  7.         "rows" => 4,
  8.     ]
  9. );

Volt syntax:

  1. <?php
  3. {{ text_area("comments", "cols": 10, "rows": 4) }}

public static string form (array $parameters)

Builds a HTML FORM tag

  1. <?php
  3. echo Phalcon\Tag::form("posts/save");
  5. echo Phalcon\Tag::form(
  6.     [
  7.         "posts/save",
  8.         "method" => "post",
  9.     ]
  10. );

Volt syntax:

  1. <?php
  3. {{ form("posts/save") }}
  4. {{ form("posts/save", "method": "post") }}

public static endForm ()

Builds a HTML close FORM tag

public static setTitle (mixed $title)

Set the title of view content

  1. <?php
  3. Phalcon\Tag::setTitle("Welcome to my Page");

public static setTitleSeparator (mixed $titleSeparator)

Set the title separator of view content

  1. <?php
  3. Phalcon\Tag::setTitleSeparator("-");

public static appendTitle (mixed $title)

Appends a text to current document title

public static prependTitle (mixed $title)

Prepends a text to current document title

public static getTitle ([mixed $tags])

Gets the current document title. The title will be automatically escaped.

  1. <?php
  3. echo Phalcon\Tag::getTitle();
  1. <?php
  3. {{ get_title() }}

public static getTitleSeparator ()

Gets the current document title separator

  1. <?php
  3. echo Phalcon\Tag::getTitleSeparator();
  1. <?php
  3. {{ get_title_separator() }}

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

Builds a LINK[rel=”stylesheet”] tag

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

Volt Syntax:

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

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

Builds a SCRIPT[type=”javascript”] tag

  1. <?php
  3. echo Phalcon\Tag::javascriptInclude("http://ajax.googleapis.com/ajax/libs/jquery/2.2.3/jquery.min.js", false);
  4. echo Phalcon\Tag::javascriptInclude("javascript/jquery.js");

Volt syntax:

  1. <?php
  3. {{ javascript_include("http://ajax.googleapis.com/ajax/libs/jquery/2.2.3/jquery.min.js", false) }}
  4. {{ javascript_include("javascript/jquery.js") }}

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

Builds HTML IMG tags

  1. <?php
  3. echo Phalcon\Tag::image("img/bg.png");
  5. echo Phalcon\Tag::image(
  6.     [
  7.         "img/photo.jpg",
  8.         "alt" => "Some Photo",
  9.     ]
  10. );

Volt Syntax:

  1. <?php
  3. {{ image("img/bg.png") }}
  4. {{ image("img/photo.jpg", "alt": "Some Photo") }}
  5. {{ image("http://static.mywebsite.com/img/bg.png", false) }}

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

Converts texts into URL-friendly titles

  1. <?php
  3. echo Phalcon\Tag::friendlyTitle("These are big important news", "-")

public static setDocType (mixed $doctype)

Set the document type of content

public static getDocType ()

Get the document type declaration of content

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

Builds a HTML tag

public static tagHtmlClose (mixed $tagName, [mixed $useEol])

Builds a HTML tag closing tag

  1. <?php
  3. echo Phalcon\Tag::tagHtmlClose("script", true);