Class: Primer::BorderBoxComponent

Inherits:
Component
  • Object
show all
Defined in:
app/components/primer/border_box_component.rb

Overview

BorderBox is a Box component with a border.

Constant Summary collapse

DEFAULT_PADDING = 
:default
PADDING_MAPPINGS = 
{
  DEFAULT_PADDING => "",
  :condensed => "Box--condensed",
  :spacious => "Box--spacious"
}.freeze

Constants included from Status::Dsl

Status::Dsl::STATUSES

Constants included from ViewHelper

ViewHelper::HELPERS

Constants included from TestSelectorHelper

TestSelectorHelper::TEST_SELECTOR_TAG

Constants included from FetchOrFallbackHelper

FetchOrFallbackHelper::InvalidValueError

Instance Method Summary collapse

Methods included from JoinStyleArgumentsHelper

#join_style_arguments

Methods included from TestSelectorHelper

#add_test_selector

Methods included from FetchOrFallbackHelper

#fetch_or_fallback, #fetch_or_fallback_boolean, #silence_deprecations?

Methods included from ClassNameHelper

#class_names

Constructor Details

#initialize(padding: DEFAULT_PADDING, **system_arguments) ⇒ BorderBoxComponent

Returns a new instance of BorderBoxComponent.

Examples:

Header, body, rows, and footer

<%= render(Primer::BorderBoxComponent.new) do |component| %>
  <% component.header do %>
    Header
  <% end %>
  <% component.body do %>
    Body
  <% end %>
  <% component.row do %>
    <% if true %>
      Row one
    <% end %>
  <% end %>
  <% component.row do %>
    Row two
  <% end %>
  <% component.footer do %>
    Footer
  <% end %>
<% end %>

Padding density

<%= render(Primer::BorderBoxComponent.new(padding: :condensed)) do |component| %>
  <% component.header do %>
    Header
  <% end %>
  <% component.body do %>
    Body
  <% end %>
  <% component.row do %>
    Row two
  <% end %>
  <% component.footer do %>
    Footer
  <% end %>
<% end %>

Parameters:

  • padding (Symbol) (defaults to: DEFAULT_PADDING) —

    <%= one_of(Primer::BorderBoxComponent::PADDING_MAPPINGS.keys) %>

  • system_arguments (Hash) —

    <%= link_to_system_arguments_docs %>



106
107
108
109
110
111
112
113
114
 
# File 'app/components/primer/border_box_component.rb', line 106

def initialize(padding: DEFAULT_PADDING, **system_arguments)
  @system_arguments = system_arguments
  @system_arguments[:tag] = :div
  @system_arguments[:classes] = class_names(
    "Box",
    PADDING_MAPPINGS[fetch_or_fallback(PADDING_MAPPINGS.keys, padding, DEFAULT_PADDING)],
    system_arguments[:classes]
  )
end

Instance Method Details

#render? ⇒ Boolean

Returns:

  • (Boolean) 


116
117
118
 
# File 'app/components/primer/border_box_component.rb', line 116

def render?
  rows.any? || header.present? || body.present? || footer.present?
end