Feature/Conditional Form

[ibelar]

Conditional Form

Show or hide input field base on other input field condition.
Support all semantic-ui form validation rule.
Note on rule. FormService also add two more rule to semantic-ui existing ones:
notEmpty and isVisible.

• Show "this field" if all condition are met.
  fieldRules is an array that contains items where each item describe the field to hide or show
  that depends on other field with their input value conditions.

Example

    $form->js()->atkConditionalForm(
      [ 'fieldRules =>
        [
          'fieldToShow' => ['field1' => 'notEmpty', 'field2' => 'number']
        ]
      ]);

Can be phrase this way: Display 'fieldToShow' if 'field1' is not empty AND field2 is a number.

Support for OR condition

Adding and array of field => rules for the same field will OR the condition for that field.

    $form->js()->atkConditionalForm(
      [ 'fieldRules =>
        [
          'hair_cut' => [
                          ['race' => 'contains[poodle]', 'age'=>'integer[0..5]'],
                          ['race' => 'isExactly[bichon]']
                        ]
       ]
      ]);

Can be phrase this way: Display 'hair_cut' if 'race' contains 'poodle' AND 'age' is between 0 and 5 OR 'race' contains the exact word 'bichon'.

Support AND condition on same field.

Adding an array of conditions for the same field is also support.

    $form->js()->atkConditionalForm(
      [ 'fieldRules =>
        [
          'ext' => ['phone' => ['number', 'minLength[7]']]
        ]
      ]);

Can be phrase this way: Display 'ext' if phone is a number AND phone has at least 7 char.

See semantic-ui validation rule for more details: https://semantic-ui.com/behaviors/form.html#validation-rules

Demos available using /demos/jscondform.php

Note

atkjs-ui.js need to be rebuild.

[codecov]

Codecov Report

Merging #422 into develop will increase coverage by 0.64%.
The diff coverage is 90.47%.

@@              Coverage Diff              @@
##             develop     #422      +/-   ##
=============================================
+ Coverage      67.83%   68.48%   +0.64%     
- Complexity      1422     1428       +6     
=============================================
  Files             76       77       +1     
  Lines           3355     3376      +21     
=============================================
+ Hits            2276     2312      +36     
+ Misses          1079     1064      -15

Impacted Files	Coverage Δ	Complexity Δ
src/Form.php	64.6% <100%> (+3.06%)	50 <2> (+3)	⬆️
src/jsConditionalForm.php	83.33% <83.33%> (ø)	3 <3> (?)
src/jsExpression.php	84.61% <0%> (+1.28%)	36% <0%> (ø)	⬇️
src/TableColumn/Status.php	82.35% <0%> (+8.82%)	12% <0%> (ø)	⬇️
src/FormField/Radio.php	100% <0%> (+100%)	7% <0%> (ø)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 5d8de30...519d58b. Read the comment docs.

[ibelar]

Enhancement

Add ability to show or hide an entire group of fields by using a group selector.
To hide or show a group, simply add a field that belong to that group and pass the group selector.

$f->js(true)->atkConditionalForm([
   'fieldRules' => ['php' => [['dev' => 'checked']], 'other'=>['dev'=>'checked']],
   'selector' => '.atk-form-group']);

Show group where 'php' belong if dev is checked and show group where 'other' belong if dev is checked.

[romaninsh]

probably needs a demo too.

[ibelar]

there is an example of group hiding in demos/jscondform.php at the very end, i.e. last form.

…

On Fri, Mar 30, 2018 at 8:01 AM, Romans Malinovskis < ***@***.***> wrote: probably needs a demo too. — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#422 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/ACGjPt1SgcUuMHk_g9efUj4lIt_q-QL7ks5tjh6LgaJpZM4S_c_j> .

-- Alain Belair

[romaninsh]

This PR looks great. Reviewed.

[romaninsh]

However - documentation is lacking (.rst). I'll try to add it myself.

[romaninsh]

Additional problems:

• Enter on the form is broken.
• Form sometimes flickers (disappears then re-appears)
• re-validation should occur when inputing, e.g. the first example should show next field not on change but before entry is finished