add content description to navigation tabs

Author: Razeeman

features/feature_main/src/main/java/com/example/util/simpletimetracker/feature_main/provider/MainTabsProvider.kt

@@ -2,6 +2,7 @@ package com.example.util.simpletimetracker.feature_main.provider
 
 import androidx.annotation.DrawableRes
 import com.example.util.simpletimetracker.core.model.NavigationTab
+import com.example.util.simpletimetracker.core.repo.ResourceRepo
 import com.example.util.simpletimetracker.core.utils.SHORTCUT_NAVIGATION_RECORDS
 import com.example.util.simpletimetracker.core.utils.SHORTCUT_NAVIGATION_SETTINGS
 import com.example.util.simpletimetracker.core.utils.SHORTCUT_NAVIGATION_STATISTICS
@@ -12,6 +13,7 @@ import kotlinx.coroutines.runBlocking
 import javax.inject.Inject
 
 class MainTabsProvider @Inject constructor(
+    private val resourceRepo: ResourceRepo,
     private val prefsInteractor: PrefsInteractor,
 ) {
 
@@ -33,23 +35,39 @@ class MainTabsProvider @Inject constructor(
             .let(::mapToIcon)
     }
 
+    fun mapPositionToDescription(position: Int): String? {
+        return position
+            .let(::mapPositionToTab)
+            .let(::mapToDescription)
+    }
+
     fun mapNavigationToPosition(value: String): Int? {
         return mapNavigationToTab(value)?.let(::mapTabToPosition)
     }
 
     @DrawableRes
-    fun mapToIcon(tab: NavigationTab?): Int {
-        if (tab == null) return R.drawable.unknown
-
+    private fun mapToIcon(tab: NavigationTab?): Int {
         return when (tab) {
             NavigationTab.RunningRecords -> R.drawable.tab_running_records
             NavigationTab.Records -> R.drawable.tab_records
             NavigationTab.Statistics -> R.drawable.tab_statistics
             NavigationTab.Settings -> R.drawable.tab_settings
             NavigationTab.Goals -> R.drawable.tab_goals
+            null -> R.drawable.unknown
         }
     }
 
+    private fun mapToDescription(tab: NavigationTab?): String? {
+        return when (tab) {
+            NavigationTab.RunningRecords -> R.string.shortcut_navigation_timers
+            NavigationTab.Records -> R.string.shortcut_navigation_records
+            NavigationTab.Statistics -> R.string.shortcut_navigation_statistics
+            NavigationTab.Settings -> R.string.shortcut_navigation_settings
+            NavigationTab.Goals -> R.string.change_record_type_goal_time_hint
+            null -> return null
+        }.let(resourceRepo::getString)
+    }
+
     private fun mapNavigationToTab(value: String): NavigationTab? {
         return when (value) {
             SHORTCUT_NAVIGATION_RECORDS -> NavigationTab.Records

features/feature_main/src/main/java/com/example/util/simpletimetracker/feature_main/view/MainFragment.kt

@@ -98,7 +98,10 @@ class MainFragment : BaseFragment<Binding>() {
         }
 
         TabLayoutMediator(mainTabs, mainPager) { tab, position ->
-            position.let(mainTabsProvider::mapPositionToIcon).let(tab::setIcon)
+            position.let(mainTabsProvider::mapPositionToIcon)
+                .let(tab::setIcon)
+            position.let(mainTabsProvider::mapPositionToDescription)
+                ?.let { tab.contentDescription = it }
             tab.icon?.colorFilter = if (position == mainPagePosition) {
                 selectedColorFilter
             } else {

resources/src/main/res/values-ar/strings.xml

@@ -656,6 +656,7 @@
     <string name="imageGroupToggle">وصلة</string>
 
     <!--  Shortcuts  -->
+    <string name="shortcut_navigation_timers">المؤقتات</string>
     <string name="shortcut_navigation_records">المتتبعات</string>
     <string name="shortcut_navigation_statistics">اﻹحصائيات</string>
     <string name="shortcut_navigation_settings">اﻹعدادات</string>

resources/src/main/res/values-ca/strings.xml

@@ -656,6 +656,7 @@ Exemple:<br/>
     <string name="imageGroupToggle">Botons</string>
 
     <!--  Shortcuts  -->
+    <string name="shortcut_navigation_timers">Temporitzadors</string>
     <string name="shortcut_navigation_records">Enregistraments</string>
     <string name="shortcut_navigation_statistics">Estadístiques</string>
     <string name="shortcut_navigation_settings">Configuració</string>

resources/src/main/res/values-de/strings.xml

@@ -656,6 +656,7 @@ Beispiel:<br/>
     <string name="imageGroupToggle">Umschalten</string>
 
     <!--  Shortcuts  -->
+    <string name="shortcut_navigation_timers">Timer</string>
     <string name="shortcut_navigation_records">Einträge</string>
     <string name="shortcut_navigation_statistics">Statistiken</string>
     <string name="shortcut_navigation_settings">Einstellungen</string>

resources/src/main/res/values-es/strings.xml

@@ -656,6 +656,7 @@ Ejemplo:<br/>
     <string name="imageGroupToggle">Conexiónes</string>
 
     <!--  Shortcuts  -->
+    <string name="shortcut_navigation_timers">Temporizadores</string>
     <string name="shortcut_navigation_records">Registros</string>
     <string name="shortcut_navigation_statistics">Estadísticas</string>
     <string name="shortcut_navigation_settings">Ajustes</string>

resources/src/main/res/values-fa/strings.xml

@@ -656,6 +656,7 @@
     <string name="imageGroupToggle">تغییر وضع</string>
 
     <!--  Shortcuts  -->
+    <string name="shortcut_navigation_timers">تایمرها</string>
     <string name="shortcut_navigation_records">تاریخچه ها</string>
     <string name="shortcut_navigation_statistics">آمار ها</string>
     <string name="shortcut_navigation_settings">تنظیمات</string>

resources/src/main/res/values-fr/strings.xml

@@ -656,6 +656,7 @@ Exemple:<br/>
     <string name="imageGroupToggle">Basculer</string>
 
     <!--  Shortcuts  -->
+    <string name="shortcut_navigation_timers">Minuteries</string>
     <string name="shortcut_navigation_records">Enregistrements</string>
     <string name="shortcut_navigation_statistics">Statistiques</string>
     <string name="shortcut_navigation_settings">Réglages</string>

resources/src/main/res/values-hi/strings.xml

@@ -656,6 +656,7 @@ csv फ़ाइल में कॉमा से अलग किए गए य
     <string name="imageGroupToggle">टॉगल</string>
 
     <!--  Shortcuts  -->
+    <string name="shortcut_navigation_timers">टाइमर</string>
     <string name="shortcut_navigation_records">अभिलेख</string>
     <string name="shortcut_navigation_statistics">आंकड़े</string>
     <string name="shortcut_navigation_settings">सेटिंग</string>

resources/src/main/res/values-in/strings.xml

@@ -656,6 +656,7 @@ Contoh:<br/>
     <string name="imageGroupToggle">Beralih</string>
 
     <!--  Shortcuts  -->
+    <string name="shortcut_navigation_timers">Timer</string>
     <string name="shortcut_navigation_records">Rekor</string>
     <string name="shortcut_navigation_statistics">Statistik</string>
     <string name="shortcut_navigation_settings">Pengaturan</string>