インスタンスプロパティ


accessibilityHint


アクセシビリティ要素に対してアクションを実行した結果の簡単な説明を含むローカライズされた文字列。


iOS 2.0+ iPadOS 2.0+ Mac Catalyst 13.1+ tvOS 9.0+ visionOS 1.0+   Beta  


var accessibilityHint: String? { get set }





議論


要素が UIKit コントロールでない限り、このプロパティのデフォルト値は nil です。その場合、値は、コントロールの型から派生する、システムが提供するヒントです。


アクセシビリティヒントは、アクセシビリティラベルからの結果が明らかでない場合に、アクセシビリティ要素に対してアクションを実行すると何が起こるかをユーザーが理解するのに役立ちます。たとえば、あなたのアプリに [追加(Add)] ボタンを提供する場合、ボタンのアクセシビリティラベルは、ボタンをタップするとアプリに値が追加されることをユーザが理解するのに役立ちます。ただし、あなたのアプリでユーザが曲タイトルのリストでタイトルをタップして曲を再生できる場合、リスト行のアクセシビリティラベルはユーザにそのことを伝えません。支援アプリが障害のあるユーザにこの情報を提供できるようにするために、リスト行の適切なヒントは "曲を再生します" です。


アクセシビリティ要素のヒントを作成するには、以下のガイドラインに従ってください。


  • "曲を再生する(Plays the song)" や "アイテムを購入する(Purchases the item)" など、アクションの結果を非常に短いフレーズで説明する動詞で始めます。

  • ヒントが命令のように聞こえる可能性があるため、動詞の命令形でフレーズを始めることは避けてください。たとえば、"曲を再生する (Play the song)" や "アイテムを購入する(Purchase the item)" などのヒントを作成しないでください。


  • ヒントにアクションの型を含めないでください。たとえば、"タップして曲を再生する" や "タップすると曲が再生される" などのヒントを作成しないでください。

  • ヒントにコントロールまたはビューの型を含めないでください。たとえば、"その行の曲を再生する" や "連絡先名を追加するボタン" などのヒントを作成しないでください。





  • 以下も見よ


    基本的なアクセシビリティのサポート


    var isAccessibilityElement: Bool

    要素が支援アプリでアクセスできるアクセシビリティ要素であるかどうかを示すブール値。


    var accessibilityLabel: String?

    アクセシビリティ要素を識別するローカライズされた文字列内の簡潔なラベル。


    var accessibilityValue: String?

    アクセシビリティ要素の値を含むローカライズされた文字列。


    var accessibilityTraits: UIAccessibilityTraits

    アクセシビリティ要素を最もよく特徴付けるアクセシビリティ特性の組み合わせ。


    struct UIAccessibilityTraits

    アクセシビリティ要素の動作を説明する定数群。















    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