feat: Add a feature to change country display format in form

CHANGELOG.md

@@ -5,6 +5,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+- Add a feature to change country display format in form
 
 ## [3.5.0] - 2021-10-23
 

README.md

@@ -162,6 +162,12 @@ This produces the preferred choices of 'Jersey' and 'United Kingdom', and regula
 By default the `country_choices` is empty, which means all countries are included, as is `preferred_country_choices`.
 The option `country_placeholder` can be specified to create a placeholder option on above the whole list.
 
+The option `country_display_type` can be specified to change the country dropdown label format. There are two formats available :
+| display type                      | Result                 |
+| ----------------------------------| -----------------------|
+| `display_country_full` (default)  |  United Kingdom (+44)  |
+| `display_country_short`           |  GB +44                |
+
 ### Validating phone numbers
 
 ℹ️ _Using a Symfony or PHP version that does not support attributes? This bundle also supports validation as annotation.

src/Form/Type/PhoneNumberType.php

@@ -33,6 +33,9 @@ class PhoneNumberType extends AbstractType
     public const WIDGET_SINGLE_TEXT = 'single_text';
     public const WIDGET_COUNTRY_CHOICE = 'country_choice';
 
+    public const DISPLAY_COUNTRY_FULL = 'display_country_full';
+    public const DISPLAY_COUNTRY_SHORT = 'display_country_short';
+
     /**
      * {@inheritdoc}
      */
@@ -60,13 +63,15 @@ public function buildForm(FormBuilderInterface $builder, array $options)
             }
 
             $countryChoices = [];
+            $intlCountries = Countries::getNames();
 
-            foreach (Countries::getNames() as $region => $name) {
-                if (false === isset($countries[$region])) {
+            foreach ($countries as $regionCode => $countryCode) {
+                if (!isset($intlCountries[$regionCode])) {
                     continue;
                 }
 
-                $countryChoices[sprintf('%s (+%s)', $name, $countries[$region])] = $region;
+                $label = $this->formatDisplayChoice($options['country_display_type'], $intlCountries[$regionCode], $regionCode, $countryCode);
+                $countryChoices[$label] = $regionCode;
             }
 
             $transformerChoices = array_values($countryChoices);
@@ -128,6 +133,7 @@ public function configureOptions(OptionsResolver $resolver)
             'by_reference' => false,
             'error_bubbling' => false,
             'country_choices' => [],
+            'country_display_type' => self::DISPLAY_COUNTRY_FULL,
             'country_placeholder' => false,
             'preferred_country_choices' => [],
             'country_options' => [],
@@ -139,6 +145,11 @@ public function configureOptions(OptionsResolver $resolver)
             self::WIDGET_COUNTRY_CHOICE,
         ]);
 
+        $resolver->setAllowedValues('country_display_type', [
+            self::DISPLAY_COUNTRY_FULL,
+            self::DISPLAY_COUNTRY_SHORT,
+        ]);
+
         $resolver->setAllowedTypes('country_options', 'array');
         $resolver->setAllowedTypes('number_options', 'array');
     }
@@ -158,4 +169,13 @@ public function getBlockPrefix()
     {
         return 'phone_number';
     }
+
+    private function formatDisplayChoice(string $displayType, string $regionName, string $regionCode, string $countryCode): string
+    {
+        if (self::DISPLAY_COUNTRY_SHORT === $displayType) {
+            return sprintf('%s +%s', $regionCode, $countryCode);
+        }
+
+        return sprintf('%s (+%s)', $regionName, $countryCode);
+    }
 }

tests/Form/Type/PhoneNumberTypeTest.php

@@ -143,7 +143,9 @@ public function countryChoiceChoicesProvider()
         return [
             [
                 [],
-                \count(PhoneNumberUtil::getInstance()->getSupportedRegions()),
+                // 3 regions have an already used label "TA", "AC" and XK
+                // @see https://fr.wikipedia.org/wiki/ISO_3166-2#cite_note-UPU-1
+                242,
                 [
                     $this->createChoiceView('United Kingdom (+44)', 'GB'),
                 ],
@@ -167,6 +169,45 @@ public function countryChoiceChoicesProvider()
         ];
     }
 
+    /**
+     * @dataProvider countryChoiceFormatProvider
+     */
+    public function testCountryChoiceFormat(string $displayType, array $expectedChoices)
+    {
+        $options['widget'] = PhoneNumberType::WIDGET_COUNTRY_CHOICE;
+        $options['country_display_type'] = $displayType;
+        $form = $this->factory->create(PhoneNumberType::class, null, $options);
+
+        $view = $form->createView();
+        $choices = $view['country']->vars['choices'];
+
+        foreach ($expectedChoices as $expectedChoice) {
+            $this->assertContainsEquals($expectedChoice, $choices);
+        }
+    }
+
+    /**
+     * 0 => Display type
+     * 2 => Expected choices.
+     */
+    public function countryChoiceFormatProvider()
+    {
+        return [
+            [
+                PhoneNumberType::DISPLAY_COUNTRY_FULL,
+                [
+                    $this->createChoiceView('United Kingdom (+44)', 'GB'),
+                ],
+            ],
+            [
+                PhoneNumberType::DISPLAY_COUNTRY_SHORT,
+                [
+                    $this->createChoiceView('GB +44', 'GB'),
+                ],
+            ],
+        ];
+    }
+
     /**
      * @dataProvider countryChoicePlaceholderProvider
      *