Module: TailwindThemePicker::ViewHelper

Defined in:

app/helpers/tailwind_theme_picker/view_helper.rb

Constant Summary

DEFAULT_ICONS =

Emoji defaults so the gem has no icon-library dependency. Override by passing :icons to render_tailwind_theme_picker.

{
  palette: "🎨",
  times:   "❌",
  sun:     "☀️",
  moon:    "🌙"
}.freeze

Instance Method Summary

• #render_tailwind_theme_picker(themes: nil, default: nil, icons: {}) ⇒ Object
• #tailwind_theme_picker_cookies_present? ⇒ Boolean

  Whether the current request already has theme cookies set.

• #tailwind_theme_picker_fouc_script(force: false) ⇒ Object

  Inline

  # File 'app/helpers/tailwind_theme_picker/view_helper.rb', line 56
  
  def render_tailwind_theme_picker(themes: nil, default: nil, icons: {})
    config = TailwindThemePicker.configuration
    render(
      partial: "tailwind_theme_picker/picker",
      locals: {
        themes:        (themes  || config.themes).map(&:to_s),
        default:       (default || config.default).to_s,
        theme_cookie:  config.theme_cookie,
        mode_cookie:   config.mode_cookie,
        cookie_max_age: config.cookie_max_age,
        icons:         DEFAULT_ICONS.merge(icons)
      }
    )
  end
  

  #tailwind_theme_picker_cookies_present? ⇒ Boolean

  Whether the current request already has theme cookies set. Useful for skipping the FOUC fallback script.

  # File 'app/helpers/tailwind_theme_picker/view_helper.rb', line 28
  
  def tailwind_theme_picker_cookies_present?
    config = TailwindThemePicker.configuration
    cookies[config.theme_cookie].present? && cookies[config.mode_cookie].present?
  end
  

  #tailwind_theme_picker_fouc_script(force: false) ⇒ Object

  Inline

  Returns HTML attributes for the tag based on the request's cookies. Use like: html lang="en" *tailwind_theme_picker_html_attrs

  # File 'app/helpers/tailwind_theme_picker/view_helper.rb', line 16
  
  def tailwind_theme_picker_html_attrs
    config = TailwindThemePicker.configuration
    theme  = cookies[config.theme_cookie].presence
    theme  = config.default unless config.themes.include?(theme)
    mode   = cookies[config.mode_cookie] == "dark" ? "dark" : nil
  
    classes = ["theme-#{theme}", mode].compact.join(" ")
    { class: classes }
  end
  

  Generated on Sat Sep 19 16:13:06 2026 by yard 0.9.45 (ruby-4.0.7).