Package org.vaadin.firitin.components.messagelist

Class MarkdownMessage

java.lang.Object
com.vaadin.flow.component.Component
org.vaadin.firitin.components.messagelist.MarkdownMessage
All Implemented Interfaces:
com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasStyle, Serializable
@Tag("vaadin-message") public class MarkdownMessage extends com.vaadin.flow.component.Component
A wrapper for vaadin-message web component, that supports Markdown formatting and appending content dynamically to the element. Typical usecase: LLM chatbots slowly giving you the answer.
See Also:

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static final record 
    MarkdownMessage.Color
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    MarkdownMessage(String name)
    Constructs a new MarkdownMessages, without initial content.
    MarkdownMessage(String markdown, String name)
    Constructs a new MarkdownMessages, with initial content.
    MarkdownMessage(String markdown, String name, LocalDateTime timestamp)
    Constructs a new MarkdownMessages, with initial content.
    MarkdownMessage(String markdown, String name, MarkdownMessage.Color avatarColor)
    Constructs a new MarkdownMessages, with initial content.
    MarkdownMessage(String name, LocalDateTime timestamp)
    Constructs a new MarkdownMessages, without initial content.
    MarkdownMessage(String name, LocalDateTime timestamp, MarkdownMessage.Color color)
    Constructs a new MarkdownMessages with all the bells and whistles, without initial content.
    MarkdownMessage(String name, MarkdownMessage.Color avatarColor)
    Constructs a new MarkdownMessages, without initial content.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    appendMarkdown(String markdownSnippet)
    Directly adds markdown formatted text to message part.
    protected void
    appendMarkdown(String markdownSnippet, boolean uiAccess)
     
    void
    appendMarkdownAsync(String markdownSnippet)
    Adds markdown formatted text to message part.
    void
    appendText(String text)
     
    protected void
    doAutoScroll()
     
    protected com.vladsch.flexmark.parser.Parser
    getMdParser()
     
    protected com.vladsch.flexmark.html.HtmlRenderer
    getMdRenderer()
     
    com.vaadin.flow.component.UI
    getUi()
     
    boolean
    isAutoScroll()
     
    protected void
    onAttach(com.vaadin.flow.component.AttachEvent attachEvent)
     
    void
    setAutoScroll(boolean autoScroll)
     
    void
    setAvatarColor(MarkdownMessage.Color color)
     
    void
    setUserColorIndex(int index)
     

    Methods inherited from class com.vaadin.flow.component.Component

    addListener, findAncestor, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getListeners, getLocale, getParent, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, onDetach, onEnabledStateChanged, removeFromParent, scrollIntoView, scrollIntoView, set, setElement, setId, setVisible

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface com.vaadin.flow.component.AttachNotifier

    addAttachListener

    Methods inherited from interface com.vaadin.flow.component.DetachNotifier

    addDetachListener

    Methods inherited from interface com.vaadin.flow.component.HasStyle

    addClassName, addClassNames, getClassName, getClassNames, getStyle, hasClassName, removeClassName, removeClassNames, setClassName, setClassName

  • Constructor Details

    • MarkdownMessage

      public MarkdownMessage(String name, LocalDateTime timestamp, MarkdownMessage.Color color)
      Constructs a new MarkdownMessages with all the bells and whistles, without initial content. Add that later with appendMarkdownAsync(String).
      Parameters:
      name - the name of the user
      timestamp - time of the message
      color - the color used for user avatar

    • MarkdownMessage

      public MarkdownMessage(String name)
      Constructs a new MarkdownMessages, without initial content. Add that later with appendMarkdownAsync(String).
      Parameters:
      name - the name of the user

    • MarkdownMessage

      public MarkdownMessage(String name, LocalDateTime timestamp)
      Constructs a new MarkdownMessages, without initial content. Add that later with appendMarkdownAsync(String).
      Parameters:
      name - the name of the user
      timestamp - the timestamp of the message

    • MarkdownMessage

      public MarkdownMessage(String name, MarkdownMessage.Color avatarColor)
      Constructs a new MarkdownMessages, without initial content. Add that later with appendMarkdownAsync(String).
      Parameters:
      name - the name of the user
      avatarColor - the avatar color

    • MarkdownMessage

      public MarkdownMessage(String markdown, String name, MarkdownMessage.Color avatarColor)
      Constructs a new MarkdownMessages, with initial content. You can add more text later with appendMarkdownAsync(String).
      Parameters:
      markdown - the initial content as markdown formatter text
      name - the name of the user
      avatarColor - the color of the avatar

    • MarkdownMessage

      public MarkdownMessage(String markdown, String name)
      Constructs a new MarkdownMessages, with initial content. You can add more text later with appendMarkdownAsync(String).
      Parameters:
      markdown - the initial content as markdown formatter text
      name - the name of the user

    • MarkdownMessage

      public MarkdownMessage(String markdown, String name, LocalDateTime timestamp)
      Constructs a new MarkdownMessages, with initial content. You can add more text later with appendMarkdownAsync(String).
      Parameters:
      markdown - the initial content as markdown formatted text
      name - the name of the user
      timestamp - the timestamp of the message

  • Method Details

    • setAvatarColor

      public void setAvatarColor(MarkdownMessage.Color color)

    • setUserColorIndex

      public void setUserColorIndex(int index)

    • getMdRenderer

      protected com.vladsch.flexmark.html.HtmlRenderer getMdRenderer()

    • getMdParser

      protected com.vladsch.flexmark.parser.Parser getMdParser()

    • onAttach

      protected void onAttach(com.vaadin.flow.component.AttachEvent attachEvent)
      Overrides:
      onAttach in class com.vaadin.flow.component.Component

    • getUi

      public com.vaadin.flow.component.UI getUi()

    • appendMarkdown

      public void appendMarkdown(String markdownSnippet)
      Directly adds markdown formatted text to message part. Note, that this method should not be called from any other but Vaadin UI thread. Consider using the appendMarkdownAsync(String) version in case the new text is coming from a background thread.
      Parameters:
      markdownSnippet - the new markdown formatted text snippet

    • appendMarkdownAsync

      public void appendMarkdownAsync(String markdownSnippet)
      Adds markdown formatted text to message part. This method takes care of synchronization with UI.access(Command), so it is safe to call this directly from a background thread.
      Parameters:
      markdownSnippet - the new markdown formatted text snippet

    • appendMarkdown

      protected void appendMarkdown(String markdownSnippet, boolean uiAccess)

    • isAutoScroll

      public boolean isAutoScroll()

    • setAutoScroll

      public void setAutoScroll(boolean autoScroll)

    • doAutoScroll

      protected void doAutoScroll()

    • appendText

      public void appendText(String text)