validator component

sources/Forms/Block/Base/CheckboxFormBlock.php

@@ -15,8 +15,11 @@ use Combodo\iTop\Forms\Register\OptionsRegister;
 use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
 
 /**
- * Form block for checkbox.
+ * A block to manage a checkbox.
+ * This block expose one output: whether the checkbox is checked or not.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class CheckboxFormBlock extends AbstractTypeFormBlock
 {

sources/Forms/Block/Base/ChoiceFormBlock.php

@@ -14,8 +14,11 @@ use Combodo\iTop\Forms\IO\Format\StringIOFormat;
 use Combodo\iTop\Forms\Register\IORegister;
 
 /**
- * Form block for choices.
+ * A block to manage a list of choices.
+ * This block expose two outputs: the label and the value of the selected choice.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class ChoiceFormBlock extends AbstractTypeFormBlock
 {

sources/Forms/Block/Base/ChoiceFromInputsBlock.php

@@ -11,7 +11,10 @@ use Combodo\iTop\Forms\IO\FormInput;
 use Combodo\iTop\Forms\Register\OptionsRegister;
 
 /**
+ * A block to manage a list of choices given by forms inputs current values.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class ChoiceFromInputsBlock extends ChoiceFormBlock
 {

sources/Forms/Block/Base/CollectionBlock.php

@@ -15,8 +15,10 @@ use Combodo\iTop\Forms\Register\OptionsRegister;
 use Combodo\iTop\Forms\Register\RegisterException;
 
 /**
- * Collection form type.
+ * A block to manage collections of form blocks.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class CollectionBlock extends AbstractTypeFormBlock
 {

sources/Forms/Block/Base/DateFormBlock.php

@@ -12,8 +12,10 @@ use Combodo\iTop\Forms\Register\OptionsRegister;
 use Symfony\Component\Form\Extension\Core\Type\DateType;
 
 /**
- * Form block for date.
+ * A block to manage a date field.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class DateFormBlock extends AbstractTypeFormBlock
 {

sources/Forms/Block/Base/DateTimeFormBlock.php

@@ -12,8 +12,10 @@ use Combodo\iTop\Forms\Register\OptionsRegister;
 use Symfony\Component\Form\Extension\Core\Type\DateTimeType;
 
 /**
- * Form block for date time.
+ * A block to manage a date and time field
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class DateTimeFormBlock extends AbstractTypeFormBlock
 {

sources/Forms/Block/Base/FormBlock.php

@@ -19,8 +19,10 @@ use ReflectionClass;
 use ReflectionException;
 
 /**
- * Complex form type.
+ * A block to manage a form with children.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class FormBlock extends AbstractTypeFormBlock
 {

sources/Forms/Block/Base/NumberFormBlock.php

@@ -13,8 +13,11 @@ use Combodo\iTop\Forms\Register\IORegister;
 use Symfony\Component\Form\Extension\Core\Type\NumberType;
 
 /**
- * Form block for string.
+ * A block to manage a number input.
+ * This block exposes a single output: the number value.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class NumberFormBlock extends AbstractTypeFormBlock
 {

sources/Forms/Block/Base/TextAreaFormBlock.php

@@ -11,8 +11,10 @@ use Combodo\iTop\Forms\Block\AbstractTypeFormBlock;
 use Symfony\Component\Form\Extension\Core\Type\TextareaType;
 
 /**
- * Form block for text area.
+ * A block to manage a textarea.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class TextAreaFormBlock extends AbstractTypeFormBlock
 {

sources/Forms/Block/Base/TextFormBlock.php

@@ -13,8 +13,11 @@ use Combodo\iTop\Forms\Register\IORegister;
 use Symfony\Component\Form\Extension\Core\Type\TextType;
 
 /**
- * Form block for string.
+ * A block to manage a text input.
+ * This block exposes a single text output.
  *
+ * @package Combodo\iTop\Forms\Block\Base
+ * @since 3.3.0
  */
 class TextFormBlock extends AbstractTypeFormBlock
 {