Sections

Class Phalcon\Tag

Source on GitHub

Namespace Phalcon
Uses Phalcon\Di\Di, Phalcon\Di\DiInterface, Phalcon\Html\Escaper\EscaperInterface, Phalcon\Html\Link\Link, Phalcon\Html\Link\Serializer\Header, Phalcon\Tag\Select, Phalcon\Tag\Exception, Phalcon\Mvc\Url\UrlInterface, Phalcon\Support\Helper\Str\Friendly

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 a class that you can extend to add more helpers.

Constants

const HTML32 = 1;
const HTML401_FRAMESET = 4;
const HTML401_STRICT = 2;
const HTML401_TRANSITIONAL = 3;
const HTML5 = 5;
const XHTML10_FRAMESET = 8;
const XHTML10_STRICT = 6;
const XHTML10_TRANSITIONAL = 7;
const XHTML11 = 9;
const XHTML20 = 10;
const XHTML5 = 11;

Properties

/**
 * @var bool
 */
protected static autoEscape = true;

/**
 * DI Container
 *
 * @var DiInterface|null
 */
protected static container;

/**
 * Pre-assigned values for components
 *
 * @var array
 */
protected static displayValues;

/**
 * @var array
 */
protected static documentAppendTitle;

/**
 * @var array
 */
protected static documentPrependTitle;

/**
 * HTML document title
 *
 * @var string|null
 */
protected static documentTitle;

/**
 * @var string|null
 */
protected static documentTitleSeparator;

/**
 * @var int
 */
protected static documentType = 11;

/**
 * @var EscaperInterface|null
 */
protected static escaperService;

/**
 * @var UrlInterface|null
 */
protected static urlService;

Methods

public static function appendTitle( mixed $title ): void;

Appends a text to current document title

public static function checkField( mixed $parameters ): string;

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

public static function colorField( mixed $parameters ): string;

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

public static function dateField( mixed $parameters ): string;

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

public static function dateTimeField( mixed $parameters ): string;

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

public static function dateTimeLocalField( mixed $parameters ): string;

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

public static function displayTo( string $id, mixed $value ): void;

Alias of Phalcon\Tag::setDefault()

public static function emailField( mixed $parameters ): string;

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

public static function endForm(): string;

Builds a HTML close FORM tag

public static function fileField( mixed $parameters ): string;

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

public static function formLegacy( mixed $parameters ): string;

Builds a HTML FORM tag

public static function friendlyTitle( string $text, string $separator = string, bool $lowercase = bool, mixed $replace = null ): string;

Converts texts into URL-friendly titles

public static function getDI(): DiInterface;

Internally gets the request dispatcher

public static function getDocType(): string;

Get the document type declaration of content

public static function getEscaper( array $params ): EscaperInterface | null;

Obtains the ‘escaper’ service if required

public static function getEscaperService(): EscaperInterface;

Returns an Escaper service from the default DI

public static function getTitle( bool $prepend = bool, bool $append = bool ): string;

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

public static function getTitleSeparator(): string;

Gets the current document title separator

public static function getUrlService(): UrlInterface;

Returns a URL service from the default DI

public static function getValue( mixed $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 function hasValue( mixed $name ): bool;

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

public static function hiddenField( mixed $parameters ): string;

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

public static function image( mixed $parameters = null, bool $local = bool ): string;

Builds HTML IMG tags

public static function imageInput( mixed $parameters ): string;

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

public static function javascriptInclude( mixed $parameters = null, bool $local = bool ): string;

Builds a SCRIPT[type=”javascript”] tag

public static function linkTo( mixed $parameters, mixed $text = null, mixed $local = bool ): string;

Builds a HTML A tag using framework conventions

public static function monthField( mixed $parameters ): string;

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

public static function numericField( mixed $parameters ): string;

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

public static function passwordField( mixed $parameters ): string;

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

public static function preload( mixed $parameters ): string;

Parses the preload element passed and sets the necessary link headers

public static function prependTitle( mixed $title ): void;

Prepends a text to current document title

public static function radioField( mixed $parameters ): string;

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

public static function rangeField( mixed $parameters ): string;

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

public static function renderAttributes( string $code, array $attributes ): string;

Renders parameters keeping order in their HTML attributes

public static function renderTitle( bool $prepend = bool, bool $append = bool ): string;

Renders the title with title tags. The title is automatically escaped

deprecated public static function resetInput(): void;

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

@deprecated Will be removed in 4.0.0

public static function searchField( mixed $parameters ): string;

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

public static function select( mixed $parameters, mixed $data = null ): string;

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

public static function selectStatic( mixed $parameters, mixed $data = null ): string;

Builds a HTML SELECT tag using a PHP array for options

public static function setAutoescape( bool $autoescape ): void;

Set autoescape mode in generated HTML

public static function setDI( DiInterface $container ): void;

Sets the dependency injector container.

public static function setDefault( string $id, mixed $value ): void;

Assigns default values to generated tags by helpers

public static function setDefaults( array $values, bool $merge = bool ): void;

Assigns default values to generated tags by helpers

public static function setDocType( int $doctype ): void;

Set the document type of content

public static function setTitle( string $title ): void;

Set the title of view content

public static function setTitleSeparator( string $titleSeparator ): void;

Set the title separator of view content

public static function stylesheetLink( mixed $parameters = null, bool $local = bool ): string;

Builds a LINK[rel=”stylesheet”] tag

public static function submitButton( mixed $parameters ): string;

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

public static function tagHtml( string $tagName, mixed $parameters = null, bool $selfClose = bool, bool $onlyStart = bool, bool $useEol = bool ): string;

Builds a HTML tag

public static function tagHtmlClose( string $tagName, bool $useEol = bool ): string;

Builds a HTML tag closing tag

public static function telField( mixed $parameters ): string;

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

public static function textArea( mixed $parameters ): string;

Builds a HTML TEXTAREA tag

@paraym array parameters = [ ‘id’ => ‘’, ‘name’ => ‘’, ‘value’ => ‘’, ‘class’ => ‘’ ]

public static function textField( mixed $parameters ): string;

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

public static function timeField( mixed $parameters ): string;

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

public static function urlField( mixed $parameters ): string;

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

public static function weekField( mixed $parameters ): string;

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

static final protected function inputField( string $type, mixed $parameters, bool $asValue = bool ): string;

Builds generic INPUT tags

static final protected function inputFieldChecked( string $type, mixed $parameters ): string;

Builds INPUT tags that implements the checked attribute

Class Phalcon\Tag\Exception

Source on GitHub

Namespace Phalcon\Tag
Extends \Exception

Phalcon\Tag\Exception

Exceptions thrown in Phalcon\Tag will use this class

Abstract Class Phalcon\Tag\Select

Source on GitHub

Namespace Phalcon\Tag
Uses Phalcon\Tag, Phalcon\Html\Escaper\EscaperInterface, Phalcon\Mvc\Model\ResultsetInterface

Phalcon\Tag\Select

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

Methods

public static function selectField( mixed $parameters, mixed $data = null ): string;

Generates a SELECT tag