[DOCS] Properly use siteLanguage(“locale”) expression as object

The examples in the documentation now show
that you have to work with the locale object.

Resolves: #106317
Resolves: #106901
Releases: main, 13.4, 12.4
Change-Id: Ie2894189096525593ac7424e01b82569439883d3
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/90080
Tested-by: Torben Hansen <derhansen@gmail.com>
Reviewed-by: Garvin Hicking <garvin@hick.ing>
Tested-by: core-ci <typo3@b13.com>
Tested-by: Garvin Hicking <garvin@hick.ing>
Reviewed-by: Torben Hansen <derhansen@gmail.com>

Author: brosua

typo3/sysext/form/Documentation/I/Concepts/Variants/Index.rst

@@ -248,7 +248,7 @@ The most needed ones are for sure:
 
 For example:
 
-:yaml:`siteLanguage("locale") == "de_DE"`.
+:yaml:`siteLanguage("locale").getName() == "de-DE"`.
 
 
 ``applicationContext`` (string)
@@ -327,7 +327,7 @@ the frontend language.
    variants:
      -
        identifier: language-variant-1
-       condition: 'siteLanguage("locale") == "en_US.UTF-8"'
+       condition: 'siteLanguage("locale").getName() == "en-US"'
        label: Contact form
        renderingOptions:
          submitButtonLabel: Submit
@@ -342,7 +342,7 @@ the frontend language.
        variants:
          -
            identifier: language-variant-1
-           condition: 'siteLanguage("locale") == "en_US.UTF-8"'
+           condition: 'siteLanguage("locale").getName() == "en-US"'
            label: Contact data
            renderingOptions:
              previousButtonLabel: Previous step
@@ -358,7 +358,7 @@ the frontend language.
            variants:
              -
                identifier: language-variant-1
-               condition: 'siteLanguage("locale") == "en_US.UTF-8"'
+               condition: 'siteLanguage("locale").getName() == "en-US"'
                label: Full name
                properties:
                  fluidAdditionalAttributes:
@@ -619,7 +619,7 @@ In this example a select option is removed for a specific locale.
            variants:
              -
                identifier: salutation-variant
-               condition: 'siteLanguage("locale") == "zh_CN.utf-8"'
+               condition: 'siteLanguage("locale").getName() == "zh-CN"'
                properties:
                  options:
                    miss: __UNSET