Class: Compony::Components::WithForm

Inherits:
Compony::Component show all
Defined in:
lib/compony/components/with_form.rb

Overview

This component is destined to take a sub-component that is a form component. It can be called via :get or via submit_verb depending on whether its form should be shown or submitted.

Direct Known Subclasses

Edit, New

Instance Attribute Summary

Attributes inherited from Compony::Component

#comp_opts, #parent_comp

Instance Method Summary collapse

Methods inherited from Compony::Component

#action, #add_content, #before_render, #comp_class_for, #comp_class_for!, #comp_cst, #comp_name, #content, #family_cst, #family_name, #id, #inspect, #param_name, #path, #path_hash, #render, #render_actions, #resourceful?, #root_comp, #root_comp?, setup, #skip_action, #sub_comp

Constructor Details

#initialize ⇒ WithForm

Returns a new instance of WithForm.



7
8
9
10
11
 
# File 'lib/compony/components/with_form.rb', line 7

def initialize(...)
  # TODO: On the next line, use Compony.path instead? Likely, this was implemented before that method existed.
  @submit_path_block = ->(controller) { controller.helpers.send("#{Compony.path_helper_name(comp_name, family_name)}_path") }
  super
end

Instance Method Details

#form_comp ⇒ Object

Returns an instance of the form component responsible for rendering the form. Feel free to override this in subclasses.



15
16
17
18
19
20
21
22
 
# File 'lib/compony/components/with_form.rb', line 15

def form_comp
  @form_comp ||= (form_comp_class || comp_class_for!(:form, family_cst)).new(
    self,
    submit_verb:,
    # If applicable, Rails adds the route keys automatically, thus, e.g. :id does not need to be passed here, as it comes from the request.
    submit_path: @submit_path_block
  )
end

#form_comp_class(new_form_comp_class = nil) ⇒ Object

DSL method Overrides the form comp class that is instanciated to render the form



38
39
40
 
# File 'lib/compony/components/with_form.rb', line 38

def form_comp_class(new_form_comp_class = nil)
  @form_comp_class ||= new_form_comp_class
end

#submit_path(&new_submit_path_block) ⇒ Object

DSL method Overrides the submit path which would otherwise default to this component This takes a block that will be called and given a controller



45
46
47
 
# File 'lib/compony/components/with_form.rb', line 45

def submit_path(&new_submit_path_block)
  @submit_path_block = new_submit_path_block
end

#submit_verb(new_submit_verb = nil) ⇒ Object

DSL method Sets or returns the previously set submit verb



26
27
28
29
30
31
32
33
34
 
# File 'lib/compony/components/with_form.rb', line 26

def submit_verb(new_submit_verb = nil)
  if new_submit_verb.present?
    new_submit_verb = new_submit_verb.to_sym
    available_verbs = ComponentMixins::Default::Standalone::VerbDsl::AVAILABLE_VERBS
    fail "Unknown HTTP verb #{new_submit_verb.inspect}, use one of #{available_verbs.inspect}" unless available_verbs.include?(new_submit_verb)
    @submit_verb = new_submit_verb
  end
  return @submit_verb || fail("WithForm component #{self} is missing a call to `submit_verb`.")
end