Class: GovukPublishingComponents::ComponentDoc

Inherits:
Object
  • Object
show all
Defined in:
app/models/govuk_publishing_components/component_doc.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(component) ⇒ ComponentDoc

Returns a new instance of ComponentDoc.



12
13
14
15
16
17
18
19
20
21
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 12

def initialize(component)
  @component = component
  @id = component[:id]
  @name = component[:name]
  @description = component[:description]
  @body = component[:body]
  @accessibility_excluded_rules = component[:accessibility_excluded_rules]
  @source = component[:source]
  @embed = component[:embed]
end

Instance Attribute Details

#accessibility_excluded_rules ⇒ Object (readonly)

Returns the value of attribute accessibility_excluded_rules.



3
4
5
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 3

def accessibility_excluded_rules
  @accessibility_excluded_rules
end

#body ⇒ Object (readonly)

Returns the value of attribute body.



3
4
5
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 3

def body
  @body
end

#component ⇒ Object (readonly)

Returns the value of attribute component.



3
4
5
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 3

def component
  @component
end

#description ⇒ Object (readonly)

Returns the value of attribute description.



3
4
5
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 3

def description
  @description
end

#embed ⇒ Object (readonly)

Returns the value of attribute embed.



3
4
5
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 3

def embed
  @embed
end

#id ⇒ Object (readonly)

Returns the value of attribute id.



3
4
5
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 3

def id
  @id
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



3
4
5
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 3

def name
  @name
end

#source ⇒ Object (readonly)

Returns the value of attribute source.



3
4
5
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 3

def source
  @source
end

Instance Method Details

#accessibility_criteria ⇒ Object 



23
24
25
26
27
28
29
30
31
32
33
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 23

def accessibility_criteria
  shared_accessibility_criteria = []

  if component[:shared_accessibility_criteria].present?
    component[:shared_accessibility_criteria].each do |criteria|
      shared_accessibility_criteria << SharedAccessibilityCriteria.send(criteria) if SharedAccessibilityCriteria.respond_to? criteria
    end
  end

  "#{component[:accessibility_criteria]}\n#{shared_accessibility_criteria.join("\n")}"
end

#capture_full_width_screenshot? ⇒ Boolean

Returns:

  • (Boolean) 


60
61
62
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 60

def capture_full_width_screenshot?
  component[:capture_full_width_screenshot]
end

#component_wrapper_options ⇒ Object 



35
36
37
38
39
40
41
42
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 35

def component_wrapper_options
  if uses_component_wrapper_helper?
    {
      intro: ComponentWrapperHelperOptions.intro,
      description: ComponentWrapperHelperOptions.description,
    }
  end
end

#display_html? ⇒ Boolean

Returns:

  • (Boolean) 


52
53
54
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 52

def display_html?
  component[:display_html]
end

#display_preview? ⇒ Boolean

Returns:

  • (Boolean) 


56
57
58
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 56

def display_preview?
  component[:display_preview].nil? || component[:display_preview]
end

#example ⇒ Object 



44
45
46
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 44

def example
  examples.first
end

#examples ⇒ Object 



105
106
107
108
109
110
111
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 105

def examples
  @examples ||= component[:examples].map do |id, example_data|
    example_data ||= {}
    example_data["embed"] ||= embed
    ComponentExample.new(id.to_s, example_data)
  end
end

#get_govuk_container_class ⇒ Object 



68
69
70
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 68

def get_govuk_container_class
  capture_full_width_screenshot? ? "govuk-full-width-container" : "govuk-width-container"
end

#github_search_url ⇒ Object 



100
101
102
103
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 100

def github_search_url
  params = { q: "org:alphagov #{partial_path}", type: "Code" }
  "https://github.com/search?#{params.to_query}"
end

#govuk_frontend_components ⇒ Object 



96
97
98
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 96

def govuk_frontend_components
  component[:govuk_frontend_components].to_a
end

#html_accessibility_criteria ⇒ Object 



76
77
78
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 76

def html_accessibility_criteria
  markdown_to_html(accessibility_criteria) if accessibility_criteria.present?
end

#html_body ⇒ Object 



72
73
74
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 72

def html_body
  markdown_to_html(body) if body.present?
end

#html_component_wrapper_options_description ⇒ Object 



84
85
86
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 84

def html_component_wrapper_options_description
  markdown_to_html(component_wrapper_options[:description]) if component_wrapper_options.present?
end

#html_component_wrapper_options_intro ⇒ Object 



80
81
82
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 80

def html_component_wrapper_options_intro
  markdown_to_html(component_wrapper_options[:intro]) if component_wrapper_options.present?
end

#other_examples ⇒ Object 



48
49
50
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 48

def other_examples
  examples.slice(1..-1)
end

#partial_path ⇒ Object 



88
89
90
91
92
93
94
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 88

def partial_path
  if source == "gem"
    "govuk_publishing_components/components/#{id}"
  else
    "#{GovukPublishingComponents::Config.component_directory_name}/#{id}"
  end
end

#uses_component_wrapper_helper? ⇒ Boolean

Returns:

  • (Boolean) 


64
65
66
 
# File 'app/models/govuk_publishing_components/component_doc.rb', line 64

def uses_component_wrapper_helper?
  component[:uses_component_wrapper_helper]
end