4.0
Secciones

Abstract Class Phalcon\Forms\Element\AbstractElement

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses InvalidArgumentException, Phalcon\Forms\Form, Phalcon\Forms\Exception, Phalcon\Messages\MessageInterface, Phalcon\Messages\Messages, Phalcon\Tag, Phalcon\Validation\ValidatorInterface   Implements ElementInterface

Esta es una clase base para elementos de formulario

Propiedades

//
protected attributes;

//
protected filters;

//
protected form;

//
protected label;

//
protected messages;

//
protected name;

//
protected options;

/**
 * @var array
 */
protected validators;

//
protected value;

Métodos

public function __construct( string $name, array $attributes = [] );

Phalcon\Forms\Element constructor

public function __toString(): string;

El método mágico __toString renderiza el widget sin atributos

public function addFilter( string $filter ): ElementInterface;

Añade un filtro a la lista actual de filtros

public function addValidator( ValidatorInterface $validator ): ElementInterface;

Añade una validación al elemento

public function addValidators( array $validators, bool $merge = bool ): ElementInterface;

Añade un grupo de validaciones

public function appendMessage( MessageInterface $message ): ElementInterface;

Añade un mensaje a la lista interna de mensajes

public function clear(): ElementInterface;

Restablece el elemento a su valor por defecto

public function getAttribute( string $attribute, mixed $defaultValue = null ): mixed;

Devuelve el valor de un atributo si existe

public function getAttributes(): array;

Devuelve los valores por defecto de los atributos del elemento

public function getDefault(): mixed;

Devuelve el valor por defecto asignado al elemento

public function getFilters();

Devuelve los filtros del elemento

public function getForm(): Form;

Devuelve el formulario padre al elemento

public function getLabel(): string;

Devuelve la etiqueta del elemento

public function getMessages(): Messages;

Devuelve los mensajes que pertenecen al elemento El elemento necesita ser parte de un formulario

public function getName(): string;

Devuelve el nombre del elemento

public function getUserOption( string $option, mixed $defaultValue = null ): mixed;

Devuelve el valor de una opción si existe

public function getUserOptions(): array;

Devuelve las opciones del elemento

public function getValidators(): ValidatorInterface[];

Devuelve los validadores registrados para el elemento

public function getValue(): mixed;

Devuelve el valor del elemento

public function hasMessages(): bool;

Comprueba si hay mensajes vinculados al elemento

public function label( array $attributes = [] ): string;

Genera el HTML para etiquetar al elemento

public function prepareAttributes( array $attributes = [], bool $useChecked = bool ): array;

Devuelve un vector de atributos preparados para ayudantes Phalcon\Tag en base a los parámetros de los elementos

public function setAttribute( string $attribute, mixed $value ): ElementInterface;

Establece un atributo predeterminado para el elemento

public function setAttributes( array $attributes ): ElementInterface;

Establece atributos predeterminados para el elemento

public function setDefault( mixed $value ): ElementInterface;

Establece un valor predeterminado en caso de que el formulario no use una entidad o no tenga ningún valor disponible para el elemento en el _POST

public function setFilters( mixed $filters ): ElementInterface;

Establece los filtros del elemento

public function setForm( Form $form ): ElementInterface;

Establece el formulario padre del elemento

public function setLabel( string $label ): ElementInterface;

Establece la etiqueta del elemento

public function setMessages( Messages $messages ): ElementInterface;

Establece los mensajes de validación relacionados con el elemento

public function setName( string $name ): ElementInterface;

Establece el nombre del elemento

public function setUserOption( string $option, mixed $value ): ElementInterface;

Establece una opción para el elemento

public function setUserOptions( array $options ): ElementInterface;

Establece las opciones para el elemento

Class Phalcon\Forms\Element\Check

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Phalcon\Forms\Element\Check

Componente INPUT[type=check] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo HTML

Class Phalcon\Forms\Element\Date

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Componente INPUT[type=date] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo html

