Input::setPlaceholder() - Code Metrics - Inspection of "Bump actions/cache from 2 to 2.1.5" - yiisoft/form - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — dependabot/github_actions/acti... ( 6c9f07 )

unknown

created 2021-05-12 05:25 UTC

Input::setPlaceholder() A

↳ Parent: Input

Complexity

Conditions	3
Paths	2

Size

Total Lines	5
Code Lines	3

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	4
CRAP Score	3

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	3
eloc	3
c	1
b	0
f	0
nc	2
nop	0
dl	0
loc	5
ccs	4
cts	4
cp	1
crap	3
rs	10

<?php

declare(strict_types=1);

namespace Yiisoft\Form\Widget;

use Yiisoft\Arrays\ArrayHelper;
use Yiisoft\Form\FormModelInterface;
use Yiisoft\Form\Helper\HtmlForm;
use Yiisoft\Form\HtmlOptions\HtmlOptionsProvider;
use Yiisoft\Html\Html;
use Yiisoft\Widget\Widget;
use function in_array;

final class Input extends Widget
{
    private ?string $id = null;
    private FormModelInterface $data;
    private string $attribute;
    private array $options = [];
    private string $charset = 'UTF-8';
    private bool $noPlaceholder = false;
    private string $type;

    /**
     * Generates an input tag for the given form attribute.
     *
     * @return string the generated input tag.
     */
    public function run(): string
    {
        $new = clone $this;

        if ($new->noPlaceholder === false) {
            $new->setPlaceholder();
        }

        if (!empty($new->getId())) {
            $new->options['id'] = $new->getId();
        }

        return Html::input($new->type, $new->getName(), $new->getValue())
            ->attributes($new->options)
            ->render();
    }

    /**
     * Set form model, name and options for the widget.
     *
     * @param FormModelInterface $data Form model.
     * @param string $attribute Form model property this widget is rendered for.
     * @param array $options The HTML attributes for the widget container tag.
     * See {@see \Yiisoft\Html\Html::renderTagAttributes()} for details on how attributes are being rendered.
     *
     * @return self
     */
    public function config(FormModelInterface $data, string $attribute, array $options = []): self
    {
        $new = clone $this;
        $new->data = $data;
        $new->attribute = $attribute;
        $rules = $data->getRules()[$attribute] ?? [];
        foreach ($rules as $rule) {
            if ($rule instanceof HtmlOptionsProvider) {
                $new->options = array_merge($new->options, $rule->getHtmlOptions());
            }
        }
        $new->options = array_merge($new->options, $options);
        return $new;
    }

    /**
     * Focus on the control (put cursor into it) when the page loads.
     * Only one form element could be in focus at the same time.
     *
     * It cannot be applied if the type attribute has a hidden value (that is, you cannot automatically set the cursor
     * to a hidden control).
     *
     * @param bool $value
     *
     * @return self
     */
    public function autofocus(bool $value = true): self
    {
        $new = clone $this;
        $new->options['autofocus'] = $value;
        return $new;
    }

    /**
     * Set the character set used to generate the widget id. See {@see HtmlForm::getInputId()}.
     *
     * @param string $value
     *
     * @return self
     */
    public function charset(string $value): self
    {
        $new = clone $this;
        $new->charset = $value;
        return $new;
    }

    /**
     * Set whether the element is disabled or not.
     *
     * If this attribute is set to `true`, the element is disabled. Disabled elements are usually drawn with grayed-out
     * text.
     * If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event
     * will not fire. In the case of form elements, it will not be submitted. Do not set the attribute to true, as
     * this will suggest you can set it to false to enable the element again, which is not the case.
     *
     * @param bool $value
     *
     * @return self
     */
    public function disabled(bool $value = true): self
    {
        $new = clone $this;
        $new->options['disabled'] = $value;
        return $new;
    }

    /**
     * Specifies the form element the tag input element belongs to. The value of this attribute must be the id
     * attribute of a {@see Form} element in the same document.
     *
     * @param string $value
     *
     * @return self
     */
    public function form(string $value): self
    {
        $new = clone $this;
        $new->options['form'] = $value;
        return $new;
    }

    /**
     * Allows you to disable placeholder.
     *
     * @param bool $value
     *
     * @return self
     */
    public function noPlaceholder(bool $value = true): self
    {
        $new = clone $this;
        $new->noPlaceholder = $value;
        return $new;
    }

    /**
     * It allows defining placeholder.
     *
     * @param string $value
     *
     * @return self
     */
    public function placeholder(string $value): self
    {
        $new = clone $this;
        $new->options['placeholder'] = $value;
        return $new;
    }

    /**
     * If it is required to fill in a value in order to submit the form.
     *
     * @param bool $value
     *
     * @return self
     */
    public function required(bool $value = true): self
    {
        $new = clone $this;
        $new->options['required'] = $value;
        return $new;
    }

