Class: Primer::Alpha::Dialog::Header

Inherits:
Component
  • Object
show all
Defined in:
app/components/primer/alpha/dialog/header.rb

Overview

A ‘Dialog::Header` is a compositional component, used to render the Header of a dialog. See <%= link_to_component(Primer::Alpha::Dialog) %>.

Constant Summary collapse

DEFAULT_VARIANT = 
:medium
VARIANT_MAPPINGS = 
{
  DEFAULT_VARIANT => "",
  :large => "Overlay-header--large"
}.freeze
VARIANT_OPTIONS = 
VARIANT_MAPPINGS.keys

Constants inherited from Component

Component::INVALID_ARIA_LABEL_TAGS

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

Constants included from Primer::AttributesHelper

Primer::AttributesHelper::PLURAL_ARIA_ATTRIBUTES, Primer::AttributesHelper::PLURAL_DATA_ATTRIBUTES

Instance Method Summary collapse

Methods inherited from Component

deprecated?, generate_id

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

Methods included from Primer::AttributesHelper

#aria, #data, #merge_aria, #merge_data, #merge_prefixed_attribute_hashes

Constructor Details

#initialize(id:, title:, subtitle: nil, show_divider: false, visually_hide_title: false, variant: DEFAULT_VARIANT, **system_arguments) ⇒ Header

Returns a new instance of Header.

Parameters:

  • id (String) —

    The HTML element’s ID value.

  • title (String) —

    Describes the content of the dialog.

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

    Provides additional context for the dialog, also setting the ‘aria-describedby` attribute.

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

    Show a divider between the header and body.

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

    Visually hide the ‘title` while maintaining a label for assistive technologies.

  • variant (Symbol) (defaults to: DEFAULT_VARIANT) —

    <%= one_of(Primer::Alpha::Dialog::Header::VARIANT_OPTIONS) %>

  • system_arguments (Hash) —

    <%= link_to_system_arguments_docs %>



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'app/components/primer/alpha/dialog/header.rb', line 26

def initialize(
  id:,
  title:,
  subtitle: nil,
  show_divider: false,
  visually_hide_title: false,
  variant: DEFAULT_VARIANT,
  **system_arguments
)
  @id = id
  @title = title
  @subtitle = subtitle
  @visually_hide_title = visually_hide_title
  @system_arguments = deny_tag_argument(**system_arguments)
  @system_arguments[:tag] = :div

  @system_arguments[:classes] = class_names(
    "Overlay-header",
    VARIANT_MAPPINGS[fetch_or_fallback(VARIANT_OPTIONS, variant, DEFAULT_VARIANT)],
    { "Overlay-header--divided": show_divider },
    system_arguments[:classes]
  )
end