### [Utilizar a API JavaScript para Campos Apenas de Leitura](https://wpforms.com/developers/using-the-javascript-api-for-read-only-fields/) **Publicado:** 22 de setembro de 2025 **Autor:** Umair Majeed **Conteúdo:** Gostaria de controlar campos apenas de leitura no WPForms usando JavaScript? O WPForms fornece um conjunto de métodos JavaScript que permitem bloquear, desbloquear e alternar campos de formulário diretamente no frontend. Essas funções são úteis se você quiser adicionar lógica personalizada, como desativar campos após o envio ou tornar certos campos apenas de leitura com base nas ações do usuário. ## Adicionar o Seu JavaScript Personalizado Para usar esses métodos, você precisará adicionar um trecho de JavaScript personalizado ao seu site. Se não tiver certeza de como adicionar código personalizado, consulte nosso guia sobre [como adicionar JavaScript personalizado para WPForms](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/). Certifique-se de que seu código seja executado após o carregamento do WPForms, envolvendo-o dentro do evento `wpformsReady`. ### Métodos Disponíveis Os seguintes métodos estão disponíveis dentro do objeto `wpforms.field`. ### `wpforms.field.lock( formId, fieldId )` Bloqueia um campo específico para que os usuários possam vê-lo, mas não editá-lo. ``` jQuery(document).on('wpformsReady', function() { wpforms.field.lock(123, 5); }); ``` ### `wpforms.field.unlock( formId, fieldId )` Remove o estado de apenas leitura de um campo específico. ``` jQuery(document).on('wpformsReady', function() { wpforms.field.unlock(123, 5); }); ``` ### `wpforms.field.toggle( formId, fieldId, state )` Alterna o estado de apenas leitura de um campo. - true — bloquear o campo - false — desbloquear o campo - ‘auto’ (padrão) — alternar automaticamente dependendo do estado atual ``` // Com estado explícito wpforms.field.toggle(123, 5, true); // Com comportamento padrão ('auto') wpforms.field.toggle(123, 5); ``` ### `wpforms.field.isLocked( formId, fieldId )` Verifica se um campo está atualmente bloqueado. Retorna um booleano. ``` jQuery(document).on('wpformsReady', function() { if ( wpforms.field.isLocked(123, 5) ) { console.log('Campo está bloqueado'); } }); ``` ### `wpforms.field.lockAll( formId )` Bloqueia todos os campos de um formulário. ``` jQuery(document).on('wpformsReady', function() { wpforms.field.lockAll(123); }); ``` ### `wpforms.field.unlockAll( formId )` Desbloqueia todos os campos de um formulário. ``` jQuery(document).on('wpformsReady', function() { wpforms.field.unlockAll(123); }); ``` ### `wpforms.field.readOnlyClass` Retorna o nome da classe CSS aplicada quando um campo é apenas de leitura. ``` console.log( wpforms.field.readOnlyClass ); // 'wpforms-field-readonly' ``` ## Notas - Substitua `123` pelo ID do seu formulário e `5` pelo ID do campo que você deseja direcionar. - Use sempre o evento `wpformsReady` para garantir que os métodos estejam disponíveis. - Esses métodos funcionam apenas no frontend — eles não afetam o construtor de formulários nem as entradas salvas. **Categorias:** Tutoriais, Campos ---