Zabbix

<?php declare(strict_types = 0);

/*

** Copyright (C) 2001-2025 Zabbix SIA

**

** This program is free software: you can redistribute it and/or modify it under the terms of

** the GNU Affero General Public License as published by the Free Software Foundation, version 3.

**

** This program 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 Affero General Public License for more details.

**

** You should have received a copy of the GNU Affero General Public License along with this program.

** If not, see <https://www.gnu.org/licenses/>.

**/

​

​

class CSelect extends CTag {

​

    /**

     * @var string

     */

    protected $name;

​

    /**

     * @var CSelectOption[]|CSelectOptionGroup[]  List of options and option groups.

     */

    protected $options = [];

​

    /**

     * @param string $name  Input field name.

     */

    public function __construct(string $name = null) {

        parent::__construct('z-select', true);

​

        $this->name = $name;

    }

​

    /**

     * @param CSelectOption $option

     *

     * @return self

     */

    public function addOption(CSelectOption $option): self {

        $this->options[] = $option;

​

        return $this;

    }

​

    /**

     * @param CSelectOption[] $options

     *

     * @return self

     */

    public function addOptions(array $options): self {

        foreach ($options as $option) {

            $this->addOption($option);

        }

​

        return $this;

    }

​

    /**

     * @param CSelectOptionGroup $option_group

     *

     * @return self

     */

    public function addOptionGroup(CSelectOptionGroup $option_group): self {

        $this->options[] = $option_group;

​

        return $this;

    }

​

    /**

     * Selected option value. If no value is set, first available option will be preselected client at side.

     *

     * @param mixed $value

     *

     * @return self

     */

    public function setValue($value): self {

        $this->setAttribute('value', $value);

​

        return $this;

    }

​

    /**

     * Get ID for element that should be focused when focusing this component.

     *

     * @return string|null

     */

    public function getFocusableElementId(): ?string {