From 1a4f4d66c9ef3a076dc327999f8dc8b52caa5ac0 Mon Sep 17 00:00:00 2001
From: EvilKarter <maxJK@gmx.de>
Date: Fri, 20 Oct 2023 16:56:35 +0200
Subject: [PATCH] Add attribute brandImageOptions to NavBar (#79)

* Add attribute brandImageOptions to NavBar

* add Changelog message

---------

Co-authored-by: Max Kirmair <max.kirmair@waki-software.de>
---
 CHANGELOG.md         |  2 ++
 src/NavBar.php       |  8 +++++++-
 tests/NavBarTest.php | 11 +++++++++++
 3 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3be9aa3..f7b99b2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,10 +4,12 @@ Yii Framework 2 bootstrap5 extension Change Log
 2.0.5 under development
 -----------------------
 
+- Enh #78: Navbar has new attribute `brandImageOptions` (EvilKarter)
 - Bug #74: Bootstrap5 Button is not registering clientEvents (simialbi)
 - Bug #72: Nav::isItemActive(): Return value must be of type bool, int returned (hirenbhut93)
 - Bug #62: Navbar can now accept `collapseOptions` to be `false` (theblindfrog)
 
+
 2.0.4 November 30, 2022
 -----------------------
 
diff --git a/src/NavBar.php b/src/NavBar.php
index 45e2555..4dc4289 100644
--- a/src/NavBar.php
+++ b/src/NavBar.php
@@ -75,6 +75,12 @@ class NavBar extends Widget
      * @since 2.0.8
      */
     public $brandImage = false;
+
+    /**
+     * @var array the HTML attributes of the brand image.
+     * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered.
+     */
+    public $brandImageOptions = [];
     /**
      * @var array|string|bool $url the URL for the brand's hyperlink tag. This parameter will be processed by [[\yii\helpers\Url::to()]]
      * and will be used for the "href" attribute of the brand link. Default value is false that means
@@ -144,7 +150,7 @@ class NavBar extends Widget
             $this->offcanvasOptions['id'] = "{$this->options['id']}-offcanvas";
         }
         if ($this->brandImage !== false) {
-            $this->brandLabel = Html::img($this->brandImage);
+            $this->brandLabel = Html::img($this->brandImage, $this->brandImageOptions);
         }
         if ($this->brandLabel !== false) {
             Html::addCssClass($this->brandOptions, ['widget' => 'navbar-brand']);
diff --git a/tests/NavBarTest.php b/tests/NavBarTest.php
index e9caaf9..85f042a 100644
--- a/tests/NavBarTest.php
+++ b/tests/NavBarTest.php
@@ -48,6 +48,17 @@ EXPECTED;
 
         $this->assertContains('<a class="navbar-brand" href="/"><img src="/images/test.jpg" alt=""></a>', $out);
     }
+    
+    public function testBrandImageOptions()
+    {
+        $out = NavBar::widget([
+            'brandImage' => '/images/test.jpg',
+            'brandImageOptions' => ['alt' => 'test image'],
+            'brandUrl' => '/',
+        ]);
+
+        $this->assertContains('<a class="navbar-brand" href="/"><img src="/images/test.jpg" alt="test image"></a>', $out);
+    }
 
     public function testBrandLink()
     {