Final Class Yiisoft\Html\Tag\Select

                protected function before(): string
{
    $name = (string) ($this->attributes['name'] ?? '');
    if (
        empty($name)
        || (
            $this->unselectValue === null
            && empty($this->attributes['multiple'])
        )
    ) {
        return '';
    }
    $input = Input::hidden(
        Html::getNonArrayableName($name),
        (string) $this->unselectValue,
    );
    // Make sure disabled input is not sending any value.
    if (!empty($this->attributes['disabled'])) {
        $input = $input->attribute('disabled', $this->attributes['disabled']);
    }
    if (!empty($this->attributes['form'])) {
        $input = $input->attribute('form', $this->attributes['form']);
    }
    return $input->render() . "\n";
}

            

                public function disabled(bool $disabled = true): self
{
    $new = clone $this;
    $new->attributes['disabled'] = $disabled;
    return $new;
}

            

                public function form(?string $formId): self
{
    $new = clone $this;
    $new->attributes['form'] = $formId;
    return $new;
}

            

                protected function generateContent(): string
{
    $items = $this->items;
    if ($this->prompt) {
        array_unshift($items, $this->prompt);
    }
    $items = array_map(
        fn($item) => $item instanceof Optgroup
            ? $item->selection(...$this->values)
            : $item->selected(in_array($item->getValue(), $this->values, true)),
        $items,
    );
    return $items
        ? "\n" . implode("\n", $items) . "\n"
        : '';
}

            

                protected function getName(): string
{
    return 'select';
}

            

                public function items(Optgroup|Option ...$items): self
{
    $new = clone $this;
    $new->items = $items;
    return $new;
}

            

                public function multiple(bool $multiple = true): self
{
    $new = clone $this;
    $new->attributes['multiple'] = $multiple;
    return $new;
}

            

                public function name(?string $name): self
{
    $new = clone $this;
    $new->attributes['name'] = $name;
    return $new;
}

            

                public function options(Option ...$options): self
{
    return $this->items(...$options);
}

            

                public function optionsData(
    array $data,
    bool $encode = true,
    array $optionsAttributes = [],
    array $groupsAttributes = [],
): self {
    $items = [];
    foreach ($data as $value => $content) {
        if (is_array($content)) {
            $items[] = (new Optgroup())
                ->label((string) $value)
                ->addAttributes($groupsAttributes[$value] ?? [])
                ->optionsData($content, $encode, $optionsAttributes);
        } else {
            $items[] = (new Option())
                ->attributes($optionsAttributes[$value] ?? [])
                ->value($value)
                ->content($content)
                ->encode($encode);
        }
    }
    return $this->items(...$items);
}

            

                protected function prepareAttributes(): void
{
    if (!empty($this->attributes['multiple']) && !empty($this->attributes['name'])) {
        $this->attributes['name'] = Html::getArrayableName((string) $this->attributes['name']);
    }
}

            

                public function prompt(string|Stringable|int|float|null $text): self
{
    $new = clone $this;
    $new->prompt = $text === null ? null : (new Option())
        ->value('')
        ->content($text);
    return $new;
}

            

                public function promptOption(?Option $option): self
{
    $new = clone $this;
    $new->prompt = $option;
    return $new;
}

            

                public function required(bool $required = true): self
{
    $new = clone $this;
    $new->attributes['required'] = $required;
    return $new;
}

            

                public function size(?int $size): self
{
    $new = clone $this;
    $new->attributes['size'] = $size;
    return $new;
}

            

                public function unselectValue(bool|float|int|string|Stringable|null $value): self
{
    $new = clone $this;
    $new->unselectValue = $value === null ? null : (string) $value;
    return $new;
}

            

                public function value(Stringable|bool|float|int|string|BackedEnum|null ...$value): self
{
    $values = array_filter(
        $value,
        static fn(mixed $v): bool => $v !== null,
    );
    $values = array_map(
        static function (Stringable|bool|float|int|string|BackedEnum $v): string {
            return (string) ($v instanceof BackedEnum ? $v->value : $v);
        },
        $values,
    );
    $new = clone $this;
    $new->values = $values;
    return $new;
}

            

                public function values(iterable $values): self
{
    $values = is_array($values) ? $values : iterator_to_array($values);
    return $this->value(...$values);
}