API Rename FormField Value to getFormattedValue

src/Forms/CheckboxField.php

@@ -21,7 +21,7 @@ public function dataValue()
         return ($this->value) ? 1 : null;
     }
 
-    public function Value()
+    public function getValue(): mixed
     {
         return ($this->value) ? 1 : 0;
     }
@@ -39,7 +39,7 @@ public function getAttributes()
         return array_merge(
             $attributes,
             [
-                'checked' => ($this->Value()) ? 'checked' : null,
+                'checked' => ($this->getValue()) ? 'checked' : null,
                 'type' => 'checkbox',
             ]
         );

src/Forms/CheckboxField_Readonly.php

@@ -13,7 +13,7 @@ public function performReadonlyTransformation()
         return clone $this;
     }
 
-    public function Value()
+    public function getFormattedValue(): string
     {
         return $this->value ?
             _t('SilverStripe\\Forms\\CheckboxField.YESANSWER', 'Yes') :

src/Forms/ConfirmedPasswordField.php

@@ -204,7 +204,7 @@ public function Field($properties = [])
         }
 
         // Check if the field should be visible up front
-        $visible = $this->hiddenField->Value();
+        $visible = $this->hiddenField->getValue();
         $classes = $visible
             ? 'showOnClickContainer'
             : 'showOnClickContainer d-none';
@@ -418,7 +418,7 @@ public function setName($name)
     public function isSaveable()
     {
         return !$this->showOnClick
-            || ($this->showOnClick && $this->hiddenField && $this->hiddenField->Value());
+            || ($this->showOnClick && $this->hiddenField && $this->hiddenField->getValue());
     }
 
     public function validate(): ValidationResult
@@ -432,10 +432,10 @@ public function validate(): ValidationResult
 
             $this->getPasswordField()->setValue($this->value);
             $this->getConfirmPasswordField()->setValue($this->confirmValue);
-            $value = $this->getPasswordField()->Value();
+            $value = $this->getPasswordField()->getValue();
 
             // both password-fields should be the same
