====== Formularz ======

===== CKEditor =====

<code php>
use common\CKEditor;
</code>

<code php>
$form->field($model, 'opis')->widget(CKEditor::className(), [
    'options' => ['rows' => 10],
    'preset' => 'advanced',
    'clientOptions' => [
        'extraPlugins' =>'justify',
      ]
])->label('Opis');
?>
</code>
==== Ładowanie treści do edytora za pomocą JS ====
<code>
CKEDITOR.instances['dynamicmodel-tresc'].setData(data);
</code>
<code php>
<textarea id="dynamicmodel-tresc">

...

</code>
===== Zabezpieczenie przed podwójnym wysłaniem formularza JS =====
<code>
// nie wolno nadawać przyciskowi 'id'=>'submit'

<?php $form = ActiveForm::begin(['id' => 'form-create']); ?>
...
<div class="form-group  float-right">
    <span id="spin1" class="btn btn-outline-secondary"><i class="fas fa-spinner fa-spin"></i></span>
    <?= Html::submitButton('Zapisuję się', ['class' => 'btn btn-success','id'=>'sub' ]) ?>
</div>

<?php ActiveForm::end(); ?>

...

<?php
$this->registerJs('
form = $("#form-create");
$("#spin1").hide();
$("#sub").on("click", function () {
    $(this).hide();
    $("#spin1").show();
});
$(form).on("afterValidate", function (event, messages, errorAttributes) {
    if (errorAttributes.length > 0) {
        $("#spin1").hide();
        $("#sub").show();
    }
}); 
');
</code>

===== Zabezpieczenie przed podwójnym wysłaniem formularza =====

W modelu tworzymy funkcję:

<code php>
public function getToken() {
    $token = \Yii::$app->getSecurity()->generateRandomString();
    $token = str_replace('+', '.', base64_encode($token));
    \Yii::$app->session->set('form_token', $token);
    return Html::hiddenInput('form_token', $token,['id'=>'form_token']);
}
</code>

W formularzu dodajemy:

<code php>
$form = ActiveForm::begin([
          'action' => '/regulacje/create?id=' . $id_struktura_dokumentow,
          'method' => 'post',
              'id' => 'form-vertical',
         'options' => [
                       'data-pjax' => true,
                        'onsubmit' => '$("#subbut").disabled = true;$("#form_token").val("-")',
                      ],
            ]);

<?= $model->token?>
<?= Html::submitButton('Zapisz', ['class' => 'btn btn-success', 'id' => 'subbut']) ?>
</code>

W kontrolerze zapisanie modelu:
<code php>
public function actionCreate() {
  ...
        
  $formTokenName = 'form_token';
  $formTokenValue = Yii::$app->request->post($formTokenName);
  $sessionTokenValue = Yii::$app->session->get($formTokenName);
  
  if($formTokenValue == $sessionTokenValue){
     $model->save();
     Yii::$app->session->remove($formTokenName);
  }

}
</code>
===== Zabezpieczenie przed wysłaniem formularza ENTERem =====
<code>
$(document).ready(function () {
    $(window).keydown(function (event) {
        if (event.keyCode === 13) {
            event.preventDefault();
            return false;
        }
    });
});
</code>

**Wersja AI  - lepsza, uwzględniająca ENTER w polu textarea**
<code>
$(window).keydown(function (event) {
    var activeElement = document.activeElement;
    if (activeElement.tagName.toLowerCase() === "textarea") {
        return true;
    } else {
        event.preventDefault();
        return false;
    }
});
</code>

----
===== CSRF - token =====

Jeśli robisz formularz ręcznie w HTML nie używając metod Yii2 to:
Yii2 ma zabezpieczenia przed atakami CSRF Cross-site request forgery
i z formularzem trzeba wysłać specjalny token.
<code php>
<input type="hidden" name="_csrf" value="<?= Yii::$app->request->getCsrfToken() ?>" />
</code>

----

===== Liczby dziesiętne - przecinek na kropkę =====

Przy wprowadzaniu liczb dziesiętnych chcemy aby separatorem był przecinek lub kropka.\\
Domyślnym znakiem jest kropka bo tak zapisuje się do bazy danych.\\
Użytkownicy przyzwyczajeni są do przecinków.

Rozwiązanie zamienia "w locie" przecinek na kropkę.<code php>
<?= field($model, 'ilosc')->textInput([
   'class'=>'coma form-control'
]) ?>
</code>
na końcu pliku formularza:
<code php>
<?php
$this->registerJs("        
   
        $('.coma').on('keyup', function(e){
            $(this).val($(this).val().replace(/[,]/g, '.'));
        });
");
</code>

----
===== Czerwone gwiazdki przy wymaganych polach =====

W modelu w funkcji rules ustalono wybrane pola jako wymagane (required)
W pliku formularza (_form.php) należy dodać na końcu

<code php>
＜?php

$this->registerCSS('
    form div.required label.control-label:before {
    content:" * ";
    color:red;
  }
');
</code>

Zamiast **before** można wpisać **after**

----
===== Formularz w Bootstrap modal =====

Aby w prawidłowo obsługiwać formularz w wyskakującym oknie (bootstrap modal)
formularz musi korzystać z technologii Ajax.\\
Technologię Ajax obsługuje widget Pjax.
<code php>
<?php yii\widgets\Pjax::begin(['id' => 'log-in']) ?>
   <?php $form = ActiveForm::begin([
          'id' => 'login-form',
     'options' => ['data-pjax' => true]
]); ?>

...

   <?php ActiveForm::end(); ?>
<?php yii\widgets\Pjax::end() ?>
</code>

----
===== Własne akcje w formularzu =====
Zależnie od tego czy tworzymy nowy rekord //(isNewRecord = true)// czy modyfikujemy istniejący
<code php>
if($model->isNewRecord){
        $action = 'kontroler/createakcja/';
    } else {
        $action = 'kontroler/updateakcja/';
    }
    $form = ActiveForm::begin([
                'action' => [$action . $id],
          ...
</code>

----
===== Tablice dni, godzin i minut =====

W formularzu potrzebne są czasami tablice dni godzin i minut do list wyboru.
<code php>
$dni_tygodnia = ['1' => 'Poniedziałek', '2' => 'Wtorek', '3' => 'Środa',
'4' => 'Czwartek', '5' => 'Piątek', '6' => 'Sobota', '7' => 'Niedziela'];
</code>
Godziny od 07 do 21
<code php>
$godziny = array_map(function($n) { 
           return sprintf('%02d', $n); 
        }, array_combine(range(7, 21), range(7, 21)) );
</code>
wynik:
<code php>
$godziny[7] = '07'
...
</code>
Minuty od 0 do 55 co 5
<code php>
$minuty = array_map(function($n) { 
          return sprintf('%02d', $n); 
       },array_combine(range(0, 55, 5), range(0, 55, 5)));
</code>
wynik:
<code php>
$minuty[0] = '00';
$minuty[5] = '05';
$minuty[10] = '10';
...   
</code>   

===== Formularz niezapisany JS =====
JavaScript - podświetla na żółto zmienione pola i pokazuje przycisk SUBMIT (id="sub")
<code js>
    $('#sub').hide();
    $('form :input').change(function() {
        $(this).addClass('bg-warning');
         $('#sub').show();
    });
</code>

===== Datepicker =====

<code php>
use yii\jui\DatePicker;
...
$form->field($model, 'data_urodzenia')->widget(DatePicker::classname(), [
                    'language' => 'pl',
                    'dateFormat' => 'yyyy-MM-dd',
                    'clientOptions' =>[
                        'changeMonth'=> true,
                        'changeYear'=> true,
                        'yearRange'=>'1950:2099',
                        ]
                ])->label('Data urodzenia');
</code>