Accordion::defaultExpand() - Code Metrics - Inspection of "fix to render Stringable content in Accordion item" - yiisoft/yii-bootstrap5 - Measure and Improve Code Quality continuously with Scrutinizer

Test Failed

Pull Request — master (#85)

by Albert

created 2022-04-01 16:06 UTC

Accordion::defaultExpand() A

↳ Parent: Accordion

Complexity

Conditions	3
Paths	2

Size

Total Lines	11
Code Lines	6

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	1
CRAP Score	4.125

Importance

Changes

Metric	Value
cc	3
eloc	6
nc	2
nop	1
dl	0
loc	11
ccs	1
cts	2
cp	0.5
crap	4.125
rs	10
c	0
b	0
f	0

<?php

declare(strict_types=1);

namespace Yiisoft\Yii\Bootstrap5;

use JsonException;
use Stringable;
use RuntimeException;
use Yiisoft\Arrays\ArrayHelper;
use Yiisoft\Html\Html;

use function array_key_exists;
use function array_merge;
use function implode;
use function is_array;
use function is_numeric;
use function is_string;

/**
 * Accordion renders an accordion bootstrap JavaScript component.
 *
 * For example:
 *
 * ```php
 * echo Accordion::widget()
 *     ->items([
 *         [
 *             'label' => 'Accordion Item #1',
 *             'content' => [
 *                 'This is the first items accordion body. It is shown by default, until the collapse plugin ' .
 *                 'the appropriate classes that we use to style each element. These classes control the ' .
 *                 'overall appearance, as well as the showing and hiding via CSS transitions. You can  ' .
 *                 'modify any of this with custom CSS or overriding our default variables. Its also worth ' .
 *                 'noting that just about any HTML can go within the .accordion-body, though the transition ' .
 *                 'does limit overflow.',
 *             ],
 *         ],
 *         [
 *             'label' => 'Accordion Item #2',
 *             'content' => '<strong>This is the second items accordion body.</strong> It is hidden by default, ' .
 *                 'until the collapse plugin adds the appropriate classes that we use to style each element. ' .
 *                 'These classes control the overall appearance, as well as the showing and hiding via CSS ' .
 *                 'transitions. You can modify any of this with custom CSS or overriding our default ' .
 *                 'variables. Its also worth noting that just about any HTML can go within the ' .
 *                 '<code>.accordion-body</code>, though the transition does limit overflow.',
 *             'contentOptions' => [
 *                 'class' => 'testContentOptions',
 *             ],
 *             'options' => [
 *                 'class' => 'testClass',
 *                 'id' => 'testId',
 *             ],
 *         ],
 *         [
 *             'label' => '<b>Accordion Item #3</b>',
 *             'content' => [
 *                 '<b>test content1</b>',
 *                 '<strong>This is the third items accordion body.</strong> It is hidden by default, until the ' .
 *                 'collapse plugin adds the appropriate classes that we use to style each element. These ' .
 *                 'classes control the overall appearance, as well as the showing and hiding via CSS ' .
 *                 'transitions. You can modify any of this with custom CSS or overriding our default ' .
 *                 'variables. Its also worth noting that just about any HTML can go within the ' .
 *                 '<code>.accordion-body</code>, though the transition does limit overflow.',
 *             ],
 *             'contentOptions' => [
 *                 'class' => 'testContentOptions2',
 *             ],
 *             'options' => [
 *                 'class' => 'testClass2',
 *                 'id' => 'testId2',
 *             ],
 *             'encode' => false,
 *         ],
 *     ]);
 * ```
 *
 * @link https://getbootstrap.com/docs/5.0/components/accordion/
 */
final class Accordion extends Widget
{
    private array $items = [];
    private array $expands = [];
    private ?bool $defaultExpand = null;
    private bool $encodeLabels = true;
    private bool $encodeTags = false;
    private bool $autoCloseItems = true;
    private array $headerOptions = [];
    private array $itemToggleOptions = [];
    private array $contentOptions = [];
    private array $options = [];
    private bool $flush = false;

    public function getId(?string $suffix = '-accordion'): ?string
    {
        return $this->options['id'] ?? parent::getId($suffix);
    }

    private function getCollapseId(array $item, int $index): string
    {
        return ArrayHelper::getValueByPath($item, ['contentOptions', 'id'], $this->getId() . '-collapse' . $index);
    }

    private function getHeaderId(array $item, int $index): string
    {
        return ArrayHelper::getValueByPath($item, ['headerOptions', 'id'], $this->getCollapseId($item, $index) . '-heading');
    }

    public function beforeRun(): bool
    {
        Html::addCssClass($this->options, ['widget' => 'accordion']);

        if ($this->flush) {
            Html::addCssClass($this->options, ['flush' => 'accordion-flush']);
        }

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

        return parent::beforeRun();
    }

    protected function run(): string
    {
        return Html::div($this->renderItems(), $this->options)
            ->encode($this->encodeTags)
            ->render();
    }

    /**
     * Whether to close other items if an item is opened. Defaults to `true` which causes an accordion effect.
     *
     * Set this to `false` to allow keeping multiple items open at once.
     *
     * @return self
     */
    public function allowMultipleOpenedItems(): self
    {
        $new = clone $this;
        $new->autoCloseItems = false;

        return $new;
    }

    /**
     * When tags Labels HTML should not be encoded.
     *
     * @return self
     */
    public function withoutEncodeLabels(): self
    {
        $new = clone $this;
        $new->encodeLabels = false;

        return $new;
    }

    /**
     * List of groups in the collapse widget. Each array element represents a single group with the following structure:
     *
     * - label: string, required, the group header label.
     * - encode: bool, optional, whether this label should be HTML-encoded. This param will override global
     *   `$this->encodeLabels` param.
     * - content: array|string|object, required, the content (HTML) of the group
     * - options: array, optional, the HTML attributes of the group
     * - contentOptions: optional, the HTML attributes of the group's content
     *
     * You may also specify this property as key-value pairs, where the key refers to the `label` and the value refers
     * to `content`. If value is a string it is interpreted as label. If it is an array, it is interpreted as explained
     * above.
     *
     * For example:
     *
     * ```php
     * echo Accordion::widget()
     *     ->items(
     *         [
     *             [
     *                 'Introduction' => 'This is the first collapsible menu',
     *                 'Second panel' => [
     *                     'content' => 'This is the second collapsible menu',
     *                 ],
     *             ],
     *             [
     *                 'label' => 'Third panel',
     *                 'content' => 'This is the third collapsible menu',
     *             ],
     *         ],
     *     );
     * ```
     *
     * @param array $value
     *
     * @return self
     */
    public function items(array $value): self
    {
        $new = clone $this;
        $new->items = $value;
        $new->expands = array_map(fn ($item) => isset($item['expand']) ? (bool) $item['expand'] : $this->defaultExpand, $new->items);

        return $new;
    }

    /**
     * Set expand property for items without it
     *
     * @param bool|null $default
     *
     * @return self
     */
    public function defaultExpand(?bool $default): self
    {
        if ($default === $this->defaultExpand) {
            return $this;
        }

        $new = clone $this;
        $new->defaultExpand = $default;
        $new->expands = array_map(fn ($item) => isset($item['expand']) ? (bool) $item['expand'] : $new->defaultExpand, $new->items);

        return $new;
    }

    /**
     * Options for each header if not present in item
     *
     * @param array $options
     *
     * @return self
     */
    public function headerOptions(array $options): self
    {
        $new = clone $this;
        $new->headerOptions = $options;

        return $new;
    }

    /**
     * The HTML options for the item toggle tag. Key 'tag' might be used here for the tag name specification.
     *
     * For example:
     *
     * ```php
     * [
     *     'tag' => 'div',
     *     'class' => 'custom-toggle',
     * ]
     * ```
     *
     * @param array $value
     *
     * @return self
     */
    public function itemToggleOptions(array $value): self
    {
        $new = clone $this;
        $new->itemToggleOptions = $value;

        return $new;
    }

    /**
     * Content options for items if not present in current
     *
     * @param array $options
     *
     * @return self
     */
    public function contentOptions(array $options): self
    {
        $new = clone $this;
        $new->contentOptions = $options;

        return $new;
    }

    /**
     * The HTML attributes for the widget container tag. The following special options are recognized.
     *
     * {@see Html::renderTagAttributes()} for details on how attributes are being rendered.
     *
     * @param array $value
     *
     * @return self
     */
    public function options(array $value): self
    {
        $new = clone $this;
        $new->options = $value;

        return $new;
    }

    /**
     * Remove the default background-color, some borders, and some rounded corners to render accordions
     * edge-to-edge with their parent container.
     *
     * @return self
     *
     * @link https://getbootstrap.com/docs/5.0/components/accordion/#flush
     */
    public function flush(): self
    {
        $new = clone $this;
        $new->flush = true;

        return $new;
    }

    /**
     * Renders collapsible items as specified on {@see items}.
     *
     * @throws JsonException|RuntimeException
     *
     * @return string the rendering result
     */
    private function renderItems(): string
    {
        $items = [];
        $index = 0;
        $expanded = in_array(true, $this->expands, true);
        $allClose = !$expanded && count($this->items) === count(array_filter($this->expands, fn ($expand) => $expand === false));

        foreach ($this->items as $item) {
            if (!is_array($item)) {
                $item = ['content' => $item];
            }

            if ($allClose === false && $expanded === false && $index === 0) {
                $item['expand'] = true;
            }

            if (!array_key_exists('label', $item)) {
                throw new RuntimeException('The "label" option is required.');
            }

            $options = ArrayHelper::getValue($item, 'options', []);
            $item = $this->renderItem($item, $index++);

            Html::addCssClass($options, ['panel' => 'accordion-item']);

            $items[] = Html::div($item, $options)->encode(false)->render();
        }

        return implode('', $items);
    }

    /**
     * Renders a single collapsible item group.
     *
     * @param string $label a label of the item group {@see items}
     * @param array $item a single item from {@see items}
     * @param int $index the item index as each item group content must have an id
     *
     * @throws JsonException|RuntimeException
     *
     * @return string the rendering result
     */
    private function renderItem(array $item, int $index): string
    {
        if (!array_key_exists('content', $item)) {
            throw new RuntimeException('The "content" option is required.');
        }

        $header = $this->renderHeader($item, $index);
        $collapse = $this->renderCollapse($item, $index);

        return $header . $collapse;
    }

    /**
     * Render collapse header
     *
     * @param array $item
     * @param int $index
     *
     * @return string
     */
    private function renderHeader(array $item, int $index): string
    {
        $options = ArrayHelper::getValue($item, 'headerOptions', $this->headerOptions);
        $tag = ArrayHelper::remove($options, 'tag', 'h2');
        $options['id'] = $this->getHeaderId($item, $index);
        $toggle = $this->renderToggle($item, $index);

        Html::addCssClass($options, ['widget' => 'accordion-header']);

        return Html::tag($tag, $toggle, $options)->encode(false)->render();
    }

    /**
     * Render collapse switcher
     *
     * @param array $item
     * @param int $index
     *
     * @return string
     */
    private function renderToggle(array $item, int $index): string
    {
        $label = $item['label'];
        $expand = $item['expand'] ?? false;
        $collapseId = $this->getCollapseId($item, $index);

        $options = array_merge(
            [
                'data-bs-toggle' => 'collapse',
                'aria-expanded' => $expand ? 'true' : 'false',
                'aria-controls' => $collapseId,
            ],
            $item['toggleOptions'] ?? $this->itemToggleOptions
        );
        $tag = ArrayHelper::remove($options, 'tag', 'button');
        $encode = ArrayHelper::remove($options, 'encode', $this->encodeLabels);

        Html::addCssClass($options, ['accordion-button']);

        if (!$expand) {
            Html::addCssClass($options, ['collapsed']);
        }

        if ($tag === 'a') {
            $options['href'] = '#' . $collapseId;
        } else {
            $options['data-bs-target'] = '#' . $collapseId;

            if ($tag === 'button' && !isset($options['type'])) {
                $options['type'] = 'button';
            }
        }

        return Html::tag($tag, $label, $options)->encode($encode)->render();
    }

    /**
     * Render collapse item
     *
     * @param array $item
     * @param int $index
     *
     * @return string
     */
    private function renderCollapse(array $item, int $index): string
    {
        $expand = $item['expand'] ?? false;
        $options = $item['contentOptions'] ?? $this->contentOptions;
        $tag = ArrayHelper::remove($options, 'tag', 'div');
        $body = $this->renderBody($item);
        $options['id'] = $this->getCollapseId($item, $index);

        Html::addCssClass($options, ['accordion-collapse collapse']);

        if ($expand) {
            Html::addCssClass($options, ['show']);
        }

        if (!isset($options['aria-label'], $options['aria-labelledby'])) {
            $options['aria-labelledby'] = $this->getHeaderId($item, $index);
        }

        if ($this->autoCloseItems) {
            $options['data-bs-parent'] = '#' . $this->getId();
        }

        return Html::tag($tag, $body, $options)->encode(false)->render();
    }

    /**
     * Render collapse body
     *
     * @param array $item
     *
     * @return string
     */
    private function renderBody(array $item): string
    {
        $items = '';

        if (is_a($item['content'], Stringable::class)) {
            $content = [$item['content']];
        } else {
            $content = (array) $item['content'];
        }

        foreach ($content as $value) {
            if (!is_string($value) && !is_numeric($value) && !is_a($value, Stringable::class)) {
                throw new RuntimeException('The "content" option should be a string, array or object.');
            }

            $items .= Html::div((string) $value, ['class' => 'accordion-body'])
                    ->encode($this->encodeTags)
                    ->render();
        }

        return $items;
    }
}


1		<?php
2
3		declare(strict_types=1);
4
5		namespace Yiisoft\Yii\Bootstrap5;
6
7		use JsonException;
8		use Stringable;
9		use RuntimeException;
10		use Yiisoft\Arrays\ArrayHelper;
11		use Yiisoft\Html\Html;
12
13		use function array_key_exists;
14		use function array_merge;
15		use function implode;
16		use function is_array;
17		use function is_numeric;
18		use function is_string;
19
20		/**
21		* Accordion renders an accordion bootstrap JavaScript component.
22		*
23		* For example:
24		*
25		* ```php
26		* echo Accordion::widget()
27		* ->items([
28		* [
29		* 'label' => 'Accordion Item #1',
30		* 'content' => [
31		* 'This is the first items accordion body. It is shown by default, until the collapse plugin ' .
32		* 'the appropriate classes that we use to style each element. These classes control the ' .
33		* 'overall appearance, as well as the showing and hiding via CSS transitions. You can ' .
34		* 'modify any of this with custom CSS or overriding our default variables. Its also worth ' .
35		* 'noting that just about any HTML can go within the .accordion-body, though the transition ' .
36		* 'does limit overflow.',
37		* ],
38		* ],
39		* [
40		* 'label' => 'Accordion Item #2',
41		* 'content' => '<strong>This is the second items accordion body.</strong> It is hidden by default, ' .
42		* 'until the collapse plugin adds the appropriate classes that we use to style each element. ' .
43		* 'These classes control the overall appearance, as well as the showing and hiding via CSS ' .
44		* 'transitions. You can modify any of this with custom CSS or overriding our default ' .
45		* 'variables. Its also worth noting that just about any HTML can go within the ' .
46		* '<code>.accordion-body</code>, though the transition does limit overflow.',
47		* 'contentOptions' => [
48		* 'class' => 'testContentOptions',
49		* ],
50		* 'options' => [
51		* 'class' => 'testClass',
52		* 'id' => 'testId',
53		* ],
54		* ],
55		* [
56		* 'label' => '<b>Accordion Item #3</b>',
57		* 'content' => [
58		* '<b>test content1</b>',
59		* '<strong>This is the third items accordion body.</strong> It is hidden by default, until the ' .
60		* 'collapse plugin adds the appropriate classes that we use to style each element. These ' .
61		* 'classes control the overall appearance, as well as the showing and hiding via CSS ' .
62		* 'transitions. You can modify any of this with custom CSS or overriding our default ' .
63		* 'variables. Its also worth noting that just about any HTML can go within the ' .
64		* '<code>.accordion-body</code>, though the transition does limit overflow.',
65		* ],
66		* 'contentOptions' => [
67		* 'class' => 'testContentOptions2',
68		* ],
69		* 'options' => [
70		* 'class' => 'testClass2',
71		* 'id' => 'testId2',
72		* ],
73		* 'encode' => false,
74		* ],
75		* ]);
76		* ```
77		*
78		* @link https://getbootstrap.com/docs/5.0/components/accordion/
79		*/
80		final class Accordion extends Widget
81		{
82		private array $items = [];
83		private array $expands = [];
84		private ?bool $defaultExpand = null;
85		private bool $encodeLabels = true;
86		private bool $encodeTags = false;
87		private bool $autoCloseItems = true;
88		private array $headerOptions = [];
89		private array $itemToggleOptions = [];
90		private array $contentOptions = [];
91		private array $options = [];
92		private bool $flush = false;
93
94	13	public function getId(?string $suffix = '-accordion'): ?string
95		{
96	13	return $this->options['id'] ?? parent::getId($suffix);
97		}
98
99	13	private function getCollapseId(array $item, int $index): string
100		{
101	13	return ArrayHelper::getValueByPath($item, ['contentOptions', 'id'], $this->getId() . '-collapse' . $index);
102		}
103	13
104	1	private function getHeaderId(array $item, int $index): string
105		{
106		return ArrayHelper::getValueByPath($item, ['headerOptions', 'id'], $this->getCollapseId($item, $index) . '-heading');
107	13	}
108	13
109		public function beforeRun(): bool
110		{
111	13	Html::addCssClass($this->options, ['widget' => 'accordion']);
112
113		if ($this->flush) {
114	13	Html::addCssClass($this->options, ['flush' => 'accordion-flush']);
115		}
116	13
117	8	if (!isset($this->options['id'])) {
118	8	$this->options['id'] = $this->getId();
119		}
120
121		return parent::beforeRun();
122		}
123
124		protected function run(): string
125		{
126		return Html::div($this->renderItems(), $this->options)
127		->encode($this->encodeTags)
128	1	->render();
129		}
130	1
131	1	/**
132		* Whether to close other items if an item is opened. Defaults to `true` which causes an accordion effect.
133	1	*
134		* Set this to `false` to allow keeping multiple items open at once.
135		*
136		* @return self
137		*/
138		public function allowMultipleOpenedItems(): self
139		{
140		$new = clone $this;
141	1	$new->autoCloseItems = false;
142
143	1	return $new;
144	1	}
145
146	1	/**
147		* When tags Labels HTML should not be encoded.
148		*
149		* @return self
150		*/
151		public function withoutEncodeLabels(): self
152		{
153		$new = clone $this;
154		$new->encodeLabels = false;
155
156		return $new;
157		}
158
159		/**
160		* List of groups in the collapse widget. Each array element represents a single group with the following structure:
161		*
162		* - label: string, required, the group header label.
163		* - encode: bool, optional, whether this label should be HTML-encoded. This param will override global
164		* `$this->encodeLabels` param.
165		* - content: array\|string\|object, required, the content (HTML) of the group
166		* - options: array, optional, the HTML attributes of the group
167		* - contentOptions: optional, the HTML attributes of the group's content
168		*
169		* You may also specify this property as key-value pairs, where the key refers to the `label` and the value refers
170		* to `content`. If value is a string it is interpreted as label. If it is an array, it is interpreted as explained
171		* above.
172		*
173		* For example:
174		*
175		* ```php
176		* echo Accordion::widget()
177		* ->items(
178		* [
179		* [
180		* 'Introduction' => 'This is the first collapsible menu',
181		* 'Second panel' => [
182		* 'content' => 'This is the second collapsible menu',
183		* ],
184		* ],
185		* [
186		* 'label' => 'Third panel',
187	13	* 'content' => 'This is the third collapsible menu',
188		* ],
189	13	* ],
190	13	* );
191	13	* ```
192		*
193	13	* @param array $value
194		*
195		* @return self
196		*/
197		public function items(array $value): self
198		{
199		$new = clone $this;
200		$new->items = $value;
201		$new->expands = array_map(fn ($item) => isset($item['expand']) ? (bool) $item['expand'] : $this->defaultExpand, $new->items);
202
203	1	return $new;
204		}
205	1
206		/**
207		* Set expand property for items without it
208		*
209	1	* @param bool\|null $default
210	1	*
211	1	* @return self
212		*/
213	1	public function defaultExpand(?bool $default): self
214		{
215		if ($default === $this->defaultExpand) {
216		return $this;
217		}
218
219		$new = clone $this;
220		$new->defaultExpand = $default;
221		$new->expands = array_map(fn ($item) => isset($item['expand']) ? (bool) $item['expand'] : $new->defaultExpand, $new->items);
222
223		return $new;
224		}
225
226		/**
227		* Options for each header if not present in item
228		*
229		* @param array $options
230		*
231		* @return self
232		*/
233		public function headerOptions(array $options): self
234		{
235		$new = clone $this;
236		$new->headerOptions = $options;
237
238		return $new;
239		}
240
241		/**
242		* The HTML options for the item toggle tag. Key 'tag' might be used here for the tag name specification.
243		*
244		* For example:
245		*
246		* ```php
247	1	* [
248		* 'tag' => 'div',
249	1	* 'class' => 'custom-toggle',
250	1	* ]
251		* ```
252	1	*
253		* @param array $value
254		*
255		* @return self
256		*/
257		public function itemToggleOptions(array $value): self
258		{
259		$new = clone $this;
260		$new->itemToggleOptions = $value;
261
262		return $new;
263		}
264
265		/**
266		* Content options for items if not present in current
267		*
268		* @param array $options
269		*
270		* @return self
271		*/
272		public function contentOptions(array $options): self
273		{
274		$new = clone $this;
275		$new->contentOptions = $options;
276
277		return $new;
278		}
279	1
280		/**
281	1	* The HTML attributes for the widget container tag. The following special options are recognized.
282	1	*
283		* {@see Html::renderTagAttributes()} for details on how attributes are being rendered.
284	1	*
285		* @param array $value
286		*
287		* @return self
288		*/
289		public function options(array $value): self
290		{
291		$new = clone $this;
292		$new->options = $value;
293
294		return $new;
295	1	}
296
297	1	/**
298	1	* Remove the default background-color, some borders, and some rounded corners to render accordions
299		* edge-to-edge with their parent container.
300	1	*
301		* @return self
302		*
303		* @link https://getbootstrap.com/docs/5.0/components/accordion/#flush
304		*/
305		public function flush(): self
306		{
307		$new = clone $this;
308		$new->flush = true;
309
310	13	return $new;
311		}
312	13
313	13	/**
314	13	* Renders collapsible items as specified on {@see items}.
315	13	*
316		* @throws JsonException\|RuntimeException
317	13	*
318	13	* @return string the rendering result
319	1	*/
320		private function renderItems(): string
321		{
322	13	$items = [];
323	11	$index = 0;
324		$expanded = in_array(true, $this->expands, true);
325		$allClose = !$expanded && count($this->items) === count(array_filter($this->expands, fn ($expand) => $expand === false));
326	13
327	3	foreach ($this->items as $item) {
328		if (!is_array($item)) {
329		$item = ['content' => $item];
330	10	}
331	10
332		if ($allClose === false && $expanded === false && $index === 0) {
333	10	$item['expand'] = true;
334		}
335	10
336	8	if (!array_key_exists('label', $item)) {
337	8	throw new RuntimeException('The "label" option is required.');
338		}
339
340	8	$options = ArrayHelper::getValue($item, 'options', []);
341		$item = $this->renderItem($item, $index++);
342
343		Html::addCssClass($options, ['panel' => 'accordion-item']);
344
345		$items[] = Html::div($item, $options)->encode(false)->render();
346		}
347
348		return implode('', $items);
349		}
350
351		/**
352		* Renders a single collapsible item group.
353		*
354	10	* @param string $label a label of the item group {@see items}
355		* @param array $item a single item from {@see items}
356	10	* @param int $index the item index as each item group content must have an id
357	9	*
358	9	* @throws JsonException\|RuntimeException
359	9	*
360		* @return string the rendering result
361	9	*/
362	9	private function renderItem(array $item, int $index): string
363		{
364		if (!array_key_exists('content', $item)) {
365	9	throw new RuntimeException('The "content" option is required.');
366	9	}
367
368		$header = $this->renderHeader($item, $index);
369	9	$collapse = $this->renderCollapse($item, $index);
370	9
371		return $header . $collapse;
372	9	}
373	8
374		/**
375		* Render collapse header
376	9	*
377	9	* @param array $item
378		* @param int $index
379		*
380	9	* @return string
381		*/
382	9	private function renderHeader(array $item, int $index): string
383	9	{
384		$options = ArrayHelper::getValue($item, 'headerOptions', $this->headerOptions);
385		$tag = ArrayHelper::remove($options, 'tag', 'h2');
386	9	$options['id'] = $this->getHeaderId($item, $index);
387		$toggle = $this->renderToggle($item, $index);
388
389		Html::addCssClass($options, ['widget' => 'accordion-header']);
390	9
391	9	return Html::tag($tag, $toggle, $options)->encode(false)->render();
392	9	}
393	9
394		/**
395	9	* Render collapse switcher
396		*
397	9	* @param array $item
398	1	* @param int $index
399	1	*
400		* @return string
401	8	*/
402	8	private function renderToggle(array $item, int $index): string
403	7	{
404		$label = $item['label'];
405	8	$expand = $item['expand'] ?? false;
406		$collapseId = $this->getCollapseId($item, $index);
407
408	9	$options = array_merge(
409	8	[
410	3	'data-bs-toggle' => 'collapse',
411	2	'aria-expanded' => $expand ? 'true' : 'false',
412	2	'aria-controls' => $collapseId,
413	2	],
414	2	$item['toggleOptions'] ?? $this->itemToggleOptions
415	2	);
416	2	$tag = ArrayHelper::remove($options, 'tag', 'button');
417		$encode = ArrayHelper::remove($options, 'encode', $this->encodeLabels);
418
419	2	Html::addCssClass($options, ['accordion-button']);
420
421	9	if (!$expand) {
422		Html::addCssClass($options, ['collapsed']);
423		}
424	1
425		if ($tag === 'a') {
426		$options['href'] = '#' . $collapseId;
427	8	} else {
428	8	$options['data-bs-target'] = '#' . $collapseId;
429
430		if ($tag === 'button' && !isset($options['type'])) {
431	8	$options['type'] = 'button';
432	8	}
433	8	}
434
435	8	return Html::tag($tag, $label, $options)->encode($encode)->render();
436		}
437
438		/**
439		* Render collapse item
440		*
441		* @param array $item
442		* @param int $index
443		*
444		* @return string
445		*/
446		private function renderCollapse(array $item, int $index): string
447		{
448		$expand = $item['expand'] ?? false;
449		$options = $item['contentOptions'] ?? $this->contentOptions;
450		$tag = ArrayHelper::remove($options, 'tag', 'div');
451		$body = $this->renderBody($item);
452		$options['id'] = $this->getCollapseId($item, $index);
453
454		Html::addCssClass($options, ['accordion-collapse collapse']);
455
456		if ($expand) {
457		Html::addCssClass($options, ['show']);
458		}
459
460		if (!isset($options['aria-label'], $options['aria-labelledby'])) {
461		$options['aria-labelledby'] = $this->getHeaderId($item, $index);
462		}
463
464		if ($this->autoCloseItems) {
465		$options['data-bs-parent'] = '#' . $this->getId();
466		}
467
468		return Html::tag($tag, $body, $options)->encode(false)->render();
469		}
470
471		/**
472		* Render collapse body
473		*
474		* @param array $item
475		*
476		* @return string
477		*/
478		private function renderBody(array $item): string
479		{
480		$items = '';
481
482		if (is_a($item['content'], Stringable::class)) {
483		$content = [$item['content']];
484		} else {
485		$content = (array) $item['content'];
486		}
487
488		foreach ($content as $value) {
489		if (!is_string($value) && !is_numeric($value) && !is_a($value, Stringable::class)) {
490		throw new RuntimeException('The "content" option should be a string, array or object.');
491		}
492
493		$items .= Html::div((string) $value, ['class' => 'accordion-body'])
494		->encode($this->encodeTags)
495		->render();
496		}
497
498		return $items;
499		}
500		}
501

yiisoft / yii-bootstrap5

Pull Request — master (#85)

Accordion::defaultExpand() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like