    /**
     * The tabindex global attribute indicates that its element can be focused, and where it participates in sequential
     * keyboard navigation (usually with the Tab key, hence the name).
     *
     * It accepts an integer as a value, with different results depending on the integer's value:
     *
     * - A negative value (usually tabindex="-1") means that the element is not reachable via sequential keyboard
     * navigation, but could be focused with Javascript or visually. It's mostly useful to create accessible widgets
     * with JavaScript.
     * - tabindex="0" means that the element should be focusable in sequential keyboard navigation, but its order is
     * defined by the document's source order.
     * - A positive value means the element should be focusable in sequential keyboard navigation, with its order
     * defined by the value of the number. That is, tabindex="4" is focused before tabindex="5", but after tabindex="3".
     *
     * @param int $value
     *
     * @return self
     */
    public function tabIndex(int $value = 0): self
    {
        $new = clone $this;
        $new->options['tabindex'] = $value;
        return $new;
    }

    /**
     * Type of the input control to use.
     *
     * @param string $value
     *
     * @return self
     */
    public function type(string $value): self
    {
        $new = clone $this;
        $new->type = $value;
        return $new;
    }

    private function getId(): string
    {
        $id = $this->options['id'] ?? $this->id;

        if ($id === null) {
            $id = HtmlForm::getInputId($this->data, $this->attribute, $this->charset);
        }

        return $id !== false ? (string) $id : '';
    }

    private function getName(): string
    {
        return ArrayHelper::remove($this->options, 'name', HtmlForm::getInputName($this->data, $this->attribute));
    }

    private function getValue()
    {
        $value = HtmlForm::getAttributeValue($this->data, $this->attribute);
        if ($value !== null && is_scalar($value)) {
            $value = (string)$value;
        }

        return ArrayHelper::remove(
            $this->options,
            'value',
            $value
        );
    }

    private function setPlaceholder(): void
    {
        if (!isset($this->options['placeholder']) && !(in_array($this->type, ['date', 'file', 'hidden', 'color'], true))) {
            $attributeName = HtmlForm::getAttributeName($this->attribute);
            $this->options['placeholder'] = $this->data->getAttributeLabel($attributeName);
        }
    }
}


