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/>.

**/

​

​

use Zabbix\Widgets\CWidgetField;

​

abstract class CWidgetFieldView {

​

    protected CWidgetField $field;

​

    protected string $form_name = '';

​

    protected array $label_class_list = [];

    protected array $field_class_list = [];

​

    protected bool $has_label = true;

​

    protected ?CTag $field_hint = null;

​

    public function setFormName($form_name): self {

        $this->form_name = $form_name;

​

        return $this;

    }

​

    public function getFocusableElementId(): string {

        return zbx_formatDomId($this->field->getName());

    }

​

    public function getLabel(): ?CLabel {

        if (!$this->has_label) {

            return null;

        }

​

        $label = $this->field->getLabel();

​

        if ($label === null) {

            return null;

        }

​

        return (new CLabel([$label, $this->field_hint]))

            ->setFor($this->getFocusableElementId())

            ->setAsteriskMark($this->isRequired())

            ->addClass($this->label_class_list ? implode(' ', $this->label_class_list) : null);

    }

​

    public function removeLabel(): self {

        $this->has_label = false;

​

        return $this;

    }