widget¶

tipo: stringa predefinito: choice

Il modo di base in cui il campo andrebbe reso. Può essere uno dei seguenti:

• choice: rende due (o tre, se with_seconds è true) select.
• text: rende due o tre input testuali (ora, minuto, secondo).
• single_text: rende un singolo input testuale. Il valore inserito dall'utente sarà validato nella forma hh:mm (o hh:mm:ss, se si usano i secondi).

input¶

tipo: stringa predefinito: datetime

IL formato dei dati di ingresso, cioè il formato in cui la data è memorizzata nell'oggetto sottostante. Valori validi sono:

• stringa (p.e. 12:17:26)
• datetime (un oggetto DateTime)
• array (p.e. array('hour' => 12, 'minute' => 17, 'second' => 26))
• timestamp (p.e. 1307232000)

Il valore proveniente dal form sarà normalizzato nello stesso formato.

with_seconds¶

tipo: booleano predefinito: false

Se includere o meno i secondi nell'input. Se true, ci sarà un campo aggiuntivo per inserire i secondi.

hours¶

tipo: intero predefinito: da 1 a 23

Lista di ore disponibili per il tipo di campo hours. Questa opzione è rilevante solo se l'opzione widget è impostata a choice.

minutes¶

tipo: intero predefinito: da 1 a 59

Lista di minuti disponibili per il tipo di campo minutes. Questa opzione è rilevante solo se l'opzione widget è impostata a choice.

seconds¶

tipo: intero predefinito: da 1 a 59

Lista di secondi disponibili per il tipo di campo seconds. Questa opzione è rilevante solo se l'opzione widget è impostata a choice.

data_timezone¶

tipo: stringa predefinito: fuso orario di sistema

Fuso orario in cui la data inserita è memorizzata. Deve essere uno dei fusi orari supportati da PHP

user_timezone¶

tipo: stringa predefinito: fuso orario di sistema

Fuso orario usato per mostrare la data all'utente (e quindi anche la data inviata dall'utente stesso). Deve essere uno dei fusi orari supportati da PHP.

invalid_message¶

tipo: stringa predefinito: This value is not valid

Questo è il messaggio di errore di validazione usato quando i dati inseriti sono determinati dalla validazione interna di un tipo di campo. Questo può accadere, per esempio, se l'utente inserire una stringa dentro un campo time che non può essere convertito in un tempo reale. Per i normali messaggi di validazione (come quando si imposta la lunghezza minima per un campo), impostare i messaggi di validazione con le proprie regole di validazione (riferimento).

invalid_message_parameters¶

tipo: array predefinito: array()

Impostando l'opzione invalid_message, si potrebbe aver bisogno di includere alcune variabili nella stringa. Lo si può fare aggiungendo dei segnaposto all'opzione e includendo le variabili in questa opzione:

1
2
3
4
5

$builder->add('un_campo', 'un_tipo', array(
    // ...
    'invalid_message'            => 'Valore inserito non valido: deve includere almeno %num% caratteri',
    'invalid_message_parameters' => array('%num%' => 6),
));

read_only¶

tipo: booleano predefinito: false

Se questa opzione è true, il campo sarà reso con l'attributo disabled, in modo che il campo non sia modificabile.

disabled¶

New in version 2.1: L'opzione disabled è stata aggiunta nella versione 2.1

type: booleano default: false

Se non si vuole che l'utente modifichi il valore di un campo, si può impostare questa opzione a true. Ogni valore inserito sarà ignorato.