ListItem.h

Go to the documentation of this file.

//
// ListItem.h
//
 
#ifndef MALENA_LISTITEM_H
#define MALENA_LISTITEM_H
 
#pragma once
 
#include <Malena/Core/malena_export.h>
#include <Malena/Core/Component.h>
#include <Malena/Core/Core.h>
#include <Malena/Manifests/Manifest.h>
#include <Malena/Resources/FontManager.h>
#include <Malena/Traits/Settings/ListItemSettings.h>
#include <Malena/Traits/Theme/ListItemTheme.h>
#include <Malena/Traits/Theme/Themeable.h>
#include <SFML/Graphics/RectangleShape.hpp>
#include <SFML/Graphics/Text.hpp>
#include <SFML/Graphics/RenderTarget.hpp>
#include <functional>
#include <string>
#include <type_traits>
 
namespace ml
{
    // ── ListItemManifest ──────────────────────────────────────────────────────
 
    class MALENA_API ListItemManifest : public ml::Manifest
    {
    public:
        enum class Flag  { DISABLED };
        enum class State { IDLE, HOVERED, DISABLED };
    };
 
    // ── ListItem ──────────────────────────────────────────────────────────────

    class MALENA_API ListItem : public ComponentWith<ListItemManifest>,
                     public ListItemSettings,
                     public ListItemTheme,
                     public Themeable
    {
    public:
        using Flag  = ListItemManifest::Flag;
        using State = ListItemManifest::State;
 
    private:
        // ── Slots — external references, never owned ──────────────────────────
        ml::Core* _start   = nullptr;
        ml::Core* _content = nullptr;   
        ml::Core* _end     = nullptr;
 
        // ── Built-in content ──────────────────────────────────────────────────
        sf::Text  _label;
        sf::Text  _description;
        bool      _hasDescription = false;
        bool      _hasCustomContent = false;
 
        // ── Layout ────────────────────────────────────────────────────────────
        sf::RectangleShape _background;
        sf::Vector2f       _position  = {0.f, 0.f};
        float              _width     = 300.f;
 
        // ── Callbacks ─────────────────────────────────────────────────────────
        std::function<void()> _onClickCb;
 
        // ── Internal ──────────────────────────────────────────────────────────
        void layout();
        void applyVisualState();
        float contentHeight() const;
 
    protected:
        void draw(sf::RenderTarget& target, sf::RenderStates states) const override;
        void onThemeApplied(const Theme& theme) override;
 
    public:
        explicit ListItem(const sf::Font& font = FontManager<>::getDefault());
 
        // ── Apply ─────────────────────────────────────────────────────────────
 
        template<typename S>
        void applySettings(const S& s)
        {
            static_assert(std::is_base_of_v<ListItemSettings, S>,
                "applySettings() requires a type derived from ListItemSettings");
            static_cast<ListItemSettings&>(*this) = s;
            layout();
        }
 
        template<typename T>
        void applyTheme(const T& t)
        {
            static_assert(std::is_base_of_v<ListItemTheme, T>,
                "applyTheme() requires a type derived from ListItemTheme");
            static_cast<ListItemTheme&>(*this) = t;
            applyVisualState();
            layout();
        }
 
        template<typename St>
        void applyStyle(const St& s)
        {
            static_assert(std::is_base_of_v<ListItemSettings, St> &&
                          std::is_base_of_v<ListItemTheme, St>,
                "applyStyle() requires ListItemSettings and ListItemTheme");
            static_cast<ListItemSettings&>(*this) = s;
            static_cast<ListItemTheme&>(*this)    = s;
            applyVisualState();
            layout();
        }
 
        // ── Slots ─────────────────────────────────────────────────────────────

        void setStart(ml::Core& component);

        void setEnd(ml::Core& component);

        void setContent(ml::Core& component);
 
        // ── Built-in content ──────────────────────────────────────────────────

        void setLabel(const std::string& text);
        [[nodiscard]] std::string getLabel() const;

        void setDescription(const std::string& text);
        [[nodiscard]] std::string getDescription() const;
 
        // ── Click callback ────────────────────────────────────────────────────

        void onClick(std::function<void()> callback);
 
        // ── State ─────────────────────────────────────────────────────────────
 
        void setEnabled(bool enabled);
        [[nodiscard]] bool isEnabled() const;
 
        // ── Width ─────────────────────────────────────────────────────────────

        void setWidth(float width);
        [[nodiscard]] float getWidth() const { return _width; }
 
        // ── Positionable ──────────────────────────────────────────────────────
 
        void          setPosition(const sf::Vector2f& position) override;
        sf::Vector2f  getPosition()     const override;
        sf::FloatRect getGlobalBounds() const override;
    };
 
    // ── ListItemWith ──────────────────────────────────────────────────────────
 
    template<typename MANIFEST>
    class ListItemWith : public ListItem, public Customizable<MANIFEST>
    { public: using ListItem::ListItem; };
 
} // namespace ml
 
#endif // MALENA_LISTITEM_H