Descrição
O wpforms_display_submit_spinner_src
só é ativado se Ativar o envio de formulários AJAX é ativado nas definições do formulário e o formulário é enviado.
Parâmetros
- $src
- (string) A fonte (URL) da imagem utilizada para o spinner
- $form_data
- (matriz) Definições/dados de formulários processados, preparados para serem utilizados posteriormente.
Fonte
wpforms/src/Frontend/Frontend.php
Mais informações
O wpforms_display_submit_spinner_src
pode ser utilizado para alterar o ícone/imagem que é mostrado quando o formulário está a ser enviado quando o AJAX está ativado nas definições do formulário.
Exemplo
Este exemplo alteraria a fonte do spinner para todos os formulários.
/** * Filter for changing the spinning loader icon shown as the form is submitted. * * @link https://wpforms.com/developers/wpforms_display_submit_spinner_src/ * * @param string $src Source of the image used for the spinner. * @param array $form_data Processed form settings/data, prepared to be used later. * * @return string */ function custom_wpforms_display_submit_spinner_src( $src ) { return 'https://yoursite.com/your-image.svg'; } add_filter( 'wpforms_display_submit_spinner_src', 'custom_wpforms_display_submit_spinner_src', 10, 2 );
Neste exemplo, estamos a visar um formulário específico. O ID do formulário 42
/** * Filter for changing the spinning loader icon shown as the form is submitted for a specific form. * * @link https://wpforms.com/developers/wpforms_display_submit_spinner_src/ * * @param string $src Source of the image used for the spinner. * @param array $form_data Processed form settings/data, prepared to be used later. * * @return string */ function custom_wpforms_display_submit_spinner_src( $src, $form_data ) { if ( $form_data[ 'id' ] === '42' ) { $src = 'https://yoursite.com/your-image.svg'; } return $src; } add_filter( 'wpforms_display_submit_spinner_src', 'custom_wpforms_display_submit_spinner_src', 10, 2 );
O tamanho de imagem recomendado é 26×26. Em alternativa, pode utilizar CSS para definir o tamanho que visa o .wpforms-submit-spinner
classe CSS, mas qualquer CSS adicionada necessitará da utilização de !important
para substituir o estilo em linha predefinido.
Relacionadas
Referência do artigo: Como alterar o ícone do pré-carregador no envio