Interface Phalcon\Forms\Element\ElementInterface

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Forms\Form, Phalcon\Messages\MessageInterface, Phalcon\Messages\Messages, Phalcon\Validation\ValidatorInterface

Interfaz para clases Phalcon\Forms\Element

Métodos

public function addFilter( string $filter ): ElementInterface;

Añade un filtro a la lista actual de filtros

public function addValidator( ValidatorInterface $validator ): ElementInterface;

Añade una validación al elemento

public function addValidators( array $validators, bool $merge = bool ): ElementInterface;

Añade un grupo de validaciones

public function appendMessage( MessageInterface $message ): ElementInterface;

Añade un mensaje a la lista interna de mensajes

public function clear(): ElementInterface;

Restaura cada elemento del formulario a su valor predeterminado

public function getAttribute( string $attribute, mixed $defaultValue = null ): mixed;

Devuelve el valor de un atributo si existe

public function getAttributes(): array;

Devuelve los valores por defecto de los atributos del elemento

public function getDefault(): mixed;

Devuelve el valor por defecto asignado al elemento

public function getFilters();

Devuelve los filtros del elemento

public function getForm(): Form;

Devuelve el formulario padre al elemento

public function getLabel(): string;

Devuelve la etiqueta del elemento

public function getMessages(): Messages;

Devuelve los mensajes que pertenecen al elemento El elemento necesita adjuntarse a un formulario

public function getName(): string;

Devuelve el nombre del elemento

public function getUserOption( string $option, mixed $defaultValue = null ): mixed;

Devuelve el valor de una opción si existe

public function getUserOptions(): array;

Devuelve las opciones del elemento

public function getValidators(): ValidatorInterface[];

Devuelve los validadores registrados para el elemento

public function getValue(): mixed;

Devuelve el valor del elemento

public function hasMessages(): bool;

Comprueba si hay mensajes vinculados al elemento

public function label(): string;

Genera el HTML para etiquetar al elemento

public function prepareAttributes( array $attributes = [], bool $useChecked = bool ): array;

Devuelve un vector de atributos preparados para los ayudantes Phalcon\Tag en base a los parámetros de los elementos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento

public function setAttribute( string $attribute, mixed $value ): ElementInterface;

Establece un atributo predeterminado para el elemento

public function setAttributes( array $attributes ): ElementInterface;

Establece los atributos predeterminados para el elemento

public function setDefault( mixed $value ): ElementInterface;

Establece un valor predeterminado en caso de que el formulario no use una entidad o no tenga ningún valor disponible para el elemento en el _POST

public function setFilters( mixed $filters ): ElementInterface;

Establece los filtros del elemento

public function setForm( Form $form ): ElementInterface;

Establece el formulario padre del elemento

public function setLabel( string $label ): ElementInterface;

Establece la etiqueta del elemento

public function setMessages( Messages $messages ): ElementInterface;

Establece los mensajes de validación relacionados con el elemento

public function setName( string $name ): ElementInterface;

Establece el nombre del elemento

public function setUserOption( string $option, mixed $value ): ElementInterface;

Establece una opción para el elemento

public function setUserOptions( array $options ): ElementInterface;

Establece las opciones para el elemento

Class Phalcon\Forms\Element\Email

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Phalcon\Forms\Element\Email

Componente INPUT[type=email] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo HTML

Class Phalcon\Forms\Element\File

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Componente INPUT[type=file] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo HTML

Class Phalcon\Forms\Element\Hidden

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Phalcon\Forms\Element\Hidden

Componente INPUT[type=hidden] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo HTML

Class Phalcon\Forms\Element\Numeric

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Phalcon\Forms\Element\Numeric

Componente INPUT[type=number] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo HTML

Class Phalcon\Forms\Element\Password

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Phalcon\Forms\Element\Password

Componente INPUT[type=password] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo HTML

Class Phalcon\Forms\Element\Radio

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Phalcon\Forms\Element\Radio

