Class: Avo::Views::ResourceIndexComponent

Inherits:
ResourceComponent
  • Object
show all
Includes:
ApplicationHelper, ResourcesHelper
Defined in:
app/components/avo/views/resource_index_component.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from ApplicationHelper

#a_button, #a_link, #button_classes, #card_classes, #chart_color, #decode_filter_params, #empty_state, #encode_filter_params, #frame_id, #get_model_class, #input_classes, #mount_path, #number_to_social, #render_license_warning, #root_path_without_url, #svg, #white_panel_classes

Methods included from ResourcesHelper

#field_wrapper, #filter_wrapper, #index_field_wrapper, #item_select_all_input, #item_selector_init, #item_selector_input, #resource_grid, #resource_table

Constructor Details

#initialize(resource: nil, resources: nil, records: [], pagy: nil, index_params: {}, filters: [], actions: [], reflection: nil, turbo_frame: "", parent_record: nil, parent_resource: nil, applied_filters: [], query: nil, scopes: nil) ⇒ ResourceIndexComponent

Returns a new instance of ResourceIndexComponent.



9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# File 'app/components/avo/views/resource_index_component.rb', line 9

def initialize(
  resource: nil,
  resources: nil,
  records: [],
  pagy: nil,
  index_params: {},
  filters: [],
  actions: [],
  reflection: nil,
  turbo_frame: "",
  parent_record: nil,
  parent_resource: nil,
  applied_filters: [],
  query: nil,
  scopes: nil
)
  @resource = resource
  @resources = resources
  @records = records
  @pagy = pagy
  @index_params = index_params
  @filters = filters
  @actions = actions
  @reflection = reflection
  @turbo_frame = turbo_frame
  @parent_record = parent_record
  @parent_resource = parent_resource
  @applied_filters = applied_filters
  @view = Avo::ViewInquirer.new("index")
  @query = query
  @scopes = scopes
end

Instance Attribute Details

#actionsObject (readonly)

Returns the value of attribute actions.



7
8
9
# File 'app/components/avo/views/resource_index_component.rb', line 7

def actions
  @actions
end

#parent_recordObject (readonly)

Returns the value of attribute parent_record.



7
8
9
# File 'app/components/avo/views/resource_index_component.rb', line 7

def parent_record
  @parent_record
end

#parent_resourceObject (readonly)

Returns the value of attribute parent_resource.



7
8
9
# File 'app/components/avo/views/resource_index_component.rb', line 7

def parent_resource
  @parent_resource
end

#queryObject (readonly)

Returns the value of attribute query.



7
8
9
# File 'app/components/avo/views/resource_index_component.rb', line 7

def query
  @query
end

#resourceObject (readonly)

Returns the value of attribute resource.



7
8
9
# File 'app/components/avo/views/resource_index_component.rb', line 7

def resource
  @resource
end

#scopesObject (readonly)

Returns the value of attribute scopes.



7
8
9
# File 'app/components/avo/views/resource_index_component.rb', line 7

def scopes
  @scopes
end

#turbo_frameObject (readonly)

Returns the value of attribute turbo_frame.



7
8
9
# File 'app/components/avo/views/resource_index_component.rb', line 7

def turbo_frame
  @turbo_frame
end

Instance Method Details

#attach_pathObject



101
102
103
104
105
106
107
108
109
110
111
# File 'app/components/avo/views/resource_index_component.rb', line 101

def attach_path
  current_path = CGI.unescape(request.env["PATH_INFO"]).split("/").select(&:present?)

  Avo.root_path(
    paths: [*current_path, "new"],
    query: {
      view: @parent_resource&.view&.to_s,
      for_attribute: field&.try(:for_attribute)
    }.compact
  )
end

#authorized_to_search?Boolean

Returns:

  • (Boolean)


142
143
144
145
# File 'app/components/avo/views/resource_index_component.rb', line 142

def authorized_to_search?
  # Hide the search if the authorization prevents it
  resource.authorization.authorize_action("search", raise_exception: false)
end

#available_view_typesObject



56
57
58
# File 'app/components/avo/views/resource_index_component.rb', line 56

def available_view_types
  @index_params[:available_view_types]
end

#can_attach?Boolean

Returns:

  • (Boolean)


