module Uber::Builder::ClassMethods
Public Instance Methods
Adds a builder to the cell class. Builders are used in cell to find out the concrete class for rendering. This is helpful if you frequently want to render subclasses according to different circumstances (e.g. login situations) and you don't want to place these deciders in your view code.
Passes the model and options from cell into the block.
Multiple build blocks are ORed, if no builder matches the building cell is used.
Example:
Consider two different user box cells in your app.
class AuthorizedUserBox < UserInfoBox end class AdminUserBox < UserInfoBox end
Now you don't want to have deciders all over your views - use a declarative builder.
UserInfoBox.build do |model, options| AuthorizedUserBox if options[:is_signed_in] AdminUserBox if model.admin? end
In your view cell will instantiate the right class for you now.
# File lib/uber/builder.rb, line 86 def builds(proc=nil, &block) builders << Uber::Options::Value.new(proc.nil? ? block : proc) # TODO: provide that in Uber::O:Value. end
Call this from your classes' own ::build method to compute the concrete target class. The #class_builder is cached, you can't change the context once it's set.
# File lib/uber/builder.rb, line 92 def class_builder(context=nil) @class_builder ||= Constant.new(self, context) end