Componente INPUT[type=radio] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo HTML

Class Phalcon\Forms\Element\Select

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag\Select   Extends AbstractElement

Phalcon\Forms\Element\Select

Componente SELECT (elección) para formularios

Propiedades

//
protected optionsValues;

Métodos

public function __construct( string $name, mixed $options = null, mixed $attributes = null );

Constructor Phalcon\Forms\Element

public function addOption( mixed $option ): ElementInterface;

Añade una opción a las opciones actuales

public function getOptions();

Devuelve las opciones de selección

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento devolviendo HTML

public function setOptions( mixed $options ): ElementInterface;

Establece las opciones a elegir

Class Phalcon\Forms\Element\Submit

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Componente INPUT[type=submit] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento

Class Phalcon\Forms\Element\Text

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Phalcon\Forms\Element\Text

Componente INPUT[type=text] para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento

Class Phalcon\Forms\Element\TextArea

Código fuente en GitHub

Namespace Phalcon\Forms\Element   Uses Phalcon\Tag   Extends AbstractElement

Componente TEXTAREA para formularios

Métodos

public function render( array $attributes = [] ): string;

Renderiza el widget del elemento

Class Phalcon\Forms\Exception

Código fuente en GitHub

Namespace Phalcon\Forms   Extends \Phalcon\Exception

Las excepciones lanzadas en Phalcon\Forms usarán esta clase

Class Phalcon\Forms\Form

Código fuente en GitHub

Namespace Phalcon\Forms   Uses Countable, Iterator, Phalcon\Di\Injectable, Phalcon\Di\DiInterface, Phalcon\Filter\FilterInterface, Phalcon\Forms\Element\ElementInterface, Phalcon\Html\Attributes, Phalcon\Html\Attributes\AttributesInterface, Phalcon\Messages\Messages, Phalcon\Tag, Phalcon\Validation, Phalcon\Validation\ValidationInterface   Extends Injectable   Implements Countable, Iterator, AttributesInterface

Este componente permite construir formularios usando un interfaz orientado a objetos

Propiedades

/**
 * @var Attributes | null
 */
protected attributes;

//
protected data;

//
protected elements;

//
protected elementsIndexed;

//
protected entity;

//
protected messages;

//
protected position;

//
protected options;

//
protected validation;

Métodos

public function __construct( mixed $entity = null, array $userOptions = [] );

Constructor Phalcon\Forms\Form

public function add( ElementInterface $element, string $position = null, bool $type = null ): Form;

Añade un elemento al formulario

public function bind( array $data, mixed $entity, mixed $whitelist = null ): Form;

Vincula datos a la entidad

public function clear( mixed $fields = null ): Form;

Restaura cada elemento del formulario a sus valores predeterminados

public function count(): int;

Devuelve el número de elementos del formulario

public function current(): ElementInterface | bool;

Devuelve el elemento actual de la iteración

public function get( string $name ): ElementInterface;

Devuelve un elemento añadido al formulario por su nombre

public function getAction(): string;

Devuelve la acción del formulario

public function getAttributes(): Attributes;

Devuelve la colección de atributos del Formulario

public function getElements(): ElementInterface[];

Devuelve los elementos añadidos al formulario

public function getEntity();

Devuelve la entidad relacionada con el modelo

public function getLabel( string $name ): string;

Devuelve una etiqueta para un elemento

public function getMessages(): Messages | array;

Devuelve los mensajes generados en la validación.

if ($form->isValid($_POST) == false) {
    $messages = $form->getMessages();

    foreach ($messages as $message) {
        echo $message, "<br>";
    }
}

public function getMessagesFor( string $name ): Messages;

Devuelve los mensajes generados para un elemento específico

public function getUserOption( string $option, mixed $defaultValue = null ): mixed;

Devuelve el valor de una opción si existe

public function getUserOptions(): array;

Devuelve las opciones del elemento

