submit Field Type

Nuovo nella versione 2.3: Il tipo submit è stato aggiunto in Symfony 2.3

A submit button.

Reso come tag input submit
Opzioni ereditate
Tipo genitore button
Classe Symfony\Component\Form\Extension\Core\Type\SubmitType

Il bottone Submit button ha un metodo aggiuntivo isClicked(), che consente di verificare se questo bottone sia stato usato per inviare il form. Questo è utile specialmente quando un form ha più bottoni submit:

if ($form->get('save')->isClicked()) {
    // ...
}

Opzioni ereditate

attr

tipo: array predefinito: Array vuoto

Se si vogliono aggiungere attributi extra alla rappresentazione HTML del bottone, si può usare l’opzione attr. È un array associativo con gli attributi HTML come chiavi. Può essere utile quando servono classi personalizzate per il bottone:

$builder->add('save', 'button', array(
    'attr' => array('class' => 'save'),
));

disabled

tipo: boolean predefinito: false

Se non si vuole che sia possibile cliccare un bottone, si può impostare questa opzione a true. Non sarà possibile inviare il form con questo bottone, nemmeno aggirando il browser e inviando la richiesta a mano, per esempio con cURL.

label

tipo: string predefinito: Il testo è “indovinato” dal nome del campo

Imposta il testo mostrato sul bottone. Il testo può anche essere impostato direttamente all’interno del template:

  • Twig
    {{ form_widget(form.save, { 'label': 'Cliccami' }) }}
    
  • PHP
    <?php echo $view['form']->widget($form['save'], array('label' => 'Cliccami')) ?>
    

label_attr

tipo: array predefinito: array()

Imposta gli attributi HTML per l’elemento <label>, che saranno usati durante la resa della label di un campo. È un array associativo con gli attributi HTML come chiavi. Questi attributi possono anche essere impostati all’interno del template:

  • Twig
    {{ form_label(form.name, 'Nome', {'label_attr': {'class': 'CUSTOM_LABEL_CLASS'}}) }}
    
  • PHP
    echo $view['form']->label(
        $form['name'],
        'Nome',
        array('class', 'CUSTOM_LABEL_CLASS')
    );
    

translation_domain

tipo: stringa predefinito: messages

Il dominio di traduzione che sarà usato per testi o opzioni resi per questo bottone.

validation_groups

tipo: array predefinito: null

Quando un form contiene più bottoni submit, si può modificare il gruppo di validazione, in base al bottone usato per inviare il form. Si immagini un form di registrazione in più passi, con bottoni per andare al passo precedente o al successivo:

$form = $this->createFormBuilder($user)
    ->add('precedente', 'submit', array(
        'validation_groups' => false,
    ))
    ->add('successivo', 'submit', array(
        'validation_groups' => array('Registration'),
    ))
    ->getForm();

Il valore speciale false assicura che non venga eseguita alcuna validazione quando si clicca il bottone per andare indietro. Quando si clicca l’altro bottone, vengono validati tutti i vincoli del gruppo “Registration”.

Vedi anche

Si può approfondire l’argomento nel capitolo Form del libro.

Variabili di form

Variabile Tipo Uso
clicked Booleano Se il bottone sia stato cliccato o meno.

Tabella dei contenuti

Argomento precedente

Tipo di campo reset

Argomento successivo

Tipo di campo form

Questa pagina