Class: Brut::FrontEnd::Forms::RadioButtonGroupInput

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Defined in:
lib/brut/front_end/forms/radio_button_group_input.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(input_definition:, value:, index:) ⇒ RadioButtonGroupInput

Create the input with the given definition and value

Parameters:



15
16
17
18
19
20
21
22
23
 
# File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 15

def initialize(input_definition:, value:, index:)
  @input_definition = input_definition
  @validity_state = Brut::FrontEnd::Forms::ValidityState.new
  @index = index
  if input_definition.array?
    value ||= []
  end
  self.value=(value)
end

Instance Attribute Details

#typed_value ⇒ Date|Time|BigDecimal|String|true|false|nil (readonly)

The value of the input, as coerced to the type used to evaluate constraints. Returns ‘nil` if the value could not be coerced (which likely means there is or will be a constraint violation), or if it is a blank String.

Of note, ‘type=color` will return a String here, but that String should be parseable into a hex code, i.e. #XXXXXX, where each “X” is 0-9 or a-f. Further, `type=time` will also return a string in the format HH:MM or HH:MM:SS, where the time is in 24 hour time. Lastly, `type=datetime-local` will return a `Time`, even though the control allows the visitor to choose an invalid time. If there is no `valueMissing` constraint violation, but this attribute returns `nil`, #value will return the string sent by the browser, even if it’s not a real timestamp.

Returns:

  • (Date|Time|BigDecimal|String|true|false|nil) —

    the value of the input, as coerced to the type used to evaluate constraints. Returns ‘nil` if the value could not be coerced (which likely means there is or will be a constraint violation), or if it is a blank String.

    Of note, ‘type=color` will return a String here, but that String should be parseable into a hex code, i.e. #XXXXXX, where each “X” is 0-9 or a-f. Further, `type=time` will also return a string in the format HH:MM or HH:MM:SS, where the time is in 24 hour time. Lastly, `type=datetime-local` will return a `Time`, even though the control allows the visitor to choose an invalid time. If there is no `valueMissing` constraint violation, but this attribute returns `nil`, #value will return the string sent by the browser, even if it’s not a real timestamp.



9
10
11
 
# File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 9

def typed_value
  @typed_value
end

#validity_state ⇒ Brut::FrontEnd::Forms::ValidityState (readonly)

Returns Validity state that captures the current constraint violations, if any.

Returns:



12
13
14
 
# File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 12

def validity_state
  @validity_state
end

#value ⇒ String

Returns the input’s value. **DO NOTE** this returns a string. This is because HTML stores these values as Strings. When using a checkbox, in particular, the value will not be a boolean. You cannot do ‘if input.value` and expect that work. See #typed_value instead.

Returns:

  • (String) —

    the input’s value. **DO NOTE** this returns a string. This is because HTML stores these values as Strings. When using a checkbox, in particular, the value will not be a boolean. You cannot do ‘if input.value` and expect that work. See #typed_value instead.



6
7
8
 
# File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 6

def value
  @value
end

Instance Method Details

#server_side_constraint_violation(key, context = true) ⇒ Object

Set a server-side constraint violation on this input. This is essentially arbitrary, but note that ‘key` should not be a key used for client-side validations.

Parameters:

  • key (String|Symbol) —

    the I18n key fragment that describes the server side constraint violation

  • context (Hash|nil) (defaults to: true) —

    any interpolations required to render the message



48
49
50
 
# File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 48

def server_side_constraint_violation(key,context=true)
  @validity_state.server_side_constraint_violation(key: key, context: context)
end

#valid? ⇒ true|false

Returns true if the underlying #validity_state has no constraint violations.

Returns:

  • (true|false) —

    true if the underlying #validity_state has no constraint violations



53
 
# File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 53

def valid? = @validity_state.valid?