feat(StatusPasswordStrengthIndicator): Added component documentation (#630)

Added component documentation.

Part of #620

ui/StatusQ/src/StatusQ/Controls/StatusPasswordStrengthIndicator.qml

@@ -4,14 +4,90 @@ import QtQuick.Controls 2.14
 import StatusQ.Core.Theme 0.1
 import StatusQ.Core 0.1
 
+/*!
+   \qmltype StatusPasswordStrengthIndicator
+   \inherits StatusProgressBar
+   \inqmlmodule StatusQ.Controls
+   \since StatusQ.Controls 0.1
+   \brief It allows visualizing the password strength. Inherits from StatusProgressBar.
+
+   The \c StatusPasswordStrengthIndicator changes its text and color depending on the selected StatusPasswordStrengthIndicator::strength.
+
+   Since it inherits from \c StatusProgressBar, `value` property will change the length of the bar accordingly.
+
+   When `value` property is 0, StatusPasswordStrengthIndicator::strength is automatically set to StatusPasswordStrengthIndicator.Strength.None and no text is displayed.
+
+   Example of how the control looks like:
+   \image status_password_strength_indicator.png
+
+   Example of how to use it:
+
+   \qml
+        StatusPasswordStrengthIndicator {
+            id: weakPw
+            strength: StatusPasswordStrengthIndicator.Strength.Weak
+            value: 0.5
+        }
+
+        StatusPasswordStrengthIndicator {
+            id: sosoPw
+            strength: StatusPasswordStrengthIndicator.Strength.SoSo
+            value: 0.25
+        }
+   \endqml
+
+   For a list of components available see StatusQ.
+*/
 StatusProgressBar {
     id: control
 
+    /*!
+       \qmlproperty string StatusPasswordStrengthIndicator::strength
+       This property holds the password strength value. Possible values are:
+       \list
+       \li StatusPasswordStrengthIndicator.Strength.None
+       \li StatusPasswordStrengthIndicator.Strength.VeryWeak
+       \li StatusPasswordStrengthIndicator.Strength.Weak
+       \li StatusPasswordStrengthIndicator.Strength.SoSo
+       \li StatusPasswordStrengthIndicator.Strength.Good
+       \li StatusPasswordStrengthIndicator.Strength.Great
+       \endlist
+    */
     property var strength
+    /*!
+       \qmlproperty string StatusPasswordStrengthIndicator::labelVeryWeak
+       This property holds the text shown when the strength is StatusPasswordStrengthIndicator.Strength.VeryWeak.
+
+       Default value: "Very weak"
+    */
     property string labelVeryWeak: "Very weak"
+    /*!
+       \qmlproperty string StatusPasswordStrengthIndicator::labelWeak
+       This property holds the text shown when the strength is StatusPasswordStrengthIndicator.Strength.Weak.
+
+       Default value: "Weak"
+    */
     property string labelWeak: "Weak"
+    /*!
+       \qmlproperty string StatusPasswordStrengthIndicator::labelSoso
+       This property holds the text shown when the strength is StatusPasswordStrengthIndicator.Strength.SoSo.
+
+       Default value: "So-so"
+    */
     property string labelSoso: "So-so"
+    /*!
+       \qmlproperty string StatusPasswordStrengthIndicator::labelGood
+       This property holds the text shown when the strength is StatusPasswordStrengthIndicator.Strength.Good.
+
+       Default value: "Good"
+    */
     property string labelGood: "Good"
+    /*!
+       \qmlproperty string StatusPasswordStrengthIndicator::labelGreat
+       This property holds the text shown when the strength is StatusPasswordStrengthIndicator.Strength.Great.
+
+       Default value: "Great"
+    */
     property string labelGreat: "Great"
 
     enum Strength {