1		<?php
2
3		declare(strict_types=1);
4
5		namespace Yiisoft\Form\Widget;
6
7		use Yiisoft\Arrays\ArrayHelper;
8		use Yiisoft\Form\FormModelInterface;
9		use Yiisoft\Form\Helper\HtmlForm;
10		use Yiisoft\Form\HtmlOptions\HtmlOptionsProvider;
11		use Yiisoft\Html\Html;
12		use Yiisoft\Widget\Widget;
13		use function in_array;
14
15		final class Input extends Widget
16		{
17		private ?string $id = null;
18		private FormModelInterface $data;
19		private string $attribute;
20		private array $options = [];
21		private string $charset = 'UTF-8';
22		private bool $noPlaceholder = false;
23		private string $type;
24
25		/**
26		* Generates an input tag for the given form attribute.
27		*
28		* @return string the generated input tag.
29		*/
30	98	public function run(): string
31		{
32	98	$new = clone $this;
33
34	98	if ($new->noPlaceholder === false) {
35	95	$new->setPlaceholder();
36		}
37
38	98	if (!empty($new->getId())) {
39	98	$new->options['id'] = $new->getId();
40		}
41
42	98	return Html::input($new->type, $new->getName(), $new->getValue())
43	97	->attributes($new->options)
44	97	->render();
45		}
46
47		/**
48		* Set form model, name and options for the widget.
49		*
50		* @param FormModelInterface $data Form model.
51		* @param string $attribute Form model property this widget is rendered for.
52		* @param array $options The HTML attributes for the widget container tag.
53		* See {@see \Yiisoft\Html\Html::renderTagAttributes()} for details on how attributes are being rendered.
54		*
55		* @return self
56		*/
57	98	public function config(FormModelInterface $data, string $attribute, array $options = []): self
58		{
59	98	$new = clone $this;
60	98	$new->data = $data;
61	98	$new->attribute = $attribute;
62	98	$rules = $data->getRules()[$attribute] ?? [];
63	98	foreach ($rules as $rule) {
64	73	if ($rule instanceof HtmlOptionsProvider) {
65	23	$new->options = array_merge($new->options, $rule->getHtmlOptions());
66		}
67		}
68	98	$new->options = array_merge($new->options, $options);
69	98	return $new;
70		}
71
72		/**
73		* Focus on the control (put cursor into it) when the page loads.
74		* Only one form element could be in focus at the same time.
75		*
76		* It cannot be applied if the type attribute has a hidden value (that is, you cannot automatically set the cursor
77		* to a hidden control).
78		*
79		* @param bool $value
80		*
81		* @return self
82		*/
83	1	public function autofocus(bool $value = true): self
84		{
85	1	$new = clone $this;
86	1	$new->options['autofocus'] = $value;
87	1	return $new;
88		}
89
90		/**
91		* Set the character set used to generate the widget id. See {@see HtmlForm::getInputId()}.
92		*
93		* @param string $value
94		*
95		* @return self
96		*/
97		public function charset(string $value): self
98		{
99		$new = clone $this;
100		$new->charset = $value;
101		return $new;
102		}
103
104		/**
105		* Set whether the element is disabled or not.
106		*
107		* If this attribute is set to `true`, the element is disabled. Disabled elements are usually drawn with grayed-out
108		* text.
109		* If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event
110		* will not fire. In the case of form elements, it will not be submitted. Do not set the attribute to true, as
111		* this will suggest you can set it to false to enable the element again, which is not the case.
112		*
113		* @param bool $value
114		*
115		* @return self
116		*/
117	1	public function disabled(bool $value = true): self
118		{
119	1	$new = clone $this;
120	1	$new->options['disabled'] = $value;
121	1	return $new;
122		}
123
124		/**
125		* Specifies the form element the tag input element belongs to. The value of this attribute must be the id
126		* attribute of a {@see Form} element in the same document.
127		*
128		* @param string $value
129		*
130		* @return self
131		*/
132	1	public function form(string $value): self
133		{
134	1	$new = clone $this;
135	1	$new->options['form'] = $value;
136	1	return $new;
137		}
138
139		/**
140		* Allows you to disable placeholder.
141		*
142		* @param bool $value
143		*
144		* @return self
145		*/
146	61	public function noPlaceholder(bool $value = true): self
147		{
148	61	$new = clone $this;
149	61	$new->noPlaceholder = $value;
150	61	return $new;
151		}
152
153		/**
154		* It allows defining placeholder.
155		*
156		* @param string $value
157		*
158		* @return self
159		*/
160	1	public function placeholder(string $value): self
161		{
162	1	$new = clone $this;
163	1	$new->options['placeholder'] = $value;
164	1	return $new;
165		}
166
167		/**
168		* If it is required to fill in a value in order to submit the form.
169		*
170		* @param bool $value
171		*
172		* @return self
173		*/
174	1	public function required(bool $value = true): self
175		{
176	1	$new = clone $this;
177	1	$new->options['required'] = $value;
178	1	return $new;
179		}
180
181		/**
182		* The tabindex global attribute indicates that its element can be focused, and where it participates in sequential
183		* keyboard navigation (usually with the Tab key, hence the name).
184		*
185		* It accepts an integer as a value, with different results depending on the integer's value:
186		*
187		* - A negative value (usually tabindex="-1") means that the element is not reachable via sequential keyboard
188		* navigation, but could be focused with Javascript or visually. It's mostly useful to create accessible widgets
189		* with JavaScript.
190		* - tabindex="0" means that the element should be focusable in sequential keyboard navigation, but its order is
191		* defined by the document's source order.
192		* - A positive value means the element should be focusable in sequential keyboard navigation, with its order
193		* defined by the value of the number. That is, tabindex="4" is focused before tabindex="5", but after tabindex="3".
194		*
195		* @param int $value
196		*
197		* @return self
198		*/
199	1	public function tabIndex(int $value = 0): self
200		{
201	1	$new = clone $this;
202	1	$new->options['tabindex'] = $value;
203	1	return $new;
204		}
205
206		/**
207		* Type of the input control to use.
208		*
209		* @param string $value
210		*
211		* @return self
212		*/
213	98	public function type(string $value): self
214		{
215	98	$new = clone $this;
216	98	$new->type = $value;
217	98	return $new;
218		}
219
220	98	private function getId(): string
221		{
222	98	$id = $this->options['id'] ?? $this->id;
223
224	98	if ($id === null) {
225	98	$id = HtmlForm::getInputId($this->data, $this->attribute, $this->charset);
226		}
227
228	98	return $id !== false ? (string) $id : '';
229		}
230
231	98	private function getName(): string
232		{
233	98	return ArrayHelper::remove($this->options, 'name', HtmlForm::getInputName($this->data, $this->attribute));
234		}
235
236	98	private function getValue()
237		{
238	98	$value = HtmlForm::getAttributeValue($this->data, $this->attribute);
239	97	if ($value !== null && is_scalar($value)) {
240	24	$value = (string)$value;
241		}
242
243	97	return ArrayHelper::remove(
244	97	$this->options,
245	97	'value',
246	97	$value
247		);
248		}
249
250	95	private function setPlaceholder(): void
251		{
252	95	if (!isset($this->options['placeholder']) && !(in_array($this->type, ['date', 'file', 'hidden', 'color'], true))) {
253	68	$attributeName = HtmlForm::getAttributeName($this->attribute);
254	68	$this->options['placeholder'] = $this->data->getAttributeLabel($attributeName);
255		}
256	95	}
257		}
258

yiisoft / form

Push — dependabot/github_actions/acti... ( 6c9f07 )

Input::setPlaceholder() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like