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(7y ago)0139↓95%2MITJavaScript

Since Dec 20Pushed 7y 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 yesterday

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

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

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity63

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

2639d 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

[eternicode/bootstrap-datepicker

A datepicker for Bootstrap

12.7k552.0k6](/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.2k500.2k9](/packages/eonasdan-bootstrap-datetimepicker)[nicolaskruchten/pivottable

Javascript Pivot Table (aka Pivot Grid, Pivot Chart, Cross-Tab) implementation with drag'n'drop.

4.4k223.4k1](/packages/nicolaskruchten-pivottable)[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.6k234.4k](/packages/mottie-tablesorter)[components/jqueryui

jQuery UI is a curated set of user interface interactions, effects, widgets, and themes built on top of the jQuery JavaScript Library. Whether you're building highly interactive web applications or you just need to add a date picker to a form control, jQuery UI is the perfect choice.

1775.9M61](/packages/components-jqueryui)

PHPackages © 2026

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