Merge pull request #122 from DeveloperAcademy-POSTECH/feature/117-vo-station-detail

✨ Feature: #117 [VO] 정류장 상세 화면 VoiceOver 접근성 개선

Author: bisor0627

OffStageApp/Sources/Presentation/BusStation/BusStationView.swift

@@ -74,6 +74,8 @@ struct BusStationView: View {
                 Button(action: { router.popToRoot() }) {
                     Image(systemName: "house")
                 }
+                .accessibilityLabel("홈 화면으로 가기")
+                .accessibilityHint("홈으로 가려면 두번 탭하십시오.")
             )
 
             RefreshButton(countdown: countdown, rotationAngle: $rotationAngle) {
@@ -109,8 +111,9 @@ struct BusStationView: View {
             ActivityIndicator(isAnimating: .constant(true), style: .large)
                 .frame(maxWidth: .infinity, alignment: .center)
                 .padding(.vertical, 40)
+                .accessibilityHidden(true)
 
-        case let .success(routes):
+        case let .refreshing(routes), let .success(routes):
             if routes.isEmpty {
                 Group {
                     if viewModel.input.routes.isEmpty {

OffStageApp/Sources/Presentation/BusStation/BusStationViewModel.swift

@@ -1,11 +1,13 @@
 import BusAPI
 import Foundation
+import UIKit
 
 @MainActor
 final class BusStationViewModel: ObservableObject {
     enum ViewState {
         case idle
         case loading
+        case refreshing([RouteDetail])
         case success([RouteDetail])
         case error(Error)
     }
@@ -73,7 +75,12 @@ final class BusStationViewModel: ObservableObject {
     }
 
     func refresh() {
-        viewState = .loading
+        switch viewState {
+        case let .success(details):
+            viewState = .refreshing(details)
+        default:
+            viewState = .loading
+        }
         Task { await fetchArrivals() }
     }
 
@@ -138,9 +145,8 @@ final class BusStationViewModel: ObservableObject {
                 }
             }
 
-            print("DETAIL \n\n\n\n\n\(details)\n\n\n\n\n\n")
-
             viewState = .success(details)
+            UIAccessibility.post(notification: .announcement, argument: "버스 도착정보가 갱신되었습니다.")
         } catch {
             viewState = .error(error)
         }

OffStageApp/Sources/Presentation/BusStation/SubView/BusStationRowSubView.swift

@@ -20,6 +20,36 @@ struct BusStationRowSubView: View {
         isFavorite
     }
 
+    private var routeInfoAccessibilityLabel: String {
+        var label = "\(route.routeNumber)번 버스"
+        label += route.direction.isEmpty ? ", 방면 정보 없음" : ",\(route.direction) 방면"
+        if route.arrivals.isEmpty {
+            label += ", 도착 정보 없음"
+        } else {
+            for (index, arrival) in
+                route.arrivals.enumerated()
+            {
+                var arrivalLabel = ""
+                if route.arrivals.count > 1 {
+                    arrivalLabel += (
+                        index == 0) ? ", 첫번째 버스" : ", 두번째 버스"
+                } else {
+                    arrivalLabel += ","
+                }
+
+                arrivalLabel += "\(arrival.arrivalDescription)"
+
+                if let remaining =
+                    arrival.remainingStopsDescription
+                {
+                    arrivalLabel += ", \(remaining)"
+                }
+                label += arrivalLabel
+            }
+        }
+        return label
+    }
+
     var body: some View {
         HStack(alignment: .top) {
             VStack(alignment: .leading, spacing: 8) {
@@ -57,6 +87,8 @@ struct BusStationRowSubView: View {
                     }
                 }
             }
+            .accessibilityElement(children: .ignore)
+            .accessibilityLabel(routeInfoAccessibilityLabel)
 
             CircularToggleButton(isOn: isSavedOn) {
                 if isSavedOn {

OffStageApp/Sources/Presentation/BusStation/SubView/CircularToggleButton.swift

@@ -28,5 +28,9 @@ struct CircularToggleButton: View {
                     .font(.system(size: 24, weight: .regular))
             }
         }
+        .accessibilityLabel("즐겨찾기 버튼")
+        .accessibilityValue(isOn ? "선택됨" : "선택 안됨")
+        .accessibilityHint("즐겨찾기 하려면 두번 탭하십시오.")
+        .accessibilityAddTraits(.isButton)
     }
 }