-            if ($value != $this->getConfirmPasswordField()->Value()) {
+            if ($value != $this->getConfirmPasswordField()->getValue()) {
                 $result->addFieldError(
                     $name,
                     _t('SilverStripe\\Forms\\Form.VALIDATIONPASSWORDSDONTMATCH', "Passwords don't match"),
@@ -446,7 +446,7 @@ public function validate(): ValidationResult
 
             if (!$this->canBeEmpty) {
                 // both password-fields shouldn't be empty
-                if (!$value || !$this->getConfirmPasswordField()->Value()) {
+                if (!$value || !$this->getConfirmPasswordField()->getValue()) {
                     $result->addFieldError(
                         $name,
                         _t('SilverStripe\\Forms\\Form.VALIDATIONPASSWORDSNOTEMPTY', "Passwords can't be empty"),

src/Forms/DateField.php

@@ -343,7 +343,7 @@ public function setValue($value, $data = null)
         return $this;
     }
 
-    public function Value()
+    public function getFormattedValue(): string
     {
         return $this->internalToFrontend($this->value);
     }

src/Forms/DateField_Disabled.php

@@ -39,7 +39,7 @@ public function Field($properties = [])
                 // Render the display value with some complement of info
                 $displayValue = Convert::raw2xml(sprintf(
                     $format ?? '',
-                    $this->Value(),
+                    $this->getFormattedValue(),
                     $infoComplement
                 ));
             }

src/Forms/DatetimeField.php

@@ -362,7 +362,7 @@ public function setValue($value, $data = null)
      *
      * @return string
      */
-    public function Value()
+    public function getFormattedValue(): string
     {
         return $this->internalToFrontend($this->value);
     }

src/Forms/DropdownField.php

@@ -97,7 +97,7 @@ class DropdownField extends SingleSelectField
     protected function getFieldOption($value, $title)
     {
         // Check selection
-        $selected = $this->isSelectedValue($value, $this->Value());
+        $selected = $this->isSelectedValue($value, $this->getValue());
 
         // Check disabled
         $disabled = false;

src/Forms/FileField.php

@@ -172,7 +172,7 @@ public function saveInto(DataObjectInterface $record)
         }
     }
 
-    public function Value()
+    public function getValue(): mixed
     {
         return isset($_FILES[$this->getName()]) ? $_FILES[$this->getName()] : null;
     }

src/Forms/FileUploadReceiver.php

@@ -237,11 +237,11 @@ public function getItems()
      */
     public function getItemIDs()
     {
-        $value = $this->Value();
+        $value = $this->getValue();
         return empty($value['Files']) ? [] : $value['Files'];
     }
 
-    public function Value()
+    public function getValue()
     {
         // Re-override FileField Value to use data value
         return $this->dataValue();

src/Forms/FormField.php

@@ -457,10 +457,8 @@ public function getValue(): mixed
     /**
      * Returns the value of the field which may be modified for display purposes
      * for instance to add localisation or formatting.
-     *
-     * @return mixed
      */
-    public function Value()
+    public function getFormattedValue(): string
     {
         return $this->value;
     }
@@ -668,7 +666,7 @@ protected function getDefaultAttributes(): array
         $attributes = [
             'type' => $this->getInputType(),
             'name' => $this->getName(),
-            'value' => $this->Value(),
+            'value' => $this->getFormattedValue(),
             'class' => $this->extraClass(),
             'id' => $this->ID(),
             'disabled' => $this->isDisabled(),
@@ -1554,7 +1552,7 @@ public function getSchemaStateDefaults()
         $state = [
             'name' => $this->getName(),
             'id' => $this->ID(),
-            'value' => $this->Value(),
+            'value' => $this->getFormattedValue(),
             'message' => $this->getSchemaMessage(),
             'data' => [],
         ];

src/Forms/GridField/GridField.php

@@ -485,7 +485,7 @@ private function addStateFromRequest(): void
             // Create a dummy state so that we can merge the current state with the request state.
             $newState = new GridState($this, $stateStr);
             // Put the current state on top of the request state.
-            $newState->setValue($oldState->Value());
+            $newState->setValue($oldState->getValue());
             $this->state = $newState;
         }
     }

src/Forms/GridField/GridFieldStateManager.php

@@ -39,7 +39,7 @@ public function getStateKey(GridField $gridField): string
     public function addStateToURL(GridField $gridField, string $url): string
     {
         $key = $this->getStateKey($gridField);
-        $value = $gridField->getState(false)->Value();
+        $value = $gridField->getState(false)->getValue();
 
         // Using a JSON-encoded empty array as the blank value, to avoid changing Value() semantics in a minor release
         if ($value === '{}') {

src/Forms/GridField/GridState.php

@@ -101,10 +101,8 @@ public function getList()
 
     /**
      * Returns a json encoded string representation of this state.
-     *
-     * @return string
      */
-    public function Value()
+    public function getValue(): string
     {
         $data = $this->data ? $this->data->getChangesArray() : [];
         return json_encode($data, JSON_FORCE_OBJECT);
@@ -117,7 +115,7 @@ public function Value()
      */
     public function dataValue()
     {
-        return $this->Value();
+        return $this->getValue();
     }
 
     /**
@@ -126,11 +124,11 @@ public function dataValue()
      */
     public function attrValue()
     {
-        return Convert::raw2att($this->Value());
+        return Convert::raw2att($this->getValue());
     }
 
     public function __toString()
     {
-        return $this->Value();
+        return $this->getValue();
     }
 }

src/Forms/HTMLEditor/HTMLEditorField.php

@@ -134,7 +134,7 @@ public function saveInto(DataObjectInterface $record)
         }
 
         // Sanitise if requested
-        $htmlValue = HTMLValue::create($this->Value());
+        $htmlValue = HTMLValue::create($this->getValue());
         if (HTMLEditorField::config()->sanitise_server_side) {
             $config = $this->getEditorConfig();
             $santiser = HTMLEditorSanitiser::create($config);
@@ -200,7 +200,7 @@ public function ValueEntities()
             // Don't apply double encoding to ampersand
             $doubleEncoding = $matches[0] != '&';
             return htmlentities($matches[0], ENT_COMPAT, 'UTF-8', $doubleEncoding);
-        }, $this->Value() ?? '');
+        }, $this->getValue() ?? '');
 
         return $value;
     }
@@ -231,7 +231,7 @@ private function usesXmlFriendlyField(DataObjectInterface $record): bool
         }
 
         $castingService = CastingService::singleton();
-        $castValue = $castingService->cast($this->Value(), $record, $this->getName());
+        $castValue = $castingService->cast($this->getValue(), $record, $this->getName());
         return $castValue instanceof DBField && $castValue::config()->get('escape_type') === 'xml';
     }
 }

src/Forms/HTMLReadonlyField.php

@@ -33,6 +33,6 @@ public function Field($properties = [])
      */
     public function ValueEntities()
     {
-        return htmlentities($this->Value() ?? '', ENT_COMPAT, 'UTF-8');
+        return htmlentities($this->getFormattedValue() ?? '', ENT_COMPAT, 'UTF-8');
     }
 }

src/Forms/ListboxField.php

