icon constants, doc update icon, cleanup

Author: MacGyer

src/widgets/Icon.php

@@ -15,19 +15,42 @@
 /**
  * Icon can be used to display a Materialize icon.
  *
- * Please note that the Materialize icons are shipped in a separate font file. This font file is automatically registered
- * by the [[\macgyer\yii2materializecss\assets\MaterializeAsset|MaterializeAsset]].
+ * To be compatible with GDPR (EU) the MaterializeFontAsset is not loaded automatically via the [[\macgyer\yii2materializecss\assets\MaterializeAsset|MaterializeAsset]]. The font asset requests the Material Icon font from Google servers (as stated in the Materialize docs).
+ * If you are not affected by GDPR, simply load the [[\macgyer\yii2materializecss\assets\MaterializeFontAsset|MaterializeFontAsset]] in your layout or AppAsset.
  *
- * If you do not load the default [[\macgyer\yii2materializecss\assets\MaterializeAsset|MaterializeAsset]] make sure to at least load
- * [[\macgyer\yii2materializecss\assets\MaterializeFontAsset|MaterializeFontAsset]] (or another source providing the font file) to correctly
- * display the icons.
+ * Otherwise you need to self-host the Material Icon font (i. e. do not request them from Google). You could use `material-icons` (https://www.npmjs.com/package/material-icons) to load the font files, CSS and SCSS from NPM and include them in your build process.
  *
  * @author Christoph Erdmann <yii2-materializecss@pluspunkt-coding.de>
  * @package widgets
  * @see https://materializecss.com/icons.html
  */
 class Icon extends BaseWidget
 {
+    /**
+     * Sets the [[size]] of the icon to "tiny".
+     */
+    public const SIZE_TINY = 'tiny';
+    /**
+     * Sets the [[size]] of the icon to "small". This is the default.
+     */
+    public const SIZE_SMALL = 'small';
+    /**
+     * Sets the [[size]] of the icon to "medium".
+     */
+    public const SIZE_MEDIUM = 'medium';
+    /**
+     * Sets the [[size]] of the icon to "large".
+     */
+    public const SIZE_LARGE = 'large';
+    /**
+     * Sets the [[position]] of the icon to "left".
+     */
+    public const POSITION_LEFT = 'left';
+    /**
+     * Sets the [[position]] of the icon to "right".
+     */
+    public const POSITION_RIGHT = 'right';
+
     /**
      * @var string the name of the icon.
      *
@@ -40,11 +63,16 @@ class Icon extends BaseWidget
      *
      * Currently "left" and "right" are natively supported by Materialize, but you can set this property to a custom string
      * which will be added to the HTML class attribute and thus can be individually styled.
-     *
-     * The default icon position is "left".
      */
     public $position;
 
+    /**
+     * @var string the size of the icon.
+     *
+     * The default icon size is "small".
+     */
+    public $size = self::SIZE_SMALL;
+
     /**
      * @var array the HTML options for the icon tag.
      *
@@ -69,12 +97,15 @@ public function init()
         if (!$this->name) {
             throw new InvalidConfigException('The icon name must be specified.');
         }
+        Html::addCssClass($this->options, ['widget' => 'material-icons']);
 
-        if ($this->position === null) {
-            $this->position = 'left';
+        if ($this->position) {
+            Html::addCssClass($this->options, ['material-icon-position' => $this->position]);
         }
 
-        Html::addCssClass($this->options, ['material-icons', $this->position]);
+        if ($this->size) {
+            Html::addCssClass($this->options, ['material-icon-size' => $this->size]);
+        }
     }
 
     /**

src/widgets/media/MaterialBox.php

@@ -58,7 +58,7 @@ public function init()
         if (!$this->imageSrc) {
             $imageSrc = ArrayHelper::remove($this->imageOptions, 'src', null);
             if (!$imageSrc) {
-                throw new InvalidConfigException("Image src must be defined.");
+                throw new InvalidConfigException('Image src must be defined.');
             }
 
             $this->imageSrc = $imageSrc;
@@ -69,6 +69,11 @@ public function init()
         if ($this->imageCaption !== false) {
             $this->imageOptions['data-caption'] = $this->encodeImageCaption ? Html::encode($this->imageCaption) : $this->imageCaption;
         }
+
+        $alt = Html::encode(ArrayHelper::getValue($this->imageOptions, 'alt'));
+        if (!$alt) {
+            $this->imageOptions['alt'] = Html::encode($this->imageCaption);
+        }
     }
 
     /**