Flarum (2.x)
    Preparing search index...

    Class WelcomeHero<CustomAttrs>

    The WelcomeHero component displays a hero that welcomes the user to the forum.

    Type Parameters

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    attrs element state

    Methods

    $ bodyItems className contentItems hide isHidden onbeforeremove onbeforeupdate oncreate oninit onremove onupdate style view viewItems component initAttrs

    Constructors

    Properties

    attrs: CustomAttrs

    The attributes passed into the component.

    https://mithril.js.org/components.html#passing-data-to-components

    element: Element

    The root DOM element for the component.

    state: undefined

    Class component state that is persisted between redraws.

    Updating this will not automatically trigger a redraw, unlike other frameworks.

    This is different to Vnode state, which is always an instance of your class component.

    This is undefined by default.

    Methods

    $

    • $(selector?: string): JQuery

      Returns a jQuery object for this component's element. If you pass in a selector string, this method will return a jQuery object, using the current element as its buffer.

      For example, calling component.$('li') will return a jQuery object containing all of the li elements inside the DOM element of this component.

      Parameters

      • Optionalselector: string

        a jQuery-compatible selector string

      Returns JQuery

      the jQuery object for the DOM node

    • Defines the child elements that will be rendered within the main container of the hero. Subclasses MUST implement this method to define the specific content of the hero.

      Returns ItemList<Children>

      bodyItems(): ItemList<Mithril.Children> {
        const items = new ItemList<Mithril.Children>();
        items.add('title', <h1>Welcome!</h1>);
        return items;
      }

    • Defines inline CSS styles for the hero component's root element. Subclasses can override this method to provide custom styles.

      Returns Record<string, string> | undefined

      style(): Record<string, string> {
        return {
          backgroundColor: '#e7672e',
        };
      }

    • Builds the list of items to be rendered within the hero's main container. By default, this method wraps the output of bodyItems() in a div with the class "container". Subclasses can override this method to customize the structure of the hero's content.

      Returns ItemList<Children>

      viewItems(): ItemList<Mithril.Children> {
         const items = super.viewItems();

         items.add('custom', <div className="containerNarrow">custom element</div>);

         return items;

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods