Allow optional jQuery in Validators and Widgets.

framework/base/Application.php

@@ -1,4 +1,5 @@
 <?php
+
 /**
  * @link https://www.yiiframework.com/
  * @copyright Copyright (c) 2008 Yii Software LLC
@@ -182,7 +183,16 @@ abstract class Application extends Module
      * @var array list of loaded modules indexed by their class names.
      */
     public $loadedModules = [];
-
+    /**
+     * Indicates whether jQuery should be used for client-side validation and widgets.
+     *
+     * When enabled, jQuery assets will be registered for validators and widgets that require it.
+     *
+     * Set to `false` to disable automatic jQuery inclusion for these features.
+     *
+     * @since 2.2.0
+     */
+    public bool $useJquery = true;
 
     /**
      * Constructor.

framework/console/Application.php

@@ -1,4 +1,5 @@
 <?php
+
 /**
  * @link https://www.yiiframework.com/
  * @copyright Copyright (c) 2008 Yii Software LLC
@@ -78,7 +79,15 @@ class Application extends \yii\base\Application
      * @var Controller the currently active controller instance
      */
     public $controller;
-
+    /**
+     * Whether to enable jQuery integration for the console application.
+     *
+     * This property is reserved for future compatibility. Console applications do not utilize jQuery, but this flag is
+     * provided for configuration consistency with web applications.
+     *
+     * @since 2.2.0
+     */
+    public bool $useJquery = false;
 
     /**
      * {@inheritdoc}

framework/grid/CheckboxColumn.php

@@ -1,4 +1,5 @@
 <?php
+
 /**
  * @link https://www.yiiframework.com/
  * @copyright Copyright (c) 2008 Yii Software LLC
@@ -8,9 +9,12 @@
 namespace yii\grid;
 
 use Closure;
+use Yii;
 use yii\base\InvalidConfigException;
 use yii\helpers\Html;
 use yii\helpers\Json;
+use yii\jquery\grid\CheckboxColumnJqueryClientScript;
+use yii\web\client\ClientScriptInterface;
 
 /**
  * CheckboxColumn displays a column of checkboxes in a grid view.
@@ -74,7 +78,10 @@ class CheckboxColumn extends Column
      * @since 2.0.9
      */
     public $cssClass;
-
+    /**
+     * Client script class to use for client-side validation.
+     */
+    public array|ClientScriptInterface|null $clientScript = null;
 
     /**
      * {@inheritdoc}
@@ -90,6 +97,11 @@ public function init()
             $this->name .= '[]';
         }
 
+        if (Yii::$app->useJquery && !$this->clientScript instanceof ClientScriptInterface) {
+            $this->clientScript ??= ['class' => CheckboxColumnJqueryClientScript::class];
+            $this->clientScript = Yii::createObject($this->clientScript);
+        }
+
         $this->registerClientScript();
     }
 
@@ -139,7 +151,7 @@ protected function renderDataCellContent($model, $key, $index)
      * @return string header checkbox name
      * @since 2.0.8
      */
