当前位置: 首页 > 工具软件 > kaminari > 使用案例 >

kaminari 简要文档

阮俊弼
2023-12-01

安装

    在gemfile增加一行

    gem 'kaminari', '0.14.1'

常用方法

    在Model对象上使用.page()和.per()两个方法,就像.where()一样。

    例如每页10个,取第二页数据

    User.page(2).per(10)

    如果是传参数的话,可以写成

    User.page(params[:page]).per(20)

 

    在View中使用,直接调用它提供的helper方法即可

    <%= paginate @users %>

 

参数配置

    全局参数设置

    执行以下命令,会在config/initializers下生成一个配置文件kaminari_config.rb

    rails g kaminari:config

    这个文件控制着kaminari的全局设置,有以下参数可以定义

    default_per_page    默认值25

    page_method_name  分页方法的名称

    param_name  分页参数的参数名,默认为param

    window / outer_window / left / right 这四个参数都与分页显示有关,设定了显示页码标签的方式和数量。

分页界面定制

    执行一下命令可以获取默认模版文件。目录在app/views/kaminari/下

    rails g kaminari:views default

    各个文件描述如下

    _paginator.html.erb 这是总的入口文件,可以通过修改它来调整显示的整体结构
     比如我不需要“首页”,”末页“这两个链接,那么我就在这个文件里面将对应的代码删除
    _page.html.erb 对应页码链接
    _first_page.html.erb / _last_page.html.erb 对应“首页”和“末页”的链接
    _prev_page.html.erb / _next_page.html.erb 对应“上一页”和“下一页”的链接
    _gap.html.erb 空隙的显示,默认是中间的省略号(...)

 

    注意,不要修改文件名。

 

    theme功能

    在app/views/kaminari目录下创建一个文件夹,例如test,把默认的模版文件拷贝进去,修改模版文件的内容,就形成了个性化的样式。

    view页面按下方写法即可调用个性样式。

    <%= paginate @blogs, :theme=>'test' %>

源资源文档

    https://github.com/edokeh/klog/tree/master/app/views/kaminari

 类似资料: