Class: Primer::Alpha::RadioButtonGroup

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

Overview

A group of mutually exclusive radio buttons.

Constant Summary

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 ⇒ Object

Parameters:

  • name (String) —

    Value for the HTML name attribute.

  • label (String) —

    Label text displayed above the input.

  • hidden (Boolean) —

    When set to ‘true`, visually hides the group.

  • caption (String) —

    A string describing the field and what sorts of input it expects. Displayed below the group.

  • invalid (Boolean) —

    If set to ‘true`, the input will be marked as invalid. Implied if `validation_message` is truthy. This option is set to `true` automatically if the model object associated with the form reports that the input is invalid via Rails validations. It is provided for cases where the form does not have an associated model. If the input is invalid as determined by Rails validations, setting `invalid` to `false` will have no effect.

  • validation_message (String) —

    A string displayed between the caption and the input indicating the input’s contents are invalid. This option is, by default, set to the first Rails validation message for the input (assuming the form is associated with a model object). Use ‘validation_message` to override the default or to provide a validation message in case there is no associated model object.

  • label_arguments (Hash) —

    Attributes that will be passed to Rails’ ‘builder.label` method. These can be HTML attributes or any of the other label options Rails supports. They will appear as HTML attributes on the `<label>` tag.




# File 'app/components/primer/alpha/radio_button_group.rb', line 20

Instance Method Details

#radio_button ⇒ Object

Adds a radio button to the group.

Parameters:

  • system_arguments (Hash) —

    The arguments accepted by <%= link_to_component(Primer::Alpha::RadioButton) %>.

  • block (Proc) —

    The block accepted by <%= link_to_component(Primer::Alpha::RadioButton) %>.




# File 'app/components/primer/alpha/radio_button_group.rb', line 30