#2027 make the sorting bottom sheet clearer to use

Author: sds100

CHANGELOG.md

@@ -1,13 +1,15 @@
 ## [4.0.4](https://github.com/sds100/KeyMapper/releases/tag/v4.0.4)
 
-#### 11 February 2026
+#### TO BE RELEASED
 
 ## Added
 
 - #2024 support Expert mode on all Android versions supported by Key Mapper (8.0+).
 - #2025 add report bug button to home screen menu.
+- #2027 Make the key map sorting feature easier to understand.
 
 ## Fixed
+
 - #2030 do not filter out unknown evdev key events.
 
 ## [4.0.3](https://github.com/sds100/KeyMapper/releases/tag/v4.0.3)

base/src/main/java/io/github/sds100/keymapper/base/sorting/SortBottomSheetContent.kt

@@ -33,6 +33,7 @@ import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.rounded.ArrowDownward
 import androidx.compose.material.icons.rounded.ArrowUpward
 import androidx.compose.material.icons.rounded.DragHandle
+import androidx.compose.material.icons.rounded.HorizontalRule
 import androidx.compose.material3.Button
 import androidx.compose.material3.ButtonDefaults
 import androidx.compose.material3.Card
@@ -62,14 +63,14 @@ import androidx.compose.ui.geometry.Offset
 import androidx.compose.ui.layout.onSizeChanged
 import androidx.compose.ui.res.painterResource
 import androidx.compose.ui.res.stringResource
-import androidx.compose.ui.text.font.FontWeight
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.IntOffset
 import androidx.compose.ui.unit.dp
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import io.github.sds100.keymapper.base.R
 import io.github.sds100.keymapper.base.compose.KeyMapperTheme
+import io.github.sds100.keymapper.base.compose.LocalCustomColorsPalette
 import io.github.sds100.keymapper.base.utils.ui.compose.DraggableItem
 import io.github.sds100.keymapper.base.utils.ui.compose.rememberDragDropState
 import kotlinx.coroutines.CoroutineScope
@@ -368,7 +369,11 @@ private fun SortFieldListItem(
             Text(
                 text = sortFieldText(sortField),
                 style = if (sortOrder == SortOrder.NONE) {
-                    MaterialTheme.typography.titleMedium.copy(fontWeight = FontWeight.Normal)
+                    MaterialTheme.typography.bodyLarge.copy(
+                        color = MaterialTheme.colorScheme.onSurface.copy(
+                            alpha = 0.5f,
+                        ),
+                    )
                 } else {
                     MaterialTheme.typography.titleMedium
                 },
@@ -389,20 +394,23 @@ private fun SortFieldListItem(
                 },
                 label = "$sortField Sort Order",
             ) { sortOrder ->
-                if (sortOrder == SortOrder.NONE) {
-                    Spacer(Modifier.size(24.dp))
-                    return@AnimatedContent
-                }
-
                 val imageVector = when (sortOrder) {
-                    SortOrder.NONE -> return@AnimatedContent
+                    SortOrder.NONE -> Icons.Rounded.HorizontalRule
                     SortOrder.ASCENDING -> Icons.Rounded.ArrowUpward
                     SortOrder.DESCENDING -> Icons.Rounded.ArrowDownward
                 }
+                val tint = when (sortOrder) {
+                    SortOrder.NONE -> LocalCustomColorsPalette.current.red
+
+                    SortOrder.ASCENDING,
+                    SortOrder.DESCENDING,
+                        -> LocalCustomColorsPalette.current.green
+                }
 
                 Icon(
                     imageVector = imageVector,
                     contentDescription = null,
+                    tint = tint,
                 )
             }
         }

base/src/main/res/values/strings.xml

@@ -482,8 +482,8 @@
     <string name="dialog_message_fix_dnd_trigger_error">You will be taken to your device\'s settings page to manage which apps can modify the Do Not Disturb state. This is <b>not present on some devices</b> so tap don\'t show again if you do not see Key Mapper in the list.</string>
 
     <string name="dialog_message_sort_sort_by">Sort by</string>
-    <string name="sorting_drag_and_drop_list_help">Drag the handles to adjust priorities. The item at the top is the most important. You can also tap any item to reverse its sort order.</string>
-    <string name="sorting_drag_and_drop_list_help_example">Example: To sort key maps primarily by their Actions in ascending order and secondarily by their Triggers in descending order, move Actions to the first position and Triggers to the second.</string>
+    <string name="sorting_drag_and_drop_list_help">Drag the handles to adjust priorities. The item at the top is the most important. You must tap the item to enable sorting and toggle ascending/descending.</string>
+    <string name="sorting_drag_and_drop_list_help_example">Example: To sort by Actions (ascending) first and Triggers (descending) second: tap and drag Actions to the first position and set it to ascending, then tap and drag Triggers to the second position and set it to descending.</string>
     <string name="drag_handle_for">Drag handle for %1$s</string>
     <string name="show_example">Show example</string>