Bakh’iOS

Classes et propriétés concernés

• Classes : UIView
• Propriétés : accessibilityLabel Ouvre un nouvel onglet, accessibilityHint Ouvre un nouvel onglet, accessibilityTraits (Ouvre un nouvel onglet), accessibilityValue (Ouvre un nouvel onglet), accessibilityIncrement() (Ouvre un nouvel onglet) , accessibilityDecrement() (Ouvre un nouvel onglet),

Code

		//Nom du composant (exemple avec un onglet custom)
		tabView.accesibilityLabel = "Onglet 1 sur 2"
		//Role et état du composant
		tabView.accessibilityTraits = [.button,.selected]
		//Valeur de l'élément (exemple : slider)
		sliderView.accessibilityValue = "80%"
		
		//Donner plus d'infos sur l'utilisation/actions du composant
		sliderView.accessibilityHint
		
		//Déclencher une vocalisation en cas de changement de contenu (permet également de mettre le focus voice over sur l'élément en question)
		UIAccessibility.post(notification: .layoutChanged, argument: tabPanelLabel)
		
		//Faire lire un texte par Voice Over
		let message = NSAttributedString(
        string: "Texte à vocaliser.",
        attributes: [.accessibilitySpeechQueueAnnouncement: true]) /*indique à VoiceOver d'attendre la fin des annonces en court d'abord*/
      	UIAccessibility.post(notification: .announcement,
                           argument: message)
		
		
		//Exemple : rendre un slider custom accessible à VoiceOver
		class VolumeSlider : UIView {
		
			var value = "50%"
			override func layoutSubviews() {
				super.layoutSubviews()
				...
				accessibilityLabel = "Volume"
				accessibilityHint = "Ajuste la valeur du volume"
				accessibilityTraits = .adjustable //Indique à voice over que c'est un élément dont la valeur est ajustable par l'utilisateur. Avec voice over actif, l'utilisateur peut alors glisser le doigt vers le haut pour incrémenter le slider ou vers le bas pour le décrémenter.
				accessibilityValue = value
				
			}
			
			 override func accessibilityIncrement() { 
			 	//fonction appelée lorsque l'on incrémente le slider via VoiceOver (en glissant le doigt vers le haut). Il faut executer ici executer la même action que pour une incrémentation normale puis mettre à jour la valeur annoncé par voice over
				...
				accessibilityValue = value
			 }
			 
			  override func accessibilityDecrement() { 
			 	//Idem mais pour la décrémentation
				...
				accessibilityValue = value
			 }
		
		
		}
		
		//Utiliser les actions personnalisés pour effectuer des actions demandant des gestes complexes de manière simples avec VoiceOver (par exemple un glisser pour archiver un mail)
		class ViewController: UIViewController {
			override func viewDidLoad() {
				super.viewDidLoad()
				...
				let archive = UIAccessibilityCustomAction(
				  name: "Archiver le mail",
				  target: self,
				  selector: #selector(archiveAction))
				accessibilityCustomActions = [archive] 
				 
			}
				
			@objc func archiveMail() -> Bool {
				//effectuer l'action puis retourner true ou alors retourner false si l'action n'est pas effectuable (Par exemple dans le cas d'un bouton page suivante, si on est déjà sur la dernière page)
			 }
		}
		
		
			

	

Cas particuliers – Notes techniques – Exceptions à la règle :

• Il existe une gestion de cas particulier lorsque la fonctionnalité dépend de l’utilisation d’un gestionnaire d’événement sans équivalent universel ; par exemple, une application de dessin à main levée ne pourra pas être rendue contrôlable via les technologies d’assistances. Dans ces situations, le critère est non applicable.

Au delà des normes :

• Il est également possible d’utiliser les actions personnalisées pour tout simplement créer un raccourci. Par exemple, si on a un bouton en bas à droite de l’écran, on peut créer une action personnalisée ayant la même action que ce bouton pour éviter que l’utilisateur ait à parcourir toute la page afin de l’atteindre
• S’il n y a aucun correspondant au composant custom (par exemple pour les checkbox qui n’existent pas nativement sur iOS), indiquer le role du composant dans le accessibilityLabel