Class: Daisy::Layout::JoinComponent

Inherits:
LocoMotion::BaseComponent show all
Defined in:
app/components/daisy/layout/join_component.rb

Overview

The JoinComponent combines multiple elements into a cohesive group without gaps between them. Common use cases include:

  • Button groups for toolbars.

  • Input fields with prefix/suffix elements.

  • Segmented navigation controls.

  • Pagination controls.

Note: Each joined item must include the ‘join-item` CSS class manually, as automatic application could cause rendering issues in complex scenarios.

Constant Summary

Constants inherited from LocoMotion::BaseComponent

LocoMotion::BaseComponent::EMPTY_PART_IGNORED_TAGS, LocoMotion::BaseComponent::SELF_CLOSING_TAGS

Instance Attribute Summary

Attributes inherited from LocoMotion::BaseComponent

#config, #loco_parent

Instance Method Summary collapse

Methods inherited from LocoMotion::BaseComponent

build, #component_ref, #config_option, #cssify, define_modifier, define_modifiers, define_part, define_parts, define_size, define_sizes, #empty_part_content, #inspect, #part, register_component_initializer, register_component_setup, #rendered_css, #rendered_data, #rendered_html, #rendered_stimulus_controllers, #rendered_tag_name, renders_many, renders_one, set_component_name, #set_loco_parent, #strip_spaces

Constructor Details

#initialize(**kws) ⇒ JoinComponent

Creates a new Join component.

Options Hash (**kws):

  • css (String) —

    Additional CSS classes for styling. Common options include:

    • Direction: ‘join-vertical` for vertical stacking

    • Size: ‘min-w-32`, `w-full`

    • Spacing: ‘gap-0`, `gap-px` (if gaps are needed)



65
66
67
 
# File 'app/components/daisy/layout/join_component.rb', line 65

def initialize(**kws)
  super
end

Instance Method Details

#before_render ⇒ Object

Sets up the component’s CSS classes.



72
73
74
 
# File 'app/components/daisy/layout/join_component.rb', line 72

def before_render
  add_css(:component, "join")
end

#call ⇒ Object

Renders all joined items in sequence.



79
80
81
82
83
84
85
 
# File 'app/components/daisy/layout/join_component.rb', line 79

def call
  part(:component) do
    items.each do |item|
      concat(item)
    end
  end
end