Class: PhlexKit::Progress

Inherits:
BaseComponent show all
Defined in:
app/components/phlex_kit/progress/progress.rb

Overview

Progress bar, ported from ruby_ui's RubyUI::Progress. value: (0–100, clamped) drives an inner indicator translated into view. Presentational, no JS; width comes from a caller class:/style:. Tailwind → vanilla .pk-progress* (progress.css).

Instance Method Summary collapse

Methods inherited from BaseComponent

#on

Constructor Details

#initialize(value: 0, value_text: nil, **attrs) ⇒ Progress

value_text: is a named kwarg (not read from **attrs) because mix would fuse a caller "aria-valuetext" with the generated default.



9
10
11
12
13
 
# File 'app/components/phlex_kit/progress/progress.rb', line 9

def initialize(value: 0, value_text: nil, **attrs)
  @value = value.to_f.clamp(0.0, 100.0)
  @value_text = value_text
  @attrs = attrs
end

Instance Method Details

#view_template ⇒ Object 



15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
 
# File 'app/components/phlex_kit/progress/progress.rb', line 15

def view_template
  # %g drops float artifacts ("40.0" would be announced as "forty point
  # zero percent"). The value travels as a custom property so the fill
  # transform lives in progress.css, where a :dir(rtl) arm can flip it —
  # an inline translateX always filled from the physical left.
  v = Kernel.format("%g", @value)
  div(**mix({
    role: "progressbar",
    "aria-valuenow": v,
    "aria-valuemin": 0,
    "aria-valuemax": 100,
    "aria-valuetext": @value_text || "#{v}%",
    class: "pk-progress",
    style: "--pk-progress-value: #{v};"
  }, @attrs)) do
    div(class: "pk-progress-indicator")
  end
end