-
-
+
-
-
- 
+
+ 
-
- 
+
+ 
-
+
-
+
+
+
+ 
',
+ * // equivalent to the above
+ * ['content' => '
'],
+ * // the item contains both the image and the caption
+ * [
+ * 'content' => '
',
+ * 'caption' => 'This is the caption text
', + * 'captionOptions' => ['class' => ['d-none', 'd-md-block']] + * 'options' => [...], + * ], + * ] + * ]); + * ``` + * + * @see https://getbootstrap.com/docs/5.1/components/carousel/ + * + * @author Antonio Ramirez',
+ * // optional, the caption (HTML) of the slide
+ * 'caption' => 'This is the caption text
', + * // optional the HTML attributes of the slide container + * 'options' => [], + * ] + * ``` + */ + public array $items = []; + /** + * @var bool Animate slides with a fade transition instead of a slide. Defaults to `false` + */ + public bool $crossfade = false; + /** + * {@inheritdoc} + */ + public array $options = ['data' => ['bs-ride' => 'carousel']]; + + /** + * {@inheritDoc} + * + * @throws InvalidConfigException + */ + public function init(): void + { + parent::init(); + Html::addCssClass($this->options, ['widget' => 'carousel slide']); + if ($this->crossfade) { + Html::addCssClass($this->options, ['animation' => 'carousel-fade']); + } + } + + /** + * {@inheritdoc} + * + * @throws InvalidConfigException + */ + public function run(): string + { + $this->registerPlugin('carousel'); + + return implode("\n", [ + Html::beginTag('div', $this->options), + $this->renderIndicators(), + $this->renderItems(), + $this->renderControls(), + Html::endTag('div'), + ]) . "\n"; + } + + /** + * Renders carousel indicators. + * + * @return string the rendering result + */ + public function renderIndicators(): string + { + if ($this->showIndicators === false) { + return ''; + } + $indicators = []; + for ($i = 0, $count = count($this->items); $i < $count; $i++) { + $options = [ + 'data' => [ + 'bs-target' => '#' . $this->options['id'], + 'bs-slide-to' => $i, + ], + 'type' => 'button', + ]; + if ($i === 0) { + Html::addCssClass($options, ['activate' => 'active']); + $options['aria']['current'] = 'true'; + } + $indicators[] = Html::tag('button', '', $options); + } + + return Html::tag('div', implode("\n", $indicators), ['class' => ['carousel-indicators']]); + } + + /** + * Renders carousel items as specified on [[items]]. + * + * @throws InvalidConfigException + * + * @return string the rendering result + */ + public function renderItems(): string + { + $items = []; + + foreach ($this->items as $i => $iValue) { + $items[] = $this->renderItem($iValue, $i); + } + + return Html::tag('div', implode("\n", $items), ['class' => 'carousel-inner']); + } + + /** + * Renders a single carousel item + * + * @param array|string $item a single item from [[items]] + * @param int $index the item index as the first item should be set to `active` + * + *@throws Exception + * @throws InvalidConfigException if the item is invalid + * + * @return string the rendering result + */ + public function renderItem(array|string $item, int $index): string + { + if (is_string($item)) { + $content = $item; + $caption = null; + $options = []; + } elseif (isset($item['content'])) { + $content = $item['content']; + $caption = ArrayHelper::getValue($item, 'caption'); + if ($caption !== null) { + $captionOptions = ArrayHelper::remove($item, 'captionOptions', []); + Html::addCssClass($captionOptions, ['widget' => 'carousel-caption']); + + $caption = Html::tag('div', $caption, $captionOptions); + } + $options = ArrayHelper::getValue($item, 'options', []); + } else { + throw new InvalidConfigException('The "content" option is required.'); + } + + Html::addCssClass($options, ['widget' => 'carousel-item']); + if ($index === 0) { + Html::addCssClass($options, ['activate' => 'active']); + } + + return Html::tag('div', $content . "\n" . $caption, $options); + } + + /** + * Renders previous and next control buttons. + * + * @throws InvalidConfigException if [[controls]] is invalid. + * + * @return string The rendered controls + */ + public function renderControls(): string + { + if (isset($this->controls[0], $this->controls[1])) { + return Html::button($this->controls[0], [ + 'class' => 'carousel-control-prev', + 'data' => [ + 'bs-target' => '#' . $this->options['id'], + 'bs-slide' => 'prev', + ], + 'type' => 'button', + ]) . "\n" + . Html::button($this->controls[1], [ + 'class' => 'carousel-control-next', + 'data' => [ + 'bs-target' => '#' . $this->options['id'], + 'bs-slide' => 'next', + ], + 'type' => 'button', + ]); + } + if ($this->controls === false) { + return ''; + } + throw new InvalidConfigException('The "controls" property must be either false or an array of two elements.'); + } +} diff --git a/src/Dropdown.php b/src/Dropdown.php new file mode 100644 index 0000000..b22957f --- /dev/null +++ b/src/Dropdown.php @@ -0,0 +1,184 @@ + + * Label + * [ + * ['label' => 'DropdownA', 'url' => '/'], + * ['label' => 'DropdownB', 'url' => '#'], + * ], + * ]); + * ?> + * + * ``` + * + * @see https://getbootstrap.com/docs/5.1/components/dropdowns/ + * + * @author Antonio RamirezSome error message.
', + Html::error($model, 'foo', ['tag' => 'p']), + ); + } +} diff --git a/tests/LinkPagerTest.php b/tests/LinkPagerTest.php new file mode 100644 index 0000000..09889c7 --- /dev/null +++ b/tests/LinkPagerTest.php @@ -0,0 +1,200 @@ +getPagination(5); + $output = LinkPager::widget( + [ + 'pagination' => $pagination, + 'firstPageLabel' => true, + 'lastPageLabel' => true, + ], + ); + $this->assertStringContainsString( + 'Woohoo, you\'re reading this text in a modal!
'; + Modal::end(); + $out = ob_get_clean(); + + $expected = << +Woohoo, you\'re reading this text in a modal!
'; + Modal::end(); + $out = ob_get_clean(); + + $this->assertStringContainsString( + '', + $out + ); + } + + public function testDialogOptions(): void + { + Modal::$counter = 0; + $out = Modal::widget( + [ + 'closeButton' => false, + 'dialogOptions' => ['class' => 'test', 'style' => 'text-align:center;'], + ], + ); + + $expected = << +
',
+ $out,
+ );
+ }
+
+ public function testBrandImageOptions(): void
+ {
+ $out = NavBar::widget(
+ [
+ 'brandImage' => '/images/test.jpg',
+ 'brandImageOptions' => ['alt' => 'test image'],
+ 'brandUrl' => '/',
+ ],
+ );
+ $this->assertStringContainsString(
+ '',
+ $out,
+ );
+ }
+
+ public function testBrandLink(): void
+ {
+ $out = NavBar::widget(
+ [
+ 'brandLabel' => 'Yii Framework',
+ 'brandUrl' => false,
+ ],
+ );
+ $this->assertStringContainsString('Yii Framework', $out);
+ }
+
+ public function testBrandSpan(): void
+ {
+ $out = NavBar::widget(
+ [
+ 'brandLabel' => 'Yii Framework',
+ 'brandUrl' => null,
+ ],
+ );
+ $this->assertStringContainsString('', $out);
+ }
+
+
+ public function testNavAndForm(): void
+ {
+ NavBar::$counter = 0;
+
+ ob_start();
+ NavBar::begin(
+ [
+ 'brandLabel' => 'My Company',
+ 'brandUrl' => '/',
+ 'options' => [],
+ ]
+ );
+ echo Nav::widget(
+ [
+ 'options' => [
+ 'class' => ['mr-auto'],
+ ],
+ 'items' => [
+ ['label' => 'Home', 'url' => '#'],
+ ['label' => 'Link', 'url' => '#'],
+ ['label' => 'Dropdown', 'items' => [
+ ['label' => 'Action', 'url' => '#'],
+ ['label' => 'Another action', 'url' => '#'],
+ '-',
+ ['label' => 'Something else here', 'url' => '#'],
+ ]],
+ ],
+ ],
+ );
+ echo <<
+
+
+
+ HTML;
+
+ NavBar::end();
+ $out = ob_get_clean();
+
+ $expected = <<
+ Woohoo, you\'re reading this text in an offcanvas!
'; + Offcanvas::end(); + $out = ob_get_clean(); + + $expected = << +Woohoo, you're reading this text in an offcanvas!
+Woohoo, you\'re reading this text in an offcanvas!
'; + Offcanvas::end(); + $out = ob_get_clean(); + + $this->assertStringContainsString( + '', + $out + ); + } +} diff --git a/tests/PopoverTest.php b/tests/PopoverTest.php new file mode 100644 index 0000000..bd1a702 --- /dev/null +++ b/tests/PopoverTest.php @@ -0,0 +1,66 @@ + ['class' => ['btn', 'btn-primary']]]); + + $expected = <<Show + HTML; + $this->assertEqualsWithoutLE($expected, $out); + } + + public function testClientOptions(): void + { + Popover::$counter = 0; + Popover::widget( + [ + 'headerOptions' => ['class' => ['test-header']], + 'placement' => Popover::PLACEMENT_BOTTOM, + 'title' => 'Test Popover', + ], + ); + + $js = Yii::$app->view->js[View::POS_READY]; + + $this->assertIsArray($js); + $options = array_shift($js); + $this->assertContainsWithoutLE("(new bootstrap.Popover('#w0', {", $options); + $this->assertContainsWithoutLE("id=\u0022w0-popover\u0022", $options); + $this->assertContainsWithoutLE("class=\u0022test-header popover-header\u0022", $options); + $this->assertContainsWithoutLE('"placement":"bottom"', $options); + $this->assertContainsWithoutLE('"title":"Test Popover"', $options); + } + + public function testContent(): void + { + Popover::$counter = 0; + Popover::begin([]); + echo Html::tag('span', 'Test content', ['class' => ['test-content']]); + Popover::end(); + + $js = Yii::$app->view->js[View::POS_READY]; + + $this->assertIsArray($js); + $options = array_shift($js); + $this->assertContainsWithoutLE( + '"content":"\u003Cspan class=\u0022test-content\u0022\u003ETest content\u003C\/span\u003E"', + $options, + ); + } +} diff --git a/tests/ProgressTest.php b/tests/ProgressTest.php new file mode 100644 index 0000000..f11948e --- /dev/null +++ b/tests/ProgressTest.php @@ -0,0 +1,102 @@ + 'Progress', + 'percent' => 25, + 'barOptions' => ['class' => 'bg-warning'], + ], + ); + + $expected = << + + + HTML; + $this->assertEqualsWithoutLE($expected, $out); + } + + public function testRender(): void + { + Progress::$counter = 0; + $out = Progress::widget( + [ + 'bars' => [ + ['label' => 'Progress', 'percent' => 25], + ], + ], + ); + + $expected = << + + + HTML; + $this->assertEqualsWithoutLE($expected, $out); + } + + + public function testMultiple(): void + { + Progress::$counter = 0; + $out = Progress::widget( + [ + 'bars' => [ + ['label' => '', 'percent' => 15], + ['label' => '', 'percent' => 30, 'options' => ['class' => ['bg-success']]], + ['label' => '', 'percent' => 20, 'options' => ['class' => ['bg-info']]], + ], + ], + ); + + $expected = << + + + + + HTML; + $this->assertEqualsWithoutLE($expected, $out); + } + + /** + * @see https://github.com/yiisoft/yii2-bootstrap5/issues/121 + */ + public function testRussianLocaleRendering(): void + { + $this->mockWebApplication( + [ + 'language' => 'ru-RU', + 'sourceLanguage' => 'en-US', + ], + ); + + Progress::$counter = 0; + $out = Progress::widget([ + 'bars' => [ + ['label' => 'Progress', 'percent' => 25], + ], + ]); + + $expected = << + + + HTML; + $this->assertEqualsWithoutLE($expected, $out); + } +} diff --git a/tests/TabsTest.php b/tests/TabsTest.php new file mode 100644 index 0000000..972f152 --- /dev/null +++ b/tests/TabsTest.php @@ -0,0 +1,423 @@ + [ + [ + 'label' => 'Page1', + 'content' => 'Page1', + ], + [ + 'label' => 'Page2', + 'content' => 'Page2', + ], + ], + ], + ); + $this->assertContainsWithoutLE(' +