public function getValidation()

public function getValue( string $name ): mixed | null;

Obtiene un valor de la entidad interna relacionada o del valor por defecto

public function has( string $name ): bool;

Comprueba si el formulario contiene un elemento

public function hasMessagesFor( string $name ): bool;

Comprueba si se han generado mensajes para un elemento específico

public function isValid( mixed $data = null, mixed $entity = null ): bool;

Valida el formulario

public function key(): int;

Devuelve la posición/clave actual del iterador

public function label( string $name, array $attributes = null ): string;

Genera la etiqueta de un elemento añadido al formulario incluyendo HTML

public function next(): void;

Mueve el puntero interno de iteración a la siguiente posición

public function remove( string $name ): bool;

Elimina un elemento del formulario

public function render( string $name, array $attributes = [] ): string;

Renderiza un objeto específico en el formulario

public function rewind(): void;

Rebobina el iterador interno

public function setAction( string $action ): Form;

Establece la acción del formulario

public function setAttributes( Attributes $attributes ): AttributesInterface;

Establece la colección de atributos del formulario

public function setEntity( mixed $entity ): Form;

Establece la entidad relacionada con el modelo

public function setUserOption( string $option, mixed $value ): Form;

Establece una opción para el formulario

public function setUserOptions( array $options ): Form;

Establece las opciones para el elemento

public function setValidation( $validation )

public function valid(): bool;

Comprueba si el elemento actual en el iterador es válido

Class Phalcon\Forms\Manager

Código fuente en GitHub

Namespace Phalcon\Forms

Gestor de Formularios

Propiedades

//
protected forms;

Métodos

public function create( string $name, mixed $entity = null ): Form;

Crea un formulario registrándolo en el gestor de formularios

public function get( string $name ): Form;

Devuelve un formulario por su nombre

public function has( string $name ): bool;

Comprueba si un formulario está registrado en el gestor de formularios

public function set( string $name, Form $form ): Manager;

Registra un formulario en el Gestor de Formularios

General
Introducción
Notas de la Versión
Actualizar
Patrocinadores
Contribuciones
Resumen
Pull Requests
NFR (Solicitud de Nuevas Características)
Generación de Backtrace
Pruebas Reproducibles
Entorno de prueba
Estándar de codificación
Cómo Empezar
Instalación
Configuración de Servidor Web
Entornos
Devilbox
Nanobox
Herramientas de Desarrollo
DevTools
Depuración
Migraciones
Pruebas Unitarias
Tutoriales
Básico
Invo
REST
Vokuro
Casos de uso
Rendimiento
Núcleo
Índice del API
Application
Micro
CLI
Contenedor DI
MVC
Espacios de nombres
Servicios
Cache
Configuración
Escaper
Loader
Logger
Base de Datos
Capa
PHQL
ODM
Modelos
Comportamientos
Cache
Eventos
Metadatos
Relaciones
Transacciones
Validadores
Paginación
Migraciones
Front End
Recursos Activos
Mensajes Flash
Formularios
Imagen
Tag
Vistas
Volt
Lógica de Negocio
Listas de Control de Acceso
Anotaciones
Controladores
Dispatcher
Gestor de Eventos
Filtros
Ruteo
Sesiones
Url
Validación
HTTP
Cookies
Consulta
Respuesta
Seguridad
Crypto
Seguridad
JWT
PSR
PSR-3 Logger
PSR-0, PSR-4 Cargador
PSR-7 Petición HTTP
PSR-7 Respuesta HTTP
PSR-7 Petición Servidor HTTP
PSR-7 Flujo HTTP
PSR-7 Fichero Subido HTTP
PSR-7 Uri HTTP
PSR-11 Contenedor
PSR-13 Enlaces HTML
PSR-17 Fábricas HTTP
i18n
Internacionalización
Traducciones
Utilidad
Coleccion
Dominio
HTML
Ayudantes (Helpers)
Registro