dropdown.hpp

Go to the documentation of this file.

/*
    Copyright 2019-2021 natinusala
    Copyright 2019 p-sam
    Copyright 2021 XITRIX
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
 
        http://www.apache.org/licenses/LICENSE-2.0
 
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
*/
 
#pragma once
 
#include <string>
#include <aurore/core/box.hpp>
#include <aurore/core/event.hpp>
#include <aurore/views/applet_frame.hpp>
#include <aurore/views/hint.hpp>
#include <aurore/views/recycler.hpp>
 
namespace aurore
{
 
// Fired when the user has selected a value
//
// Parameter is either the selected value index
// or -1 if the user cancelled
//
// Assume that the Dropdown is deleted
// as soon as this function is called
typedef Event<int> ValueSelectedEvent;
 
// Allows the user to select between multiple
// values
class Dropdown : public Box, private RecyclerDataSource
{
  private:
    AURORE_BIND(RecyclerFrame, recycler, "aurore/dropdown/recycler");
    AURORE_BIND(Box, header, "aurore/dropdown/header");
    AURORE_BIND(Label, title, "aurore/dropdown/title_label");
    AURORE_BIND(Box, content, "aurore/dropdown/content");
    AURORE_BIND(AppletFrame, applet, "aurore/dropdown/applet");
    ValueSelectedEvent::Callback cb;
    ValueSelectedEvent::Callback dismissCb;
    std::vector<std::string> values;
    int selected;
    Animatable showOffset = 0;
    Event<RecyclerCell*> cellFocusDidChangeEvent;
 
    int numberOfRows(RecyclerFrame* recycler, int section) override;
    RecyclerCell* cellForRow(RecyclerFrame* recycler, IndexPath index) override;
    void didSelectRowAt(RecyclerFrame* recycler, IndexPath index) override;
 
    void offsetTick();
 
  protected:
    float getShowAnimationDuration(TransitionAnimation animation) override;
 
    // Said with its title when it opens, before its row.
    AccessibilityRole getDefaultAccessibilityRole() override { return AccessibilityRole::LIST; }
    std::string getDefaultAccessibilityLabel() override { return this->title->getFullText(); }
 
  public:
    Dropdown(std::string title, std::vector<std::string> values, ValueSelectedEvent::Callback cb, int selected = 0, ValueSelectedEvent::Callback dismissCb = [](int) {});
 
    void show(std::function<void(void)> cb, bool animate, float animationDuration) override;
    void hide(std::function<void(void)> cb, bool animated, float animationDuration) override;
 
    virtual AppletFrame* getAppletFrame() override;
    virtual View* getParentNavigationDecision(View* from, View* newFocus, FocusDirection direction) override;
 
    Event<RecyclerCell*>* getCellFocusDidChangeEvent()
    {
        return &cellFocusDidChangeEvent;
    }
 
    bool isTranslucent() override
    {
        return true || View::isTranslucent();
    }
};
 
} // namespace aurore