Repolode
Enviar
ddnexus

ddnexus/pagy

Biblioteca de paginação independente de framework para Ruby puro, com paginadores por offset, keyset, busca e calendário para Rails, Sinatra e outros frameworks.

Ver no GitHubSite
Estrelas
4,998
Forks
447
Issues abertas
3
Último commit
anteontem

O que é?

Pagy é uma gem de paginação para Ruby que funciona com qualquer tipo de coleção e ambiente, não apenas com Rails. Ela oferece várias estratégias de paginação, incluindo OFFSET, COUNTISH, COUNTLESS, KEYSET, KEYNAV, SEARCH e CALENDAR, para que os desenvolvedores escolham a abordagem mais adequada ao volume de dados e ao padrão de acesso.

Na camada de renderização, Pagy pode gerar helpers de navegação no servidor com estilos para Bootstrap, Bulma ou o estilo padrão da própria biblioteca, além de componentes de navegação no cliente que ocupam a largura do contêiner. Também oferece suporte a query strings aninhadas do JSON:API e a respostas JSON com metadados de paginação para clientes de API.

Pagy inclui adaptadores para mecanismos de busca como Elasticsearch Rails, Meilisearch, Searchkick e Typesense Rails. O README explica como carregar automaticamente apenas os métodos usados pelo projeto e descreve um painel de ferramentas de desenvolvimento integrado para visualizar estilos dentro de um app em execução.

Recursos principais

  • 01Oferece suporte a OFFSET, KEYSET, COUNTLESS, CALENDAR e outras técnicas de paginação.
  • 02Oferece helpers de navegação no servidor para Bootstrap, Bulma e um estilo padrão.
  • 03Disponibiliza componentes de navegação no cliente que se adaptam à largura do contêiner.
  • 04Gera estruturas de links JSON:API e metadados JSON para clientes de API.
  • 05Oferece adaptadores para Elasticsearch Rails, Meilisearch, Searchkick e Typesense Rails.

Casos de uso

  • Adicionar listas paginadas a uma aplicação Rails com estilos do Bootstrap ou Bulma.
  • Criar uma API JSON que retorne links de paginação no estilo JSON:API.
  • Paginar resultados de busca do Elasticsearch, Meilisearch ou Typesense em Ruby.
  • Paginar dados baseados em tempo por ano, mês, semana ou dia com navegação por calendário.

Início rápido

  1. 1

    Inclua Pagy::Method no seu controller (por exemplo, em application_controller.rb)

  2. 2

    Faça a paginação de uma coleção com pagy(:offset, Product.all)

Em coleções

Frameworks para criar apps e sites

Tópicos

#ruby#pagination#rails#jsonapi#search#web-framework#bootstrap#bulma#elasticsearch-rails#hanami

Perguntas frequentes

O que é pagy?
Biblioteca de paginação independente de framework para Ruby puro, com paginadores por offset, keyset, busca e calendário para Rails, Sinatra e outros frameworks. Pagy é uma gem de paginação para Ruby que funciona com qualquer tipo de coleção e ambiente, não apenas com Rails. Ela oferece várias estratégias de paginação, incluindo OFFSET, COUNTISH, COUNTLESS, KEYSET, KEYNAV, SEARCH e CALENDAR, para que os desenvolvedores escolham a abordagem mais adequada ao volume de dados e ao padrão de acesso.
pagy é gratuito? Qual é a licença?
pagy é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
pagy ainda é mantido?
Manutenção ativa. O último commit de pagy foi em 6 de nov. de 2026.
Para que posso usar pagy?
Adicionar listas paginadas a uma aplicação Rails com estilos do Bootstrap ou Bulma. Criar uma API JSON que retorne links de paginação no estilo JSON:API. Paginar resultados de busca do Elasticsearch, Meilisearch ou Typesense em Ruby. Paginar dados baseados em tempo por ano, mês, semana ou dia com navegação por calendário.
Como instalar pagy?
Inclua Pagy::Method no seu controller (por exemplo, em application_controller.rb) Faça a paginação de uma coleção com pagy(:offset, Product.all)
Onde consigo pagy?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ddnexus/pagy

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados

norman / friendly_id

Uma gem Ruby para Active Record que gera slugs legíveis para encontrar modelos por uma string, como um nome, em vez de um ID numérico.

Backend e APIs#ruby#rails#active-record
6,2 mil591RubyMITAtualizado há 3 meses