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

<?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 (array $values, [mixed $merge])

Assigns default values to generated tags by helpers

<?php

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

// Later in the view
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

<?php

echo Phalcon\Tag::linkTo("signup/register", "Register Here!");

echo Phalcon\Tag::linkTo(
    [
        "signup/register",
        "Register Here!"
    ]
);

echo Phalcon\Tag::linkTo(
    [
        "signup/register",
        "Register Here!",
        "class" => "btn-primary",
    ]
);

echo Phalcon\Tag::linkTo("https://phalcon.io/", "Phalcon", false);

echo Phalcon\Tag::linkTo(
    [
        "https://phalcon.io/",
        "Phalcon Home",
        false,
    ]
);

echo Phalcon\Tag::linkTo(
    [
        "https://phalcon.io/",
        "Phalcon Home",
        "local" => false,
    ]
);

echo Phalcon\Tag::linkTo(
    [
        "action" => "https://phalcon.io/",
        "text"   => "Phalcon Home",
        "local"  => false,
        "target" => "_new"
    ]
);

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

<?php

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

public static string numericField (array $parameters)

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

<?php

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

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

<?php

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

public static string dateField (array $parameters)

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

<?php

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

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

<?php

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

public static string hiddenField (array $parameters)

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

<?php

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

public static string fileField (array $parameters)

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

<?php

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

<?php

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

Volt syntax:

<?php

{% raw %}{{ check_field("terms") }}{% endraw %}

public static string radioField (array $parameters)

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

<?php

echo Phalcon\Tag::radioField(
    [
        "weather",
        "value" => "hot",
    ]
);

Volt syntax:

<?php

{% raw %}{{ radio_field("Save") }}{% endraw %}

public static string imageInput (array $parameters)

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

<?php

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

Volt syntax:

<?php

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

public static string submitButton (array $parameters)

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

<?php

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

Volt syntax:

<?php

{% raw %}{{ submit_button("Save") }}{% endraw %}

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

Builds a HTML SELECT tag using a PHP array for options

<?php

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

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

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

<?php

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

Volt syntax:

<?php

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

public static string textArea (array $parameters)

Builds a HTML TEXTAREA tag

<?php

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

Volt syntax:

<?php

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

public static string form (array $parameters)

Builds a HTML FORM tag

<?php

echo Phalcon\Tag::form("posts/save");

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

Volt syntax:

<?php

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

public static endForm ()

Builds a HTML close FORM tag

public static setTitle (mixed $title)

Set the title of view content

<?php

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

public static setTitleSeparator (mixed $titleSeparator)

Set the title separator of view content

<?php

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.

<?php

echo Phalcon\Tag::getTitle();

<?php

{% raw %}{{ get_title() }}{% endraw %}

public static getTitleSeparator ()

Gets the current document title separator

<?php

echo Phalcon\Tag::getTitleSeparator();

<?php

{% raw %}{{ get_title_separator() }}{% endraw %}

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

Builds a LINK[rel="stylesheet"] tag

<?php

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

Volt Syntax:

<?php

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

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

Builds a SCRIPT[type="javascript"] tag

<?php

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

Volt syntax:

<?php

{% raw %}{{ javascript_include("https://ajax.googleapis.com/ajax/libs/jquery/2.2.3/jquery.min.js", false) }}{% endraw %}
{% raw %}{{ javascript_include("javascript/jquery.js") }}{% endraw %}

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

Builds HTML IMG tags

<?php

echo Phalcon\Tag::image("img/bg.png");

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

Volt Syntax:

<?php

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

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

Converts texts into URL-friendly titles

<?php

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

<?php

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

Class Phalcon\Tag\Exception¶

extends class Phalcon\Exception

implements Throwable

Source on GitHub

Methods¶

final private Exception __clone () inherited from Exception

Clone the exception

public __construct ([mixed $message], [mixed $code], [mixed $previous]) inherited from Exception

Exception constructor

public __wakeup () inherited from Exception

...

final public string getMessage () inherited from Exception

Gets the Exception message

final public int getCode () inherited from Exception

Gets the Exception code

final public string getFile () inherited from Exception

Gets the file in which the exception occurred

final public int getLine () inherited from Exception

Gets the line in which the exception occurred

final public array getTrace () inherited from Exception

Gets the stack trace

final public Exception getPrevious () inherited from Exception

Returns previous Exception

final public Exception getTraceAsString () inherited from Exception

Gets the stack trace as a string

public string __toString () inherited from Exception

String representation of the exception

Abstract class Phalcon\Tag\Select¶

Source on GitHub

Generates a SELECT html tag using a static array of values or a Phalcon\Mvc\Model resultset

Methods¶

public static selectField (array $parameters, [array $data])

Generates a SELECT tag

private static _optionsFromResultset (Phalcon\Mvc\Model\Resultset $resultset, array $using, mixed $value, string $closeOption)

Generate the OPTION tags based on a resultset

private static _optionsFromArray (array $data, mixed $value, string $closeOption)

Generate the OPTION tags based on an array