@@ -252,7 +252,7 @@ protected function getOptionsArray($term)
 
     public function getValueArray()
     {
-        $value = $this->Value();
+        $value = $this->getValue();
         $validValues = $this->getValidValues();
         if (empty($validValues)) {
             return [];

src/Forms/MoneyField.php

@@ -219,7 +219,7 @@ public function dataValue()
         return $this->getDBMoney()->getValue();
     }
 
-    public function Value()
+    public function getFormattedValue(): string
     {
         // Localised money
         return $this->getDBMoney()->Nice();

src/Forms/MultiSelectField.php

@@ -39,7 +39,7 @@ abstract class MultiSelectField extends SelectField
      */
     public function getValueArray()
     {
-        return $this->getListValues($this->Value());
+        return $this->getListValues($this->getValue());
     }
 
     /**

src/Forms/NullableField.php

@@ -17,7 +17,7 @@
  * When a form is submitted the field tests the value of the "is null" checkbox and sets its value
  * accordingly. You can retrieve the value of the wrapped field from the NullableField as follows:
  *
- * $field->Value() or $field->dataValue()
+ * $field->getValue() or $field->dataValue()
  *
  * You can specify the label to use for the "is null" checkbox. If you want to use i18n for this
  * label then specify it like this:
@@ -61,7 +61,7 @@ public function __construct(FormField $valueField, $isNullLabel = null)
         parent::__construct(
             $valueField->getName(),
             $valueField->Title(),
-            $valueField->Value()
+            $valueField->getValue()
         );
 
         $this->setForm($valueField->getForm());

src/Forms/NumericField.php

@@ -169,7 +169,7 @@ public function setSubmittedValue($value, $data = null)
      *
      * @return string
      */
-    public function Value()
+    public function getFormattedValue(): string
     {
         // Show invalid value back to user in case of error
         if ($this->value === null || $this->value === false) {

src/Forms/OptionsetField.php

@@ -75,7 +75,7 @@ protected function getFieldOption($value, $title, $odd)
             'Name' => $this->getOptionName(),
             'Value' => $value,
             'Title' => $title,
-            'isChecked' => $this->isSelectedValue($value, $this->Value()),
+            'isChecked' => $this->isSelectedValue($value, $this->getValue()),
             'isDisabled' => $this->isDisabledValue($value)
         ]);
     }

src/Forms/ReadonlyField.php

@@ -79,7 +79,7 @@ public function getSchemaStateDefaults()
     /**
      * @return mixed|string
      */
-    public function Value()
+    public function getFormattedValue(): string
     {
         // Get raw value
         $value = $this->dataValue();

src/Forms/SearchableDropdownTrait.php

@@ -319,7 +319,7 @@ public function getAttributes(): array
      */
     public function getValueArray(): array
     {
-        $value = $this->Value();
+        $value = $this->getValue();
         if (empty($value)) {
             return [];
         }
@@ -474,7 +474,7 @@ private function getDefaultSchemaValue()
         if (!$this->getIsLazyLoaded() && $this->hasMethod('getDefaultValue')) {
             return $this->getDefaultValue();
         }
-        return $this->Value();
+        return $this->getValue();
     }
 
     private function getOptionsForSearchRequest(string $term): array

src/Forms/SingleLookupField.php

@@ -83,7 +83,7 @@ public function Type()
      *
      * @return mixed
      */
-    public function Value()
+    public function getFormattedValue(): string
     {
         $label = $this->valueToLabel();
         if (!is_null($label)) {

src/Forms/SingleSelectField.php

@@ -58,7 +58,7 @@ public function getValueForValidation(): mixed
 
     public function getDefaultValue()
     {
-        $value = $this->Value();
+        $value = $this->getValue();
         $validValues = $this->getValidValues();
         // assign value to field, such as first option available
         if ($value === null || !in_array($value, $validValues)) {

src/Forms/TextareaField.php

@@ -192,6 +192,6 @@ public function getSchemaValidation()
      */
     public function ValueEntities()
     {
-        return htmlentities($this->Value() ?? '', ENT_COMPAT, 'UTF-8');
+        return htmlentities($this->getFormattedValue() ?? '', ENT_COMPAT, 'UTF-8');
     }
 }

src/Forms/TimeField.php

@@ -280,7 +280,7 @@ public function setValue($value, $data = null)
         return $this;
     }
 
-    public function Value()
+    public function getFormattedValue(): string
     {
         $localised = $this->internalToFrontend($this->value);
         if ($localised) {

src/Forms/TreeDropdownField.php

@@ -865,7 +865,7 @@ public function getSchemaStateDefaults()
     {
         $data = parent::getSchemaStateDefaults();
         /** @var Hierarchy|DataObject $record */
-        $record = $this->Value() ? $this->objectForKey($this->Value()) : null;
+        $record = $this->getValue() ? $this->objectForKey($this->getValue()) : null;
 
         $data['data']['cacheKey'] = $this->getCacheKey();
         $data['data']['showSelectedPath'] = $this->getShowSelectedPath();

src/Forms/TreeMultiselectField.php

@@ -121,7 +121,7 @@ public function getSchemaStateDefaults()
      */
     public function getItems()
     {
-        $value = $this->Value();
+        $value = $this->getValue();
 
         // If unchanged, load from record
         if ($value === 'unchanged') {

templates/SilverStripe/Forms/CheckboxSetField.ss

@@ -2,7 +2,7 @@
 	<% if $Options.Count %>
 		<% loop $Options %>
 			<li class="$Class" role="$Role">
-				<input id="$ID" class="checkbox" name="$Name" type="checkbox" value="$Value.ATT"<% if $isChecked %> checked="checked"<% end_if %><% if $isDisabled %> disabled="disabled"<% end_if %> />
+				<input id="$ID" class="checkbox" name="$Name" type="checkbox" value="$FormattedValue.ATT"<% if $isChecked %> checked="checked"<% end_if %><% if $isDisabled %> disabled="disabled"<% end_if %> />
 				<label for="$ID">$Title</label>
 			</li>
 		<% end_loop %>