关于 RA 的一些必须掌握的 tips

sddtc 于 2017-08-01 发布

一、开启白名单

只显示需要的model列表

config.included_models = [Brand, Product, Admin, Store]

二、修改model的显示title

修改model的title, 修改model下拉框的默认’model #id’名称展示

config.model Brand do
  object_label_method do
    :custom_label_method
  end
end

Brand.class_eval do
  def custom_label_method
    "#{self.english_name}"
  end
end

三、当你新增或更新, 控制model显示不同的title

关键字: new_record? 代表新增

config.model Floor do
  object_label_method do
    :custom_label_method
  end
end

Floor.class_eval do
  def custom_label_method
    if new_record?
      "Floor"
    else
      "#{store.name} - LEVEL #{level}"
    end
  end
end

四、不显示model的个别action

有些model不需要默认的编辑、删除等action. 关键字:except

config.actions do
  dashboard                     # mandatory
  index                         # mandatory
  new do
    except [Brand]
  end
  export do
    except [Brand]
  end
  bulk_delete
  show
  edit do
    except [Brand]
  end
  delete do
    except [Brand]
  end
end

五、自定义引入javascript脚本

若需要动态引入js脚本
1.在项目路径app/assets/javascripts目录下,新建rails_admin/custom目录，即 app/assets/javascripts/rails_admin/custom
2.在1路径里面新建ui.js文件, ui.js内容:

//=require_tree .

3.可新建业务js文件,例如brand.js,和ui.js同级,内容示例:

$(document).on('keyup', '#bundle_set_sale_price', function () {
    var sale_price = numberInputCheck($("#bundle_set_sale_price").val());
    $("#bundle_set_sale_price").val(sale_price);

    var count = $( "#bundle_set_count option:selected" ).text();
    var sale_total_price = (sale_price * count).toFixed(2);
    $("#bundle_set_sale_total_price").val(sale_total_price);
});

六、show页面显示img图片内容

在model详情页面显示图片

show do
  field :background_img do
    formatted_value do
      bindings[:view].tag(:img, {:src => bindings[:object].background_img, :style => "width:400px;height:300px"})
    end
  end
end

七、show页面field字段的值自定义

在model详情页面,让某个字段展示其它内容,例如从数据库读取

show do
  field :id
  field :store_id do
    formatted_value do
      @store = StoresService.find_by_id(self.value)
      @store.chinese_name + ' ' + @store.name
    end
  end
end

八、model设置枚举

model的count属性希望展示下拉列表,采用枚举

def count_enum
  [5, 10, 15]
end

九、model编辑时提示信息自定义

默认是Required, 希望多加一些信息

edit do
  include_all_fields
  fields :images do
    help "Required - Please use 'Enter' for split multiple images"
  end
end

十、表单渲染后设置默认值

表单渲染之后, 有些下拉框或者输入框需要一些默认值, 关键字: after_initialize

after_initialize do
  if new_record?
    self.name ||= 'POI'
    self.lover ||= 'Root'
  end
end

十一、表单控制的唯一索引或联合索引

有些记录的个别字段需要保持唯一性, 除了db层面的控制, 表单层面也可以做一层控制, 关键字: validates_uniqueness_of. 单个索引:保证每条记录名称不重复

validates_uniqueness_of :name

联合索引:关键字scope内相当于是组合唯一索引, 保证记录不重复

validates_uniqueness_of :offer_id, scope: [:offer_id, :count]

十二、设置HTTP请求超时时间

timeout_seconds = 10

RestClient::Request.execute(:method => :post, 
			    :url => url, 
			    :payload=> request, 
			    :timeout => timeout_seconds, 
			    :open_timeout => timeout_seconds)

相关参考:
Ruby&Rails 风格指导
Rails 程序测试指南