Lộ Trình Học Lập Trình Viên iOS: Khả Năng Truy Cập Trong iOS – Nâng Tầm Trải Nghiệm Với VoiceOver, Dynamic Type và Những Điều Cần Biết

Khả năng truy cập trong iOS không phải lớp trang trí thêm sau khi giao diện đã hoàn tất. Nếu một nút chỉ có icon, một thông báo chỉ dùng màu đỏ, hoặc một tiêu đề biến mất khi người dùng phóng to chữ, đó là lỗi sản phẩm. Với iOS 27.2 và Xcode 27.2, hãy xem Accessibility như một yêu cầu chức năng được thiết kế, lập trình và kiểm thử.

Người dùng có thể đọc màn hình bằng VoiceOver, tăng Dynamic Type, bật Bold Text hoặc Increase Contrast, giảm chuyển động, điều khiển thiết bị bằng giọng nói hay Switch Control. Những lựa chọn này cũng hữu ích khi người dùng đang lái xe, ở nơi ánh sáng kém, bị chấn thương tạm thời hoặc chỉ muốn đọc nội dung rõ hơn. Mục tiêu của bạn là giữ nguyên thông tin và hành động, dù cách người dùng nhìn hoặc điều khiển ứng dụng thay đổi.

Cập nhật iOS 2026: bắt đầu từ HIG, ưu tiên SwiftUI

  • iOS 27.2 (24B119) là bản ổn định ngày 26/10/2026; Xcode 27.2 (27B52) là toolchain ổn định ngày 29/10/2026. SwiftUI đi cùng iOS 27 SDK và là lựa chọn ưu tiên cho màn hình mới.
  • UIKit vẫn cần thiết cho codebase hiện hữu, một số màn hình phức tạp và phần tích hợp hệ thống. Đừng chuyển đổi chỉ vì Accessibility; hãy làm cho semantic model nhất quán ở cả hai framework.
  • Human Interface Guidelines (HIG) coi control hệ thống, thứ bậc nội dung, tương phản và kích thước vùng chạm là nền tảng. Custom UI phải giữ lại những affordance này, không chỉ bắt chước hình thức.

Accessibility là yêu cầu sản phẩm, không phải polish

Hãy đưa câu hỏi Accessibility vào product requirement: người dùng có nghe được tên và trạng thái của control không, có hoàn thành tác vụ khi chữ lớn nhất không, và có phân biệt được trạng thái mà không cần màu không? Acceptance criteria nên bao gồm VoiceOver, Dynamic Type, tương phản, chuyển động và thao tác bằng phần cứng hỗ trợ.

Có một mental model đơn giản: nội dung trả lời “đây là gì”, hành động trả lời “làm được gì”, còn trạng thái trả lời “hiện đang thế nào”. VoiceOver cần cả ba. Trong SwiftUI, bạn biểu đạt chúng bằng accessibilityLabel, accessibilityHint, accessibilityValue và traits. Trong UIKit, các thuộc tính tương ứng nằm trên UIView và được hỗ trợ bởi UIAccessibility.

VoiceOver: mô tả đúng nội dung, hành động và trạng thái

Control chuẩn như Button, Toggle, Slider, UILabel hay UIButton thường có semantics mặc định tốt. Hãy dùng chúng trước khi tạo một view tương tác riêng. Label nên ngắn và là danh từ hoặc tên hành động: “Lưu bài viết”, “Ảnh đại diện của Lan”. Hint chỉ thêm thông tin mà label chưa nói, chẳng hạn “Nhấn hai lần để mở danh sách”. Đừng lặp lại “nút” trong label nếu trait đã đọc loại control.

Value dành cho dữ liệu thay đổi: “3 mục”, “Đang bật”, “50 phần trăm”. Traits cho biết loại và trạng thái như button, selected, header hoặc adjustable. Nếu bạn tự thêm .isButton vào một Button đã có trait button, kết quả không hỏng nhưng không cần thiết; quan trọng là custom control phải có đúng trait và hành động tương ứng.

Custom control accessible bằng SwiftUI

Ví dụ dưới đây là bộ điều chỉnh số lượng. Mỗi nút có label, hint và identifier riêng; nhóm có value tổng hợp để người dùng hiểu ngữ cảnh. accessibilityElement(children: .combine) chỉ nên dùng khi việc gộp không làm mất hành động của các control con. Với nhóm có nhiều nút độc lập, giữ các element riêng để VoiceOver điều hướng được.

