Alfabetiza/pandora/game_objects/ui_objects/Radio.js

/************************************************************************
 * Radio.js
 ************************************************************************
 * Copyright (c) 2021 Pedro Tonini Rosenberg Schneider.
 *
 * This file is part of Pandora.
 *
 * Pandora is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Pandora is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *     
 * You should have received a copy of the GNU General Public License     
 * along with Pandora.  If not, see <https://www.gnu.org/licenses/>.
 *************************************************************************/

/**
 * The {@code Radio} class represents an UIObject that holds and HTML radio button.
 * 
 * ! All GameObjects need to be inside the tree to do anything (can be added as a child
 * ! of another GameObject on the tree or as a root).
 * 
 * @author Pedro Schneider
 * 
 * @class
 */
class Radio extends UIObject
{
    /**
     * Initializes an empty Radio.
     * 
     * @param {String} name name for the Radio GameObject. 
     * 
     * @constructor
     */
    constructor(name)
    {
        super(name);

        this.P5Element = createRadio(); // This Radio's HTML radio.
        this.setPosition(10, 10); // Set this position of the Radio on the secondary buffer.
        this.multiLine = false; // Should the different radio buttons be shown on separate lines?

        this.setStyle(STYLE.DEFAULT_STYLE); // Set the default style of the UIObject.

        this.connectCallbacks(); // Connect events of the p5.Element.
        this.P5Element.changed(this.onChanged); // Connect the extra event radios have.
    }

    /**
     * Sets the selected option on this Radio's HTML radio button based on its value.
     * 
     * @param {String} value    value of the radio button to be selected.
     */
    setSelected(value)
    {
        this.P5Element.selected(value);
    }

    /**
     * Returns the value of the selected option from this Radio's HTML radio button.
     * 
     * @returns {String}    the value of the selected option.
     */
    getSelected()
    {
        return this.P5Element.selected();
    }

    /**
     * Inserts a new option on this Radio's HTML radio button with the given value.
     * 
     * @param {String} value    value for the new option.
     */
    addOption(value)
    {
        this.P5Element.option(value);

        if (this.multiLine) this.makeMultiline();
    }


    // TODO make this work question mark?
    // removeOption(value)
    // {
    //     this.P5Element.remove(value);
    // }

    /**
     * This fucntion creates separete HTML divs for each option on this Radio's HTML radio button ]
     * in order to make them appear on different lines.
     */
    makeMultiline()
    {
        this.multiLine = true;
        const inputs = selectAll('input', this.P5Element),
            labels = selectAll('label', this.P5Element),
            len = inputs.length;

        for (let i = 0; i < len; ++i)
            createDiv().parent(this.P5Element).child(inputs[i]).child(labels[i]);

        this.fixRadioDivElement();
    }

    /**
     * Fixes de div elements after the call to makeMultiLine().
     */
    fixRadioDivElement()
    {
        this.P5Element._getInputChildrenArray = function()
        {
            return this.elt.getElementsByTagName('input');
        }
    }

    /**
     * Defines default signals for UIObjects and serves as the caller to this UIObject's
     * _initSignals() callbacks. Also adds the extra onChaged signal for CheckBoxes.
     * 
     * @signal mousePressed     emited once every time a mouse button is pressed over this
     *                          UIObject.
     * @signal doubleClicked    emited once every time a mouse button is pressed twice over
     *                          this UIObject.
     * @signal mouseWheel       emited once everty time a mouse wheel is scrolled over this
     *                          UIObject. Passes one argument {event} that holds the deltaY
     *                          property, that holds a number based on how much was vertically
     *                          scrolled (up is positive) and the deltaX property, that holds a
     *                          number based on how much was horizontaly scrolled (right is positive).
     * @signal mouseReleased    emited once every time a mouse button is released over this
     *                          UIObject.
     * @signal mouseClicked     emited once every time a mouse button is pressed and released
     *                          over this UIObject.
     * @signal mouseMoved       emited once every time a mouse moves over this UIObject.
     * @signal mouseOver        emited once every time a mouse moves onto this UIObject.
     * @signal mouseOut         emited once every time a mouse moves out of this UIObject.
     * @signal touchStarted     emited once every time a touch is regiestered over this UIObject.
     * @signal touchMoved       emited once every time a touch move is regiestered over this
     *                          UIObject.
     * @signal touchEnded       emited once every time a touch is regiestered over this UIObject.
     * @signal dragOver         emited once every time a file is dragged over this UIObject.
     * @signal dragLeave        emited once every time a dragged file leaves this UIObject's area.
     * 
     * @signal changed          emited once every time this UIObject's radio button's value is changed.
     * 
     * @override
     */
    initSignals()
    {
        this.addSignal("mousePressed");
        this.addSignal("doubleClicked");
        this.addSignal("mouseWheel");
        this.addSignal("mouseReleased");
        this.addSignal("mouseClicked");
        this.addSignal("mouseMoved");
        this.addSignal("mouseOver");
        this.addSignal("mouseOut");
        this.addSignal("touchStarted");
        this.addSignal("touchMoved");
        this.addSignal("touchEnded");
        this.addSignal("dragOver");
        this.addSignal("dragLeave");

        this.emitSignal("changed");
        this._initSignals();
    }

    /**
     * Called once every time this UIObject's radio buttons's value is changed.
     * Connected to the changed event from this UIObject's p5.Element.
     * Serves as an emiter to the changed signal and calls the _onChanged()
     * callback.
     */
    onChanged()
    {
        this.pandoraObject.emitSignal("changed");
        this.pandoraObject._onChanged();
    }

    /**
     * ! This function should be overriden, it provides no default functionality.
     * Called once every time this UIObject's radio button's value is changed.
     * 
     * @callback
     */
    _onChanged()
    {
        console.log(this.getSelected());
    }
}