Class: Polaris::HeadlessButton

Inherits:
Component
  • Object
show all
Defined in:
app/components/polaris/headless_button.rb

Direct Known Subclasses

ButtonComponent

Constant Summary collapse

SIZE_DEFAULT = 
:medium
SIZE_MAPPINGS = 
{
  SIZE_DEFAULT => "",
  :slim => "Polaris-Button--sizeSlim",
  :large => "Polaris-Button--sizeLarge"
}
SIZE_OPTIONS = 
SIZE_MAPPINGS.keys
TEXT_ALIGN_DEFAULT = 
:default
TEXT_ALIGN_MAPPINGS = 
{
  TEXT_ALIGN_DEFAULT => "",
  :left => "Polaris-Button--textAlignLeft",
  :center => "Polaris-Button--textAlignCenter",
  :right => "Polaris-Button--textAlignRight"
}
TEXT_ALIGN_OPTIONS = 
TEXT_ALIGN_MAPPINGS.keys
DISCLOSURE_DEFAULT = 
false
DISCLOSURE_OPTIONS = 
[true, false, :down, :up, :select, :horizontal_dots]

Constants included from ViewHelper

ViewHelper::POLARIS_HELPERS, ViewHelper::POLARIS_TEXT_STYLES

Constants included from FetchOrFallbackHelper

FetchOrFallbackHelper::InvalidValueError

Instance Method Summary collapse

Methods included from ViewHelper

#polaris_body_styles, #polaris_html_classes, #polaris_html_styles, #polaris_icon_source

Methods included from StylesListHelper

#styles_list

Methods included from OptionHelper

#append_option, #prepend_option

Methods included from FetchOrFallbackHelper

#fetch_or_fallback, #fetch_or_fallback_boolean, #fetch_or_fallback_nested

Methods included from ClassNameHelper

#class_names

Constructor Details

#initialize(url: nil, outline: false, plain: false, primary: false, pressed: false, monochrome: false, loading: false, destructive: false, disabled: false, disable_with_loader: false, disclosure: DISCLOSURE_DEFAULT, external: false, full_width: false, submit: false, remove_underline: false, size: SIZE_DEFAULT, text_align: TEXT_ALIGN_DEFAULT, icon_name: nil, **system_arguments) ⇒ HeadlessButton 



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'app/components/polaris/headless_button.rb', line 27

def initialize(
  url: nil,
  outline: false,
  plain: false,
  primary: false,
  pressed: false,
  monochrome: false,
  loading: false,
  destructive: false,
  disabled: false,
  disable_with_loader: false,
  disclosure: DISCLOSURE_DEFAULT,
  external: false,
  full_width: false,
  submit: false,
  remove_underline: false,
  size: SIZE_DEFAULT,
  text_align: TEXT_ALIGN_DEFAULT,
  icon_name: nil,
  **system_arguments
)
  @tag = url.present? ? "a" : "button"
  @text_classes = class_names(
    "Polaris-Button__Text",
    "Polaris-Button--removeUnderline": plain && monochrome && remove_underline
  )
  @loading = loading
  @disclosure = fetch_or_fallback(DISCLOSURE_OPTIONS, disclosure, DISCLOSURE_DEFAULT)
  @disclosure = :down if @disclosure === true
  @icon_name = icon_name

  @system_arguments = system_arguments
  @system_arguments[:type] = submit ? "submit" : "button"
  if loading
    @system_arguments[:disabled] = true
  end
  if url.present?
    @system_arguments.delete(:type)
    @system_arguments[:href] = url
    @system_arguments[:target] = "_blank" if external
  end
  if disabled
    @system_arguments[:disabled] = disabled
  end
  @system_arguments[:data] ||= {}
  prepend_option(@system_arguments[:data], :controller, "polaris-button")
  if disable_with_loader
    prepend_option(@system_arguments[:data], :action, "polaris-button#disable")
  end
  @system_arguments[:classes] = class_names(
    @system_arguments[:classes],
    "Polaris-Button",
    SIZE_MAPPINGS[fetch_or_fallback(SIZE_OPTIONS, size, SIZE_DEFAULT)],
    TEXT_ALIGN_MAPPINGS[fetch_or_fallback(TEXT_ALIGN_OPTIONS, text_align, TEXT_ALIGN_DEFAULT)],
    "Polaris-Button--destructive": destructive,
    "Polaris-Button--disabled": disabled || loading,
    "Polaris-Button--loading": loading,
    "Polaris-Button--fullWidth": full_width,
    "Polaris-Button--monochrome": monochrome,
    # "Polaris-Button--outline": outline,
    "Polaris-Button--plain": plain,
    "Polaris-Button--primary": primary,
    "Polaris-Button--pressed": pressed,
    "Polaris-Button--removeUnderline": plain && monochrome && remove_underline
  )
end

Instance Method Details

#html_options ⇒ Object 



102
103
104
105
106
107
 
# File 'app/components/polaris/headless_button.rb', line 102

def html_options
  options = system_arguments
  options[:class] = options[:classes]
  options.delete(:classes)
  options
end

#system_arguments ⇒ Object 



94
95
96
97
98
99
100
 
# File 'app/components/polaris/headless_button.rb', line 94

def system_arguments
  @system_arguments[:classes] = class_names(
    @system_arguments[:classes],
    "Polaris-Button--iconOnly": (icon.present? || @icon_name.present?) && content.blank?
  )
  @system_arguments
end