Better translation icon tooltips

resolves #2808

CHANGELOG-v3.md

@@ -3,6 +3,7 @@
 ## Unreleased
 
 ### Changed
+- Fields’ translation icons now reveal the chosen Translation Method in their tooltip. ([#2808](https://github.com/craftcms/cms/issues/2808))
 - Improved the error messages displayed when an Assets field has an invalid Upload Location setting. ([#2803](https://github.com/craftcms/cms/issues/2803))
 
 ### Fixed

src/templates/_includes/field.html

@@ -7,6 +7,17 @@
 {% set translatable = field.getIsTranslatable(element) %}
 {% set siteId = (translatable and (element.isLocalized() ?? true)) ? (siteId ?? element.siteId ?? craft.app.sites.currentSite.id) %}
 
+{% if translatable %}
+    {% switch field.translationMethod %}
+    {% case 'site' %}
+        {% set translationDescription = 'This field is translated for each site.'|t('app') %}
+    {% case 'siteGroup' %}
+        {% set translationDescription = 'This field is translated for each site group.'|t('app') %}
+    {% case 'language' %}
+        {% set translationDescription = 'This field is translated for each language.'|t('app') %}
+    {% endswitch %}
+{% endif %}
+
 {% if not static %}
     {% set input = field.getInputHtml(value, element) %}
 {% else %}
@@ -17,6 +28,7 @@
     {% embed "_includes/forms/field" with {
         label: field.name|t('site')|e,
         translatable: translatable,
+        translationDescription: translationDescription ?? null,
         siteId: siteId,
         required: (not static ? required : false),
         instructions: instructions|e,

src/templates/_includes/forms/field.html

@@ -23,7 +23,7 @@
             {% if label %}
                 <label {% if labelId %} id="{{ labelId }}"{% endif %}{% if required is defined and required %} class="required"{% endif %}{% if id is defined and id %} for="{{ id }}"{% endif %}>
                     {{- label|raw -}}
-                    {%- if translatable %} <span class="extralight" data-icon="language" title="{{ 'This field is translatable.'|t('app') }}"></span>{% endif -%}
+                    {%- if translatable %} <span class="extralight" data-icon="language" title="{{ translationDescription ?? 'This field is translatable.'|t('app') }}"></span>{% endif -%}
                 </label>
             {% endif %}
             {% if instructions %}