PHPackages                             rafwell/laravel-grid - 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. rafwell/laravel-grid

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

rafwell/laravel-grid
====================

Um componente simples para geração de grids poderosos com Laravel.

2.0.0(5y ago)71.5k3MITJavaScript

Since Nov 1Pushed 5y ago3 watchersCompare

[ Source](https://github.com/rafwell/laravel-grid)[ Packagist](https://packagist.org/packages/rafwell/laravel-grid)[ RSS](/packages/rafwell-laravel-grid/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (1)Versions (11)Used By (0)

Sobre o projeto
---------------

[](#sobre-o-projeto)

**rafwell/laravel-grid** é um componente para criação de grids poderosos, com poucas linhas de código. O componente está pronto para funcionar com seu projeto em Bootstrap 3, possui funcionalidades de exportação para Excel ou XLS, pesquisa avançada ou simples, ordenação e ações em linha ou em massa.

Aviso legal
-----------

[](#aviso-legal)

Uma nova versão deste pacote foi lançada, em um repositório separado para que você possa rodar os dois em simultâneo e realizar a migraço da maneira mais suave possível. Na nova versão temos suporte para multi-idioma e o código fonte está 100% em inglês. Novas funcionalidades só serão incluídas no novo repositório, deixando este depreciado. Este é o link [rafwell/laravel-simplegrid](https://github.com/rafwell/laravel-simplegrid).

Disclaimer
----------

[](#disclaimer)

A new version of this package will released! The new version support multi-language features to expand our limits! This one repository was descontinued when the new is ready. All current features will be work on the new version, small modifications on structure (for best use) and the code will be rewriten to english. With this, it will not be possible to maintain a compatibility between the current and the new. However, because it is another repository, and another namespace, you can work with the two simultaneously, performing the migration smoothly. Here's the link for the new repository [rafwell/laravel-simplegrid](https://github.com/rafwell/laravel-simplegrid).

Compatibilidade
---------------

[](#compatibilidade)

**rafwell/laravel-grid** é compatível com Laravel 5.2+

Instalação
----------

[](#instalação)

1. Adicione a dependência ao seu composer.json `composer require "rafwell/laravel-grid"`.
2. Adicione ao seu `app/config/app.ph` o seguinte provider: ```
    Rafwell\Grid\GridServiceProvider::class

    ```
3. Execute: `php artisan vendor:publish`
4. Inclua na sua view ou layout os arquivos js e css. Aqui espero que você já tenha o bootstrap configurado e funcionando no seu ambiente. Este pacote já inclui a versão necessária de cada componente para perfeita utilização, para sua comodidade. Mas você pode usar o CDN do distribuidor se preferir.

### JS e CSS de terceiros

[](#js-e-css-de-terceiros)

Este pacote foi escrito para trabalhar com bootstrap 3 e Jquery. Utilizamos os seguintes auxiliares, que você deve ter em seu projeto, para correta utilização das funções do sistema:

- [Datetimepicker](https://eonasdan.github.io/bootstrap-datetimepicker/), para pesquisa avançada em campos date e datetime.
- [Priceformat](http://jquerypriceformat.com/), para pesquisa avançada em campos money.
- [Fontawesome](http://fontawesome.io/), para icones.

Provavelmente você já tem esses componentes em seu sistema, pois são bem comuns em sistemas web.

#### Arquivos JS

[](#arquivos-js)

```

```

#### Arquivos CSS

[](#arquivos-css)

```

```

Um exemplo simples
------------------

[](#um-exemplo-simples)

No seu controller:

```
use Rafwell\Grid\Grid;

```

Na sua função:

```
//Produto é um model para a tabela produtos
$Grid = (new Grid(Produto::query(), 'ProdutoGridId'))
    ->campos([
        'id'=>'Código',//id é a coluna no banco de dados e 'Código' é como ela será exibida na tela
        'descricao'=>'Descrição',
        'status'=>[ //Exemplo utilizando campos calculados dentro do banco de dados
          'rotulo'=>'Ativo',
          'campo'=>"case when ativo = 1 then 'Sim' else 'Não' end"
        ],
        'created_at'=>'Data Criação',
        'preco'=>'Preço'
    ])
    ->acao('Editar', 'admin/produtos/{id}/edit') //Botão editar, entre chaves "{}" qualquer campo que foi utilizado acima, inclusive os calculados. Neste caso: id, descricao ou status
    ->acao('Excluir', 'admin/produtos/{id}', false, false, 'DELETE', 'Deseja realmente excluir este registro?')
    ->pesquisaAvancada([
    	'id'=>['rotulo'=>'Código','tipo'=>'integer'],
    	'created_at'=>['rotulo'=>'Data Criação','tipo'=>'date'],
    	'descricao'=>['rotulo'=>'Descrição','tipo'=>'text'],
    	'preco'=>['rotulo'=>'Preço','tipo'=>'money'],

    ])->trataLinha(function($linha){
    	$linha['created_at'] = date('d/m/Y', strtotime($linha['created_at']));
    	//O campo preço está sendo formatado via mutators dentro do model Produto
    	return $linha;
    });

```

Quando $Grid->make() é chamado, um sql semelhante a este será executado:

```
select
  id,
  descricao,
  status
from (
  select
    id,
    descricao,
    (case when ativo = 1 then 'Sim' else 'Não' end) as status
  from produtos
) s

```

Finalmente, exiba o grid na sua view:

```
{!!$grid!!}

```

A visualização será semelhante a isto: [![Imagem 1 - Grid simples](https://camo.githubusercontent.com/c8d50dc0838c095a4aef92a96245c2a6fe6b1103f9e27f48b480e8c7d6088fa5/68747470733a2f2f7333312e706f7374696d672e6f72672f356d653830787672662f436170747572615f64655f74656c615f64655f323031365f30385f30315f32305f32335f35342e706e67)](https://camo.githubusercontent.com/c8d50dc0838c095a4aef92a96245c2a6fe6b1103f9e27f48b480e8c7d6088fa5/68747470733a2f2f7333312e706f7374696d672e6f72672f356d653830787672662f436170747572615f64655f74656c615f64655f323031365f30385f30315f32305f32335f35342e706e67)

Um exemplo um pouco mais completo
---------------------------------

[](#um-exemplo-um-pouco-mais-completo)

No exemplo acima, ao realizar uma pesquisa na caixa de buscas todos os campos visíveis no grid são concatenados e pesquisados sob um like '%string%'. Na pesquisa avançada é possível pesquisar campo a campo, strings, inteiros, decimais, datas e horas, com a simples inclusão de uma chamada à função pesquisaAvancada.

```
//Produto é o model da tabela produtos
$Grid = (new Grid(Produto::query(), 'ProdutoGridId'))
    ->campos([
        'id'=>'Código',//id é a coluna no banco de dados e 'Código' é como ela será exibida na tela
        'descricao'=>'Descrição',
        'status'=>[ //Exemplo utilizando campos calculados dentro do banco de dados
          'rotulo'=>'Ativo',
          'campo'=>"case when ativo = 1 then 'Sim' else 'Não' end"
        ],
        'created_at'=>'Data Criação',
        'preco'=>'Preço'
    ])
    ->acao('Editar', 'admin/produtos/{id}/edit') //Botão editar, entre chaves "{}" qualquer campo que foi utilizado acima, inclusive os calculados. Neste caso: id, descricao ou status
    ->acao('Excluir', 'admin/produtos/{id}', false, false, 'DELETE', 'Deseja realmente excluir este registro?')
    ->pesquisaAvancada([
        'id'=>['rotulo'=>'Código','tipo'=>'integer'],
        'created_at'=>['rotulo'=>'Data Criação','tipo'=>'date'],
        'descricao'=>['rotulo'=>'Descrição','tipo'=>'text'],
        'preco'=>['rotulo'=>'Preço','tipo'=>'money'],

    ])->trataLinha(function($linha){
        $linha['created_at'] = date('d/m/Y', strtotime($linha['created_at']));
        //O campo preço está sendo formatado via mutators dentro do model Produto
        return $linha;
    });

return view('suaview',[
    'grid'=>$Grid->make(),
]);

```

O resultado incluirá um botão de pesquisa avançada que quando clicado, exibirá o grid da seguinte maneira: [![Imagem 2 - Pesquisa avançada](https://camo.githubusercontent.com/85693ffe5132e6bb4073b491bd111f198b26d2f33a4fe7651e1dca306f1757af/68747470733a2f2f7333322e706f7374696d672e6f72672f356b316e63667731312f436170747572615f64655f74656c615f64655f323031365f30385f30315f32305f32315f30342e706e67)](https://camo.githubusercontent.com/85693ffe5132e6bb4073b491bd111f198b26d2f33a4fe7651e1dca306f1757af/68747470733a2f2f7333322e706f7374696d672e6f72672f356b316e63667731312f436170747572615f64655f74656c615f64655f323031365f30385f30315f32305f32315f30342e706e67)

Tratando ações em linha
-----------------------

[](#tratando-ações-em-linha)

Em alguns casos você pode não querer exibir alguma ação em uma determinada linha. Por exemplo, para um orçamento aprovado, você pode permitir sua exclusão. Para solucionar este cenário, temos a função trataLinha, que pode alterar elementos do grid, inclusive as ações. Esta função é chamada a cada linha e você pode fazer sua verificação e tomar as ações necessárias:

```
->trataLinha(function($linha){
    if($linha['status_proposta_id'] === 2){
      unset($linha['gridAcoes']['Excluir']);
    }
    return $linha;
})

```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity69

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 ~182 days

Recently: every ~340 days

Total

9

Last Release

2058d ago

Major Versions

1.1.6 → 2.0.02020-11-03

### Community

Maintainers

![](https://www.gravatar.com/avatar/a891668c48ee4e1989d3fb1852cd669e1b4f6fe55673a00ee9f07c36c4ff6143?d=identicon)[rafwell](/maintainers/rafwell)

---

Top Contributors

[![rafwell](https://avatars.githubusercontent.com/u/2893078?v=4)](https://github.com/rafwell "rafwell (38 commits)")

### Embed Badge

![Health badge](/badges/rafwell-laravel-grid/health.svg)

```
[![Health](https://phpackages.com/badges/rafwell-laravel-grid/health.svg)](https://phpackages.com/packages/rafwell-laravel-grid)
```

###  Alternatives

[unopim/unopim

UnoPim Laravel PIM

10.3k2.2k](/packages/unopim-unopim)[arm092/livewire-datatables

Advanced datatables using Laravel, Livewire, Tailwind CSS and Alpine JS

3058.4k](/packages/arm092-livewire-datatables)[ronasit/laravel-helpers

Provided helpers function and some helper class.

2082.5k25](/packages/ronasit-laravel-helpers)[tapp/filament-form-builder

User facing form builder using Filament components

141.9k2](/packages/tapp-filament-form-builder)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.2k](/packages/tomshaw-electricgrid)[team-nifty-gmbh/tall-datatables

Server-side rendered datatables for Laravel and Livewire

1319.7k3](/packages/team-nifty-gmbh-tall-datatables)

PHPackages © 2026

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