class Marten::Handlers::RecordList

Overview

Handler allowing to list model records.

This base handler can be used to easily expose a list of model records:

class MyHandler < Marten::Handlers::RecordList
  template_name = "my_template"
  model Post
end

Optionally, it is possible to configure that records should be paginated:

class MyHandler < Marten::Handlers::RecordList
  template_name = "my_template"
  model Post
  page_size 12
end

When records are paginated, a Marten::DB::Query::Page will be exposed in the template context (instead of the raw query set).

Included Modules

Extended Modules

Defined in:

marten/handlers/record_list.cr

Class Method Summary

Instance Method Summary

Instance methods inherited from module Marten::Handlers::RecordListing

model : Model.class model, paginate_queryset paginate_queryset, queryset queryset

Instance methods inherited from class Marten::Handlers::Template

context context, get get

Class methods inherited from class Marten::Handlers::Template

template_name : String | Nil template_name

Instance methods inherited from module Marten::Handlers::Rendering

get_response(content) get_response, render_template(context : Hash | NamedTuple | Nil | Marten::Template::Context) render_template, render_to_response(context : Hash | NamedTuple | Nil | Marten::Template::Context) render_to_response, template_name : String template_name

Instance methods inherited from class Marten::Handlers::Base

delete delete, dispatch : Marten::HTTP::Response dispatch, get get, head(status : Int32) : HTTP::Response
head head, json(raw_json : String, status = 200)
json(serializable, status = 200) json, options options, params : Hash(String, Int16 | Int32 | Int64 | Int8 | String | UInt16 | UInt32 | UInt64 | UInt8 | UUID) params, patch patch, post post, put put, redirect(url : String, permanent = false) redirect, render(template_name : String, context : Hash | NamedTuple | Nil | Marten::Template::Context = nil, content_type = HTTP::Response::DEFAULT_CONTENT_TYPE, status = 200) render, request : Marten::HTTP::Request request, respond(content = "", content_type = HTTP::Response::DEFAULT_CONTENT_TYPE, status = 200) respond, response : Marten::HTTP::Response? response, response! response!, reverse(*args, **options)
reverse(*args, **options, &) reverse, trace trace

Constructor methods inherited from class Marten::Handlers::Base

new(request : HTTP::Request, params : Hash(String, Routing::Parameter::Types))
new(request : HTTP::Request) new

Class methods inherited from class Marten::Handlers::Base

http_method_names
http_method_names(*method_names : String | Symbol) http_method_names

Instance methods inherited from module Marten::Handlers::Session

session(*args, **options)
session(*args, **options, &) session

Instance methods inherited from module Marten::Handlers::RequestForgeryProtection

get_csrf_token get_csrf_token, referer_trusted? referer_trusted?

Instance methods inherited from module Marten::Handlers::Flash

flash(*args, **options)
flash(*args, **options, &) flash

Instance methods inherited from module Marten::Handlers::Cookies

cookies(*args, **options)
cookies(*args, **options, &) cookies

Class Method Detail

def self.list_context_name(name : String | Symbol) #

Allows to configure the name to use to include the list of records into the template context.


[View source]
def self.list_context_name : String #

Returns the name to use to include the record list into the template context (defaults to records).


[View source]
def self.model : DB::Model.class | Nil #

Returns the configured model class.


def self.ordering : Array(String) | Nil #

Returns the array of fields to use to order the records.


def self.page_number_param : String #

Returns the name of the page number parameter.


def self.page_size : Int32 | Nil #

Returns the page size to use if records should be paginated.


Instance Method Detail

def context #
Description copied from class Marten::Handlers::Template

Returns a hash containing the template context or nil.

The default implementation returns nil.


[View source]