addSubmit() added $onSubmit parameter

Author: dg

src/Forms/Container.php

@@ -561,10 +561,19 @@ public function addColor(string $name, string|Stringable|null $label = null): Co
 
 	/**
 	 * Adds button used to submit form.
+	 * @param (\Closure(Controls\SubmitButton, mixed[]|object): void | \Closure(static, mixed[]|object): void | \Closure(mixed[]|object): void)  $onSubmit
 	 */
-	public function addSubmit(string $name, string|Stringable|null $caption = null): Controls\SubmitButton
+	public function addSubmit(
+		string $name,
+		string|Stringable|null $caption = null,
+		?\Closure $onSubmit = null,
+	): Controls\SubmitButton
 	{
-		return $this[$name] = new Controls\SubmitButton($caption);
+		$control = $this[$name] = new Controls\SubmitButton($caption);
+		if ($onSubmit) {
+			$control->onClick[] = $onSubmit;
+		}
+		return $control;
 	}
 
 

tests/Forms/Forms.onClick.phpt

@@ -104,3 +104,23 @@ test('invalid submission due to validation', function () {
 	$form->fireEvents();
 	Assert::same(['invalidClick', 'error', 'submit'], $called);
 });
+
+
+test('addSubmit() with $onSubmit parameter', function () {
+	$_SERVER['REQUEST_METHOD'] = 'POST';
+	$_POST = ['btn' => ''];
+
+	$called = [];
+	$form = new Form;
+	$form->allowCrossOrigin();
+	$form->addText('name');
+	$form->addSubmit('btn', null, function (SubmitButton $button) use (&$called) {
+		$called[] = 'click';
+	});
+
+	$form->onSuccess[] = function (Form $form) use (&$called) {
+		$called[] = 'success';
+	};
+	$form->fireEvents();
+	Assert::same(['click', 'success'], $called);
+});