-    protected function getHeaderCheckBoxName()
+    public function getHeaderCheckBoxName()
     {
         $name = $this->name;
         if (substr_compare($name, '[]', -2, 2) === 0) {
@@ -160,13 +172,8 @@ protected function getHeaderCheckBoxName()
      */
     public function registerClientScript()
     {
-        $id = $this->grid->options['id'];
-        $options = Json::encode([
-            'name' => $this->name,
-            'class' => $this->cssClass,
-            'multiple' => $this->multiple,
-            'checkAll' => $this->grid->showHeader ? $this->getHeaderCheckBoxName() : null,
-        ]);
-        $this->grid->getView()->registerJs("jQuery('#$id').yiiGridView('setSelectionColumn', $options);");
+        if ($this->clientScript instanceof ClientScriptInterface) {
+            $this->clientScript->register($this, $this->grid->getView());
+        }
     }
 }

framework/grid/GridView.php

@@ -1,4 +1,5 @@
 <?php
+
 /**
  * @link https://www.yiiframework.com/
  * @copyright Copyright (c) 2008 Yii Software LLC
@@ -12,9 +13,9 @@
 use yii\base\InvalidConfigException;
 use yii\base\Model;
 use yii\helpers\Html;
-use yii\helpers\Json;
-use yii\helpers\Url;
 use yii\i18n\Formatter;
+use yii\jquery\grid\GridViewJqueryClientScript;
+use yii\web\client\ClientScriptInterface;
 use yii\widgets\BaseListView;
 
 /**
@@ -264,7 +265,10 @@ class GridView extends BaseListView
      * - `{pager}`: the pager. See [[renderPager()]].
      */
     public $layout = "{summary}\n{items}\n{pager}";
-
+    /**
+     * Client script class to use for client-side validation.
+     */
+    public array|ClientScriptInterface|null $clientScript = null;
 
     /**
      * Initializes the grid view.
@@ -285,6 +289,11 @@ public function init()
             $this->filterRowOptions['id'] = $this->options['id'] . '-filters';
         }
 
+        if (Yii::$app->useJquery && !$this->clientScript instanceof ClientScriptInterface) {
+            $this->clientScript ??= ['class' => GridViewJqueryClientScript::class];
+            $this->clientScript = Yii::createObject($this->clientScript);
+        }
+
         $this->initColumns();
     }
 
@@ -293,11 +302,10 @@ public function init()
      */
     public function run()
     {
-        $view = $this->getView();
-        GridViewAsset::register($view);
-        $id = $this->options['id'];
-        $options = Json::htmlEncode(array_merge($this->getClientOptions(), ['filterOnFocusOut' => $this->filterOnFocusOut]));
-        $view->registerJs("jQuery('#$id').yiiGridView($options);");
+        if (Yii::$app->useJquery && $this->clientScript instanceof ClientScriptInterface) {
+            $this->clientScript->register($this, $this->getView());
+        }
+
         parent::run();
     }
 
@@ -333,17 +341,11 @@ public function renderSection($name)
      */
     protected function getClientOptions()
     {
-        $filterUrl = isset($this->filterUrl) ? $this->filterUrl : Yii::$app->request->url;
-        $id = $this->filterRowOptions['id'];
-        $filterSelector = "#$id input, #$id select";
-        if (isset($this->filterSelector)) {
-            $filterSelector .= ', ' . $this->filterSelector;
+        if (Yii::$app->useJquery == false || $this->clientScript === null) {
+            return [];
         }
 
-        return [
-            'filterUrl' => Url::to($filterUrl),
-            'filterSelector' => $filterSelector,
-        ];
+        return $this->clientScript->getClientOptions($this);
     }
 
     /**

framework/jquery/grid/CheckboxColumnJqueryClientScript.php

@@ -0,0 +1,48 @@
+<?php
+
+/**
+ * @link https://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license https://www.yiiframework.com/license/
+ */
+
+declare(strict_types=1);
+
+namespace yii\jquery\grid;
+
+use yii\base\BaseObject;
+use yii\helpers\Json;
+use yii\web\client\ClientScriptInterface;
+use yii\web\View;
+
+/**
+ * CheckboxColumnJqueryClientScript provides client-side script registration for gridview checkbox columns.
+ *
+ * This class implements {@see ClientScriptInterface} to supply client-side options and register the corresponding
+ * JavaScript code for checkbox selection columns in Yii2 gridviews using jQuery.
+ *
+ * @author Wilmer Arambula <[email protected]>
+ * @since 2.2.0
+ */
+class CheckboxColumnJqueryClientScript implements ClientScriptInterface
+{
+    public function register(BaseObject $object, View $view): void
+    {
+        $id = $object->grid->options['id'];
+
+        $options = Json::encode(
+            [
+                'name' => $object->name,
+                'class' => $object->cssClass,
+                'multiple' => $object->multiple,
+                'checkAll' => $object->grid->showHeader ? $object->getHeaderCheckBoxName() : null,
+            ],
+        );
+        $view->registerJs("jQuery('#$id').yiiGridView('setSelectionColumn', $options);");
+    }
+
+    public function getClientOptions(BaseObject $object): array
+    {
+        return [];
+    }
+}

framework/jquery/grid/GridViewJqueryClientScript.php

@@ -0,0 +1,72 @@
+<?php
+
+/**
+ * @link https://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license https://www.yiiframework.com/license/
+ */
+
+declare(strict_types=1);
+
+namespace yii\jquery\grid;
+
+use Yii;
+use yii\base\BaseObject;
+use yii\grid\GridView;
+use yii\grid\GridViewAsset;
+use yii\helpers\Json;
+use yii\helpers\Url;
+use yii\web\client\ClientScriptInterface;
+use yii\web\View;
+
+use function array_merge;
+
+/**
+ * GridViewJqueryClientScript provides client-side script registration for GridView widgets using jQuery.
+ *
+ * This class implements {@see ClientScriptInterface} to supply client-side options and register the corresponding
+ * JavaScript code for GridView widgets in Yii2 applications using jQuery.
+ *
+ * @author Wilmer Arambula <[email protected]>
+ * @since 2.2.0
+ */
+class GridViewJqueryClientScript implements ClientScriptInterface
+{
+    public function getClientOptions(BaseObject $object): array
+    {
+        if (!$object instanceof GridView) {
+            return [];
+        }
+
+        $filterUrl = $object->filterUrl ?? Yii::$app->request->url;
+        $id = $object->filterRowOptions['id'];
+        $filterSelector = "#$id input, #$id select";
+
+        if (isset($object->filterSelector)) {
+            $filterSelector .= ', ' . $object->filterSelector;
+        }
+
+        return [
+            'filterUrl' => Url::to($filterUrl),
+            'filterSelector' => $filterSelector,
+        ];
+    }
+
+    public function register(BaseObject $object, View $view): void
+    {
+        $view = $object->getView();
+
+        GridViewAsset::register($view);
+
+        $id = $object->options['id'];
+
+        $options = Json::htmlEncode(
+            array_merge(
+                $this->getClientOptions($object),
+                ['filterOnFocusOut' => $object->filterOnFocusOut],
+            ),
+        );
+
+        $view->registerJs("jQuery('#$id').yiiGridView($options);");
+    }
+}

framework/jquery/validators/BooleanValidatorJqueryClientScript.php

@@ -0,0 +1,65 @@
+<?php
+
+/**
+ * @link https://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license https://www.yiiframework.com/license/
+ */
+
+declare(strict_types=1);
+
+namespace yii\jquery\validators;
+
+use yii\base\Model;
+use yii\helpers\Json;
+use yii\validators\client\ClientValidatorScriptInterface;
+use yii\validators\ValidationAsset;
+use yii\validators\Validator;
+use yii\web\View;
+
+/**
+ * BooleanValidatorJqueryClientScript provides client-side validation script generation for boolean attributes.
+ *
+ * This class implements {@see ClientValidatorScriptInterface} to supply client-side validation options and register
+ * the corresponding JavaScript code for boolean validation in Yii2 forms using jQuery.
+ *
+ * @author Wilmer Arambula <[email protected]>
+ * @since 2.2.0
+ */
+class BooleanValidatorJqueryClientScript implements ClientValidatorScriptInterface
+{
+    public function getClientOptions(Validator $validator, Model $model, string $attribute): array
+    {
+        $options = [
+            'trueValue' => $validator->trueValue,
+            'falseValue' => $validator->falseValue,
+            'message' => $validator->formatMessage(
+                $validator->message,
+                [
+                    'attribute' => $model->getAttributeLabel($attribute),
+                    'true' => $validator->trueValue === true ? 'true' : $validator->trueValue,
+                    'false' => $validator->falseValue === false ? 'false' : $validator->falseValue,
+                ],
+            ),
+        ];
+
+        if ($validator->skipOnEmpty) {
+            $options['skipOnEmpty'] = 1;
+        }
+
+        if ($validator->strict) {
+            $options['strict'] = 1;
+        }
+
+        return $options;
+    }
+
+    public function register(Validator $validator, Model $model, string $attribute, View $view): string
+    {
+        ValidationAsset::register($view);
+
+        $options = $this->getClientOptions($validator, $model, $attribute);
+
+        return 'yii.validation.boolean(value, messages, ' . Json::htmlEncode($options) . ');';
+    }
+}