PHPackages                             dlepera88-jquery/jquery-form-ajax - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. dlepera88-jquery/jquery-form-ajax

ActiveLibrary[Utility & Helpers](/categories/utility)

dlepera88-jquery/jquery-form-ajax
=================================

2.0.1(6y ago)086↑233.3%1MITJavaScript

Since Dec 20Pushed 6y ago1 watchersCompare

[ Source](https://github.com/dlepera88-jquery/jquery-form-ajax)[ Packagist](https://packagist.org/packages/dlepera88-jquery/jquery-form-ajax)[ RSS](/packages/dlepera88-jquery-jquery-form-ajax/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (1)

Plugin jQuery Form Ajax
=======================

[](#plugin-jquery-form-ajax)

Realizar o submit de um formulário via AJAX (jQuery).

Pré-requisitos
--------------

[](#pré-requisitos)

Esse plugin necessita do jQuery ().

Funcionalidades
---------------

[](#funcionalidades)

- Submit do formulário via AJAX
- Envio de arquivos para upload via AJAX
- Validação adicional de campos
- Submit alternativo do formulário
- Simulação do antigo evento beforesubmit

Opções
------

[](#opções)

### validar\_invisiveis

[](#validar_invisiveis)

`boolean default false`

Define se o plugin deve permitir a validação dos controles do formulário que não sejam visíveis. Quando false, desativa os campos invisíveis para evitar a validação.

**ATENÇÃO**: essa funcionalidade é incluída no evento click do botão submit. Caso o formulário não tenha um botão submit, essa configuração não funcionará.

```
var $meu_form = $('#meu-form');

$meu_form.formAjax({validar_invisiveis:true});

$meu_form.formAjax({validar_invisiveis:false});
```

### func\_antes

[](#func_antes)

`function default null`

Função a ser executada antes do submit do form. Ela simula o comportamento do antigo evento beforesubmit. Se ela retornar false, interrompe o submit do formulário.

Obs: Essa função recebe o DOM do seu formulário como parâmetro.

Exemplo de função 'func\_antes':

```
function (form) {
    /* Aqui eu faço o que eu quiser com o DOM do form e / ou aplico a lógica que eu precisar */

    // Obrigatóriamente denho que retornar boolean:
    // true: procede com o submit
    // false: interrompe o evento
    return true/false;
}
```

```
$('#meu-form').formAjax({
    func_antes: function () {
        return confirm('Tem certeza que deseja enviar essas informações?');
    }
});
```

### func\_depois

[](#func_depois)

`function default null`

Função a ser executada após o submit do formulário. Recebe como primeiro parâmetro o retorno do submit, possibilitando o tratamento e exibição do retorno. O segundo parâmetro que essa função recebe é o DOM do seu formulário como parâmetro. Não precisa retornar nada.

Exemplo de função 'func\_depois':

```
function (retorno, form) {
    /* Aqui eu faço o que eu quiser com o retorno e o DOM do form */
}
```

```
$('#meu-form').formAjax({
    func_depois: function (retorno) {
        alert(retorno);
    }
});
```

Exemplos
--------

[](#exemplos)

### Realizando um submit alternativo do formulário

[](#realizando-um-submit-alternativo-do-formulário)

Esse plugin permite que as informações sejam submetidas para diferentes actions com diferentes configurações. Essa funcionalidade simula a especificação do HTML5 para buttons mas que funciona apenas em navegadores muito recentes e não foi completamente imlementada ainda: [https://www.w3schools.com/tags/att\_button\_formaction.asp](https://www.w3schools.com/tags/att_button_formaction.asp)

```

    Envio padrão
    Envio alternativo

// Aqui eu configuro o formulário para usar o plugin
$('#meu-form').formAjax();

// Agora eu configuro o botão 'Envio alternativo' para alterar o submit do form
$('#btn-alternativo').on('click', function () {
    #('#meu-form').formAjax('submit-alternativo', {
        acao: 'pagina2.php'
    });
});

```

### Incluindo validação adicional em um determinado campo

[](#incluindo-validação-adicional-em-um-determinado-campo)

Para incluir uma validação adicional em um determinado campo, deve-se utilizar o parâmetro data-vld-func em conjunto com data-vld-msg, onde:

`data-vld-func` deve receber o nome da função a ser utilizada para a validação. Essa função deve retornar um valor booleano e sempre receberá o valor do campo como parâmetro.

data-vld-msg` deve receber a mensagem que deve ser exibida ao usuário caso o campo não passe na validação.

No exemplo abaixo, valido se o campo foi preenchido com um número par:

```

    Enviar form

// Primeiro eu configuro o meu formulário para utilizar o plugin
$('#meu-form').formAjax();

// Essa é a função que vai validar se o número é par. Lembrando que ela deve retornar um valor booleano
function validaNumeroPar(numero) {
    return numero % 2 === 0;
}

```

Desenvolvedor
-------------

[](#desenvolvedor)

Diego Lepera

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~151 days

Total

2

Last Release

2548d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1afa4658a3cc99dea3df71b451a3c2a5f7b33f2ef261516a566987b4fff885cb?d=identicon)[dlepera88](/maintainers/dlepera88)

---

Top Contributors

[![dlepera](https://avatars.githubusercontent.com/u/6875116?v=4)](https://github.com/dlepera "dlepera (17 commits)")

---

Tags

ajax-formajax-uploadjqueryjquery-plugin

### Embed Badge

![Health badge](/badges/dlepera88-jquery-jquery-form-ajax/health.svg)

```
[![Health](https://phpackages.com/badges/dlepera88-jquery-jquery-form-ajax/health.svg)](https://phpackages.com/packages/dlepera88-jquery-jquery-form-ajax)
```

###  Alternatives

[fullcalendar/fullcalendar

Full-sized drag & drop event calendar

20.4k373.3k4](/packages/fullcalendar-fullcalendar)[eternicode/bootstrap-datepicker

A datepicker for Bootstrap

12.7k543.8k6](/packages/eternicode-bootstrap-datepicker)[vakata/jstree

jsTree is jquery plugin, that provides interactive trees.

5.2k1.8M11](/packages/vakata-jstree)[eonasdan/bootstrap-datetimepicker

Date/time picker widget based on twitter bootstrap

7.2k492.4k9](/packages/eonasdan-bootstrap-datetimepicker)[rmm5t/jquery-timeago

jQuery plugin that makes it easy to support automatically updating fuzzy timestamps (e.g. "4 minutes ago" or "about 1 day ago").

3.8k174.2k2](/packages/rmm5t-jquery-timeago)[mottie/tablesorter

tablesorter (FORK) is a jQuery plugin for turning a standard HTML table with THEAD and TBODY tags into a sortable table without page refreshes. tablesorter can successfully parse and sort many types of data including linked data in a cell.

2.6k223.5k](/packages/mottie-tablesorter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)