Class: Blacklight::DocumentComponent

Inherits:
Component
  • Object
show all
Defined in:
app/components/blacklight/document_component.rb

Overview

Note:

when subclassing this component, if you override the initializer, you must explicitly specify the counter variable document_counter even if you don't use it. Otherwise view_component will not provide the count value when calling the component.

A component for rendering a single document

Examples:

class MyDocumentComponent < Blacklight::DocumentComponent
  def initialize(document_counter: nil, **kwargs)
    super
    ... custom code ...
  end
end

See Also:

Instance Method Summary collapse

Constructor Details

#initialize(document: nil, partials: nil, id: nil, classes: [], component: :article, title_component: nil, counter: nil, document_counter: nil, counter_offset: 0, show: false) ⇒ DocumentComponent

rubocop:disable Metrics/ParameterLists

Parameters:

  • document (Blacklight::DocumentPresenter) (defaults to: nil)
  • partials (Array, nil) (defaults to: nil) —

    view partial names that should be used to provide content for the partials slot

  • id (String) (defaults to: nil) —

    HTML id for the root element

  • classes (Array, String) (defaults to: []) —

    additional HTML classes for the root element

  • component (Symbol, String) (defaults to: :article) —

    HTML tag type to use for the root element

  • title_component (Symbol, String) (defaults to: nil) —

    HTML tag type to use for the title element

  • counter (Number, nil) (defaults to: nil) —

    a pre-computed counter for the position of this document in a search result set

  • document_counter (Number, nil) (defaults to: nil) —

    provided by ViewComponent collection iteration

  • counter_offset (Number) (defaults to: 0) —

    the offset of the start of the collection counter parameter for the component to the overall result set

  • show (Boolean) (defaults to: false) —

    are we showing only a single document (vs a list of search results); used for backwards-compatibility



86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
 
# File 'app/components/blacklight/document_component.rb', line 86

def initialize(document: nil, partials: nil,
               id: nil, classes: [], component: :article, title_component: nil,
               counter: nil, document_counter: nil, counter_offset: 0,
               show: false)
  @presenter = document
  @document = @presenter.document
  @view_partials = partials || []

  @component = component
  @title_component = title_component
  @id = id
  @classes = classes

  @counter = counter
  @document_counter = document_counter
  @counter ||= 1 + @document_counter + counter_offset if @document_counter.present?

  @show = show
end

Instance Method Details

#before_render ⇒ Object 



117
118
119
120
121
122
123
124
125
126
127
128
 
# File 'app/components/blacklight/document_component.rb', line 117

def before_render
  with_title unless title
  with_thumbnail unless thumbnail
  with_metadata(fields: presenter.field_presenters, show: @show) unless metadata
  with_embed unless embed

  view_partials.each do |view_partial|
    with_partial(view_partial) do
      helpers.render_document_partial document, view_partial, component: self, document_counter: counter
    end
  end
end

#classes ⇒ Object

HTML classes to apply to the root element



108
109
110
111
112
113
114
115
 
# File 'app/components/blacklight/document_component.rb', line 108

def classes
  [
    @classes,
    helpers.render_document_class(@document),
    'document',
    ("document-position-#{@counter}" if @counter)
  ].compact.flatten
end