Module: BetterUi::General::Components::Alert::AlertHelper

Included in:
ApplicationHelper
Defined in:
app/helpers/better_ui/general/components/alert/alert_helper.rb

Instance Method Summary collapse

Instance Method Details

#bui_alert(title: nil, message: nil, theme: :default, icon: nil, icon_position: :left, dismissible: false, rounded: :medium, importance: :medium, html_content: false, classes: nil, **options) ⇒ String

Renderizza un componente Alert per comunicare messaggi importanti all’utente.

Examples:

Alert base

<%= bui_alert(message: 'Operazione completata con successo') %>

Alert con titolo e tema

<%= bui_alert(title: 'Errore', message: 'Impossibile completare', theme: :red) %>

Alert con icona personalizzata

<%= bui_alert(message: 'Avviso importante', icon: 'bell') %>

Alert con pulsante per chiudere

<%= bui_alert(message: 'Notifica temporanea', dismissible: true) %>

Alert con HTML nel messaggio

<%= bui_alert(message: '<strong>Attenzione!</strong> Controlla i dati.', html_content: true) %>

Parameters:

  • title (String, nil) (defaults to: nil)

    Titolo dell’alert (opzionale)

  • message (String) (defaults to: nil)

    Contenuto dell’alert

  • theme (Symbol) (defaults to: :default)

    Tema dell’alert (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)

  • icon (String, nil) (defaults to: nil)

    Nome dell’icona (se vuoto usa l’icona predefinita in base al tema)

  • icon_position (Symbol) (defaults to: :left)

    Posizione dell’icona (:left, :right)

  • dismissible (Boolean) (defaults to: false)

    Se l’alert può essere chiuso dall’utente

  • rounded (Symbol) (defaults to: :medium)

    Arrotondamento degli angoli (:none, :small, :medium, :large, :full)

  • importance (Symbol) (defaults to: :medium)

    Livello di importanza per accessibilità (:high, :medium, :low)

  • html_content (Boolean) (defaults to: false)

    Se il messaggio contiene HTML

  • classes (String) (defaults to: nil)

    Classi CSS aggiuntive

  • options (Hash)

    Attributi HTML aggiuntivi

Returns:

  • (String)

    HTML del componente Alert renderizzato



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# File 'app/helpers/better_ui/general/components/alert/alert_helper.rb', line 36

def bui_alert(title: nil, message: nil, theme: :default, icon: nil, icon_position: :left, 
             dismissible: false, rounded: :medium, importance: :medium, html_content: false, 
             classes: nil, **options)
  render BetterUi::General::Alert::Component.new(
    title: title,
    message: message,
    theme: theme,
    icon: icon,
    icon_position: icon_position,
    dismissible: dismissible,
    rounded: rounded,
    importance: importance,
    html_content: html_content,
    classes: classes,
    **options
  )
end