برچسب ها و عمل ها (Labels & Actions)
در دسترس پذیری (Accessibility)، باید کنترل ها قابل فهم باشند. «Label» یعنی نام خوانا. «Value» یعنی مقدار فعلی. «Hint» یعنی راهنمای قدم بعد. سپس فناوری های کمکی مانند VoiceOver آن ها را درست اعلام می کنند.
افزودن برچسب، مقدار و نکته
برای متن و دکمه از .accessibilityLabel، .accessibilityValue و .accessibilityHint استفاده کن. بنابراین معنا منتقل می شود و کاربر گیج نمی شود.
import SwiftUI
struct A11yLabelsDemo: View {
@State private var count = 0
var body: some View {
VStack(spacing: 12) {
Text("Count: \(count)")
.accessibilityLabel("Current count")
.accessibilityValue("\(count)")
Button("Increment") {
count += 1
}
.accessibilityHint("Increases the count by one")
}
}
}
import SwiftUI
struct ContentView: View {
var body: some View {
A11yLabelsDemo()
}
}
import SwiftUI
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
نکته: متن Label کوتاه و دقیق باشد. بنابراین خواندن سریع می ماند.
گام های عملی
- روی هر کنترل یک Label بگذار.
- در صورت نیاز Value را مشخص کن.
- برای اقدام ها یک Hint کوتاه بنویس.
- با VoiceOver نتیجه را تست کن.
- جملات اضافی را حذف کن.
لینک های داخلی پیشنهادی
برای پایه ها، صفحه دسترس پذیری در SwiftUI را ببین. همچنین درباره متن پویا به اندازه پویا برو.
جمع بندی سریع
- Label روشن و کوتاه بنویس.
- Value را واضح اعلام کن.
- Hint را خیلی خلاصه بگذار.
- همیشه با VoiceOver تست کن.
- از ابهام پرهیز کن.