Merge pull request #7663 from getkirby/forms/empty-value

refact: New ::emptyValue and ::fillWithEmptyValue methods for Field and FieldClass

Author: bastianallgeier

config/fields/checkboxes.php

@@ -50,6 +50,11 @@
 			return $this->sanitizeOptions($this->value);
 		},
 	],
+	'methods' => [
+		'emptyValue' => function () {
+			return [];
+		}
+	],
 	'save' => function ($value): string {
 		return A::join($value, ', ');
 	},

config/fields/color.php

@@ -106,6 +106,9 @@
 		}
 	],
 	'methods' => [
+		'emptyValue' => function () {
+			return '';
+		},
 		'isColor' => function (string $value): bool {
 			return
 				$this->isHex($value) ||

config/fields/mixins/datetime.php

@@ -12,6 +12,9 @@
 		}
 	],
 	'methods' => [
+		'emptyValue' => function () {
+			return '';
+		},
 		'toDatetime' => function ($value, string $format = 'Y-m-d H:i:s') {
 			if ($date = Date::optional($value)) {
 				if ($this->step) {

config/fields/mixins/picker.php

@@ -90,4 +90,9 @@
 			return $text;
 		},
 	],
+	'methods' => [
+		'emptyValue' => function () {
+			return [];
+		}
+	]
 ];

config/fields/number.php

@@ -30,11 +30,11 @@
 		'step' => function ($step = null): float|string {
 			return match ($step) {
 				'any'   => 'any',
-				default => $this->toNumber($step) ?? ''
+				default => $this->toNumber($step) ?? $this->emptyValue()
 			};
 		},
 		'value' => function ($value = null) {
-			return $this->toNumber($value) ?? '';
+			return $this->toNumber($value) ?? $this->emptyValue();
 		}
 	],
 	'computed' => [
@@ -45,10 +45,13 @@
 				$default = $this->model()->toString($default);
 			}
 
-			return $this->toNumber($default) ?? '';
+			return $this->toNumber($default) ?? $this->emptyValue();
 		}
 	],
 	'methods' => [
+		'emptyValue' => function () {
+			return '';
+		},
 		'toNumber' => function ($value): float|null {
 			if ($this->isEmptyValue($value) === true) {
 				return null;

config/fields/radio.php

@@ -26,5 +26,10 @@
 		'value' => function () {
 			return $this->sanitizeOption($this->value) ?? '';
 		}
+	],
+	'methods' => [
+		'emptyValue' => function () {
+			return '';
+		}
 	]
 ];

config/fields/structure.php

@@ -164,6 +164,9 @@
 		}
 	],
 	'methods' => [
+		'emptyValue' => function () {
+			return [];
+		},
 		'rows' => function ($value) {
 			$rows  = Data::decode($value, 'yaml');
 			$value = [];

config/fields/tags.php

@@ -77,6 +77,9 @@
 		}
 	],
 	'methods' => [
+		'emptyValue' => function () {
+			return [];
+		},
 		'toValues' => function ($value) {
 			if (is_null($value) === true) {
 				return [];

config/fields/text.php

@@ -103,6 +103,9 @@
 				},
 			];
 		},
+		'emptyValue' => function () {
+			return '';
+		}
 	],
 	'validations' => [
 		'minlength',

config/fields/textarea.php

@@ -113,6 +113,11 @@
 			]
 		];
 	},
+	'methods' => [
+		'emptyValue' => function () {
+			return '';
+		}
+	],
 	'validations' => [
 		'minlength',
 		'maxlength'