Descrição
O wpforms_process_validate_checkbox
dispara a validação na ação Caixa de verificação campo do formulário quando o formulário é submetido.
Parâmetros
- $field_id
- (int) ID do campo.
- $field_submit
- (array) Valor de campo original em bruto/não higienizado apresentado para o campo.
- $form_data
- (matriz) Definições/dados de formulários processados, preparados para serem utilizados posteriormente.
Fonte
wpforms/includes/class-process.php
Mais informações
O wpforms_process_validate_checkbox
é aplicado a uma matriz para Caixa de verificação campo de formulário. Esta função pode ser utilizada para todos os campos de formulário do_action( "wpforms_process_validate_{$field_type}", $field_id, $field_submit, $form_data )
.
É importante notar que os valores de campo não são higienizados até mais tarde no processamento, em wpforms_process_format_{$field_type}
.o
Exemplos
Neste exemplo apresentado abaixo, a função verifica o campo de formulário Checkboxes para um número mínimo de opções a selecionar.
/* * Check the Checkboxes field for minimum number of choices. * * @link https://wpforms.com/developers/wpforms_process_validate_checkbox/ * * @param int $field_id Field ID. * @param array $field_submit Unsanitized field value submitted for the field. * @param array $form_data Form data and settings. */ function wpf_checkbox_validation( $field_id, $field_submit, $form_data ) { $field_submit = (array) $field_submit; $count_choices = count( $field_submit ); if ( $count_choices < 2 ) { wpforms()->process->errors[ $form_data[ 'id' ] ][ $field_id ] = __( 'Please select at least 2 options', 'plugin-domain' ); } } add_action( 'wpforms_process_validate_checkbox', 'wpf_checkbox_validation', 10, 3 );
Relacionadas
Referência do artigo: Como definir um número mínimo de opções para uma caixa de seleção