68
69
70
71
72
73
# File 'app/components/avo/views/resource_index_component.rb', line 68

def can_attach?
  klass = @reflection
  klass = @reflection.through_reflection if klass.is_a? ::ActiveRecord::Reflection::ThroughReflection

  @reflection.present? && klass.is_a?(::ActiveRecord::Reflection::HasManyReflection) && !has_reflection_and_is_read_only && authorize_association_for(:attach)
end

#can_render_scopes?Boolean

Returns:

  • (Boolean)


175
176
177
# File 'app/components/avo/views/resource_index_component.rb', line 175

def can_render_scopes?
  defined?(Avo::Advanced)
end

#can_see_the_create_button?Boolean

The Create button is dependent on the new? policy method. The create? should be called only when the user clicks the Save button so the developers gets access to the params from the form.

Returns:

  • (Boolean)


62
63
64
65
66
# File 'app/components/avo/views/resource_index_component.rb', line 62

def can_see_the_create_button?
  return authorize_association_for(:create) if @reflection.present?

  @resource.authorization.authorize_action(:new, raise_exception: false) && !has_reflection_and_is_read_only
end

#create_pathObject



75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
# File 'app/components/avo/views/resource_index_component.rb', line 75

def create_path
  args = {}

  if @reflection.present?
    args = {
      via_resource_class: @parent_resource.class,
      via_relation_class: reflection_model_class,
      via_record_id: @parent_record.to_param
    }

    if @reflection.is_a? ActiveRecord::Reflection::ThroughReflection
      args[:via_relation] = params[:resource_name]
    end

    if @reflection.is_a? ActiveRecord::Reflection::HasManyReflection
      args[:via_relation] = @reflection.name
    end

    if @reflection.inverse_of.present?
      args[:via_relation] = @reflection.inverse_of.name
    end
  end

  helpers.new_resource_path(resource: @resource, **args)
end

#descriptionObject



123
124
125
126
127
128
129
130
131
132
# File 'app/components/avo/views/resource_index_component.rb', line 123

def description
  # If this is a has many association, the user can pass a description to be shown just for this association.
  if @reflection.present?
    return field.description if field.present? && field.description

    return
  end

  @resource.description
end

#render_dynamic_filters_buttonObject



147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
# File 'app/components/avo/views/resource_index_component.rb', line 147

def render_dynamic_filters_button
  return unless Avo.avo_dynamic_filters_installed?
  return unless resource.has_filters?
  return if Avo::DynamicFilters.configuration.always_expanded

  a_button size: :sm,
    color: :primary,
    icon: "filter",
    data: {
      controller: "avo-filters",
      action: "click->avo-filters#toggleFiltersArea",
      avo_filters_dynamic_filters_component_id_value: dynamic_filters_component_id
    } do
    Avo::DynamicFilters.configuration.button_label
  end
end

#scopes_listObject



164
165
166
167
168
169
170
171
172
173
# File 'app/components/avo/views/resource_index_component.rb', line 164

def scopes_list
  Avo::Advanced::Scopes::ListComponent.new(
    scopes: scopes,
    resource: resource,
    turbo_frame: turbo_frame,
    parent_record: parent_record,
    query: query,
    loader: resource.entity_loader(:scope)
  )
end

#show_search_inputObject



134
135
136
137
138
139
140
# File 'app/components/avo/views/resource_index_component.rb', line 134

def show_search_input
  return false unless authorized_to_search?
  return false unless resource.class.search_query.present?
  return false if field&.hide_search_input

  true
end

#singular_resource_nameObject



113
114
115
116
117
118
119
120
121
# File 'app/components/avo/views/resource_index_component.rb', line 113

def singular_resource_name
  if @reflection.present?
    return name.singularize if field.present?

    reflection_resource.name
  else
    @resource.singular_name || @resource.model_class.model_name.name.downcase
  end
end

#titleObject



42
43
44
45
46
47
48
49
50
# File 'app/components/avo/views/resource_index_component.rb', line 42

def title
  if @reflection.present?
    return name if field.present?

    reflection_resource.plural_name
  else
    @resource.plural_name
  end
end

#view_typeObject



52
53
54
# File 'app/components/avo/views/resource_index_component.rb', line 52

def view_type
  @index_params[:view_type]
end