import SwiftUI

struct AccessibleStepper: View {
    @Binding var value: Int
    let range: ClosedRange<Int>
    @Environment(\.accessibilityReduceMotion) private var reduceMotion

    var body: some View {
        HStack {
            Button(action: decrease) {
                Image(systemName: "minus")
            }
            .accessibilityLabel("Giảm số lượng")
            .accessibilityHint("Giảm một đơn vị")
            .accessibilityIdentifier("quantity.decrease")

            Text("Số lượng: \(value)")
                .font(.body)
                .accessibilityLabel("Số lượng")
                .accessibilityValue("\(value)")
                .accessibilityAddTraits(.isHeader)

            Button(action: increase) {
                Image(systemName: "plus")
            }
            .accessibilityLabel("Tăng số lượng")
            .accessibilityHint("Tăng một đơn vị")
            .accessibilityIdentifier("quantity.increase")
        }
        .accessibilityElement(children: .contain)
        .animation(reduceMotion ? nil : .easeInOut, value: value)
    }

    private func decrease() {
        guard value > range.lowerBound else { return }
        value -= 1
    }

    private func increase() {
        guard value < range.upperBound else { return }
        value += 1
    }
}

Ở đây .accessibilityRemoveTraits có thể dùng khi một wrapper kế thừa trait không phù hợp, ví dụ bỏ trait image khỏi một view chỉ dùng làm nền. .accessibilityIdentifier phục vụ automation, không phải lời VoiceOver đọc. Nếu cần một rotor cho các phần tử quan trọng, đánh dấu chúng nhất quán bằng trait hoặc modifier rotor; người dùng có thể xoay rotor để chuyển nhanh giữa heading, link hoặc loại nội dung mà bạn cung cấp.

Dynamic Type và các tuỳ chọn thị giác

Dynamic Type không chỉ là tăng một con số font. Dùng text styles ngữ nghĩa như .body, .headline và .title; để layout cho phép xuống dòng, tăng chiều cao và chuyển từ ngang sang dọc khi cần. Với kích thước phụ thuộc một giá trị khác, @ScaledMetric giúp khoảng đệm hoặc icon tăng theo content size category thay vì giữ cứng.

struct ReadingRow: View {
    let title: String
    @ScaledMetric(relativeTo: .body) private var iconSize = 22

    var body: some View {
        Label {
            Text(title)
                .font(.body)
                .fixedSize(horizontal: false, vertical: true)
        } icon: {
            Image(systemName: "book")
                .font(.system(size: iconSize))
                .accessibilityHidden(true)
        }
        .padding(.vertical, 8)
    }
}

Kiểm tra Bold Text, Increase Contrast và Reduce Transparency thay vì chỉ dựa vào giao diện mặc định. Văn bản phải còn đọc được khi weight tăng; nền kính, shadow và lớp mờ không được là điều kiện duy nhất để phân biệt vùng. Với màu sắc, luôn thêm text, icon, pattern hoặc trạng thái focus. “Đỏ là lỗi, xanh là thành công” không đủ cho người mù màu hoặc khi contrast bị thay đổi.

Reduce Motion cần được thiết kế thành hai trạng thái: chuyển động đầy đủ và trạng thái tĩnh vẫn truyền đạt cùng kết quả. Trong SwiftUI, đọc accessibilityReduceMotion từ environment như ví dụ trên; tránh chỉ tắt một animation mà vẫn giữ parallax hoặc transition gây khó chịu. Trong UIKit, kiểm tra UIAccessibility.isReduceMotionEnabled trước khi chạy animation và cập nhật khi thiết lập trợ năng thay đổi.

UIKit: dùng UIAccessibility đúng chỗ

UIKit cung cấp semantics tốt cho control chuẩn, nhưng custom view cần được khai báo rõ. isAccessibilityElement quyết định view có xuất hiện trong cây Accessibility hay không; accessibilityLabel, accessibilityHint, accessibilityValue và accessibilityTraits mô tả element. accessibilityElements trên container cho phép bạn đặt thứ tự đọc khi hierarchy trực quan không phản ánh thứ tự thao tác.

import UIKit

final class QuantityViewController: UIViewController {
    private let quantityLabel = UILabel()
    private let decreaseButton = UIButton(type: .system)
    private let increaseButton = UIButton(type: .system)
    private var quantity = 1 { didSet { updateAccessibility() } }

    override func viewDidLoad() {
        super.viewDidLoad()
        quantityLabel.font = .preferredFont(forTextStyle: .body)
        quantityLabel.adjustsFontForContentSizeCategory = true
        quantityLabel.numberOfLines = 0

        decreaseButton.setImage(UIImage(systemName: "minus"), for: .normal)
        increaseButton.setImage(UIImage(systemName: "plus"), for: .normal)
        decreaseButton.accessibilityLabel = "Giảm số lượng"
        increaseButton.accessibilityLabel = "Tăng số lượng"
        decreaseButton.accessibilityHint = "Giảm một đơn vị"
        increaseButton.accessibilityHint = "Tăng một đơn vị"
        decreaseButton.accessibilityIdentifier = "quantity.decrease"
        increaseButton.accessibilityIdentifier = "quantity.increase"

        decreaseButton.addTarget(self, action: #selector(decrease), for: .primaryActionTriggered)
        increaseButton.addTarget(self, action: #selector(increase), for: .primaryActionTriggered)
        updateAccessibility()
    }

    private func updateAccessibility() {
        quantityLabel.text = "Số lượng: \(quantity)"
        quantityLabel.accessibilityLabel = "Số lượng"
        quantityLabel.accessibilityValue = "\(quantity)"
        decreaseButton.isEnabled = quantity > 1
    }

    @objc private func decrease() { quantity = max(1, quantity - 1) }
    @objc private func increase() { quantity += 1 }
}

Đừng gắn isAccessibilityElement = true cho mọi UIImageView. Ảnh truyền đạt thông tin cần label; ảnh trang trí nên ẩn khỏi cây đọc. Khi cần đặt vùng hình học của một custom control, dùng accessibilityFrame trong hệ toạ độ màn hình và cập nhật nó khi layout thay đổi. Một element có label đúng nhưng frame lệch vẫn là trải nghiệm lỗi.

Voice Control, Switch Control và vùng chạm

Voice Control dùng tên hiển thị để người dùng nói “tap …”; vì vậy label của control phải tự nhiên và duy nhất trên màn hình. Identifier dành cho test không thay thế label. Switch Control quét qua các element theo thứ tự; một custom control không có action, state hoặc focus order rõ ràng sẽ khiến người dùng không thể hoàn thành tác vụ bằng switch.

Vùng chạm cần đủ lớn và không chồng lên control bên cạnh; lấy mốc 44 × 44 pt của HIG cho control tương tác, kể cả khi icon nhìn nhỏ hơn. Có thể mở rộng hit area bằng padding hoặc một wrapper, nhưng đừng làm frame Accessibility bao phủ sang nút khác. Kiểm tra cả thiết bị xoay ngang, Dynamic Type lớn và VoiceOver focus để phát hiện vùng chạm bị cắt.

Test Accessibility như test chức năng

Accessibility Inspector trong Xcode giúp xem element tree, label, value, traits, frame và một số vấn đề tương phản. Hãy bật VoiceOver trên simulator hoặc thiết bị thật, đi qua một luồng hoàn chỉnh: mở màn hình, tìm nội dung, sửa dữ liệu, nhận lỗi và hoàn tất. Đừng chỉ chạm từng view; hãy quan sát thứ tự focus và thông báo sau khi trạng thái thay đổi.

Với XCUITest, dùng identifier ổn định cho các control quan trọng. Bạn có thể kiểm tra element tồn tại, truy cập được và thực hiện action mà không phụ thuộc text hiển thị hoặc ngôn ngữ. Identifier nên có quy ước theo feature, chẳng hạn quantity.increase; không đưa identifier kỹ thuật vào accessibilityLabel. XCTest vẫn là lựa chọn cần thiết cho UI test, dù Swift Testing hữu ích cho unit test.

func testCanIncreaseQuantity() {
    let app = XCUIApplication()
    app.launch()

    let increase = app.buttons["quantity.increase"]
    XCTAssertTrue(increase.exists)
    XCTAssertTrue(increase.isHittable)
    increase.tap()

    XCTAssertEqual(app.staticTexts["Số lượng"].value as? String, "2")
}

Những lỗi thường gặp và cách sửa

Lỗi Vì sao hỏng Cách sửa
Ảnh trang trí bị đọc VoiceOver thêm tiếng ồn trước nội dung chính. Ẩn ảnh trang trí; chỉ label ảnh mang thông tin.
Label bị lặp “Nút Lưu, nút” hoặc tiêu đề bị đọc hai lần. Để trait cung cấp loại control; label chỉ nêu tên.
Font và chiều cao hard-code Chữ lớn bị cắt, chồng lấn hoặc mất action. Dùng text styles, @ScaledMetric, Auto Layout và layout linh hoạt.
Chỉ dùng màu để truyền nghĩa Thông tin biến mất khi contrast hoặc khả năng phân biệt màu thay đổi. Thêm text, icon, shape, pattern và trạng thái focus.
Custom control không có action Element được đọc nhưng không thể thao tác bằng VoiceOver, Voice Control hoặc switch. Dùng control chuẩn hoặc cung cấp action, trait, value và focus order đầy đủ.
Ẩn content để “đơn giản hoá” Gộp sai hoặc accessibilityHidden làm mất thông tin cần thiết. Chỉ ẩn nội dung trùng lặp, trang trí; thử lại bằng luồng người dùng thật.
Dùng identifier làm spoken label VoiceOver đọc chuỗi kỹ thuật khó hiểu và dễ lộ chi tiết nội bộ. Identifier ổn định cho test, label tự nhiên cho người dùng.

Quyết định nhanh: dùng API nào?

  • SwiftUI view chuẩn: ưu tiên semantics mặc định, sau đó bổ sung label, hint hoặc value khi nội dung không tự mô tả.
  • SwiftUI custom control: cân nhắc bọc bằng Button, Toggle hoặc Slider; chỉ dùng traits và action thủ công khi hành vi thật sự khác.
  • UIKit control chuẩn: giữ mặc định, thêm identifier cho XCUITest và chỉ override label khi title không đủ.
  • UIKit custom view: khai báo element, traits, frame, thứ tự đọc và cập nhật value cùng state; dùng UIAccessibility.post khi thay đổi cần thông báo.

Trong một màn hình SwiftUI bọc UIKit, hãy kiểm tra cây Accessibility sau khi ghép hai framework. Wrapper có thể vô tình tạo element trùng với child, hoặc nuốt mất focus. Quyết định gộp hay tách element dựa trên cách người dùng hoàn thành tác vụ, không dựa trên số lượng view trong hierarchy.

2027 và checklist trước khi merge

iOS tiếp tục đi theo hướng SwiftUI-first, nhưng ứng dụng thực tế sẽ còn UIKit và custom component trong nhiều năm. HIG và các chế độ trợ năng của hệ thống sẽ tiếp tục là chuẩn kiểm tra tốt hơn việc đoán một giao diện “trông có vẻ dễ dùng”. Hãy thiết kế semantic model bền vững để cập nhật SDK không biến Accessibility thành một đợt sửa chữa cuối kỳ.

  • Kiểm tra mọi màn hình với VoiceOver: label, hint, value, traits, thứ tự focus và phản hồi sau action.
  • Chọn Dynamic Type text styles; thử cỡ chữ lớn, Bold Text và landscape, không chấp nhận text bị cắt.
  • Kiểm tra Increase Contrast, Reduce Transparency, Reduce Motion và ý nghĩa không phụ thuộc màu.
  • Đảm bảo control có hit target khoảng 44 × 44 pt, không chồng lấn và vẫn reachable bằng Switch Control.
  • Thêm identifier ổn định cho XCUITest, chạy Accessibility Inspector và giữ một UI test cho luồng quan trọng.
  • Nhờ người dùng thực sự dùng công nghệ hỗ trợ review trước khi phát hành; log kỹ thuật không thay thế phản hồi đó.

Đọc tiếp trong lộ trình iOS

Nếu cần củng cố nền tảng giao diện, xem bài xây dựng giao diện cơ bản với UIKit để hiểu view hierarchy và controller. Khi constraint ảnh hưởng đến Dynamic Type, bài Auto Layout trong Xcode và Interface Builder giúp bạn kiểm tra layout co giãn.

Accessibility cũng nằm trong chất lượng sản phẩm tổng thể: bạn có thể xem REST vs GraphQL trong iOS khi xây dựng trạng thái loading và lỗi có thể được đọc, hoặc quay lại roadmap học lập trình viên iOS để đặt Accessibility vào từng chặng thay vì dồn ở cuối dự án.