Skip to content

Commit

Permalink
fix #560
Browse files Browse the repository at this point in the history
  • Loading branch information
pya35 committed Dec 2, 2024
1 parent cf33acc commit 27db892
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 29 deletions.
27 changes: 13 additions & 14 deletions src/en/mobile/ios/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,9 +134,6 @@ var body: some View {
</div>
<div class="tab-pane" id="TraitElt-BasicOperations" role="tabpanel">

The `accessibilityTrait` attribute is actually a `bitmask` in which each element has its own value.

![](../../images/iOSdev/Traits.png)
<br>It's then possible to add and remove some `traits` after having checked their existence in the bitmask for instance.

<div class="code-tab-pane">
Expand Down Expand Up @@ -377,10 +374,10 @@ Using VoiceOver for reading date, time and numbers may become rapidly a headache

The rendering isn't natural if the date or time data are imported text in a `label`.

![](../../images/iOSdev/DateHeureNombres_11.png)
![Zero one slash zero four slash two thousand and fifteen. Five thirty](../../images/iOSdev/DateHeureNombres_11.png)
<br>Incoming data must be formatted to obtain a natural and understandable descriptive vocalization.

![](../../images/iOSdev/DateHeureNombres_7.png)
![the first of April two thousand and fifteen. Five hours thirty minutes](../../images/iOSdev/DateHeureNombres_7.png)
<div class="code-tab-pane">

<pre><code class="objectivec">
Expand Down Expand Up @@ -460,10 +457,10 @@ The rendering isn't natural if the date or time data are imported text in a `lab

If a number is imported as is in a `label`text, the vocalization will be made on each figure rendering a final value that may be hard to be well understood.

![](../../images/iOSdev/DateHeureNombres_12.png)
![five four zero three eight none two one seven](../../images/iOSdev/DateHeureNombres_12.png)
<br>As the previous sheet dealing with date and time, the incoming data must be formatted to be analyzed and vocalized according to the proper value of the explained number.

![](../../images/iOSdev/DateHeureNombres_8.png)
![fifty-four million thirty-eight thousand nine hundred twenty-one point seven](../../images/iOSdev/DateHeureNombres_8.png)
<div class="code-tab-pane">

<pre><code class="objectivec">
Expand Down Expand Up @@ -505,10 +502,10 @@ If a number is imported as is in a `label`text, the vocalization will be made on
Once more, formatting data is an essential step for a phone number vocalization including the special cases of the "0" figures.
<br>The example hereunder deals with the french dialing but the rationale behind may be applied to any international type of dialing format.

![default vocalization is not valid for the following phone number : 06.11.22.33.06](../../images/iOSdev/DateHeureNombres_10.png)
![O six dot eleven dot twenty-two dot thirty-three dot O six](../../images/iOSdev/DateHeureNombres_10.png)
<br>The idea of this format is based on a comma separation of each pair of figures that will provide the vocal punctuation.

![in this case the phone number is well vocalized](../../images/iOSdev/DateHeureNombres_9.png)
![zero six eleven twenty-two thirty-three zero six](../../images/iOSdev/DateHeureNombres_9.png)
<div class="code-tab-pane">

<pre><code class="objectivec">
Expand Down Expand Up @@ -1534,7 +1531,7 @@ The `More`&nbsp;`Content` **rotor item** is the only means to get these informat

The following code provides an example to reach some invisible information that are all completely embedded within an image.

⚠️ It's mandatory to **import the Accessibility framework** the `AXCustomContentProvider` protocol belongs to. ⚠️
⚠️ It's mandatory to **import the Accessibility framework** the `AXCustomContentProvider` protocol belongs to.

First, define the class of the view that contains the image:

Expand Down Expand Up @@ -1644,8 +1641,10 @@ var body: some View {
</code></pre>

</div>

Example of use :
Customized content can be added to the Orange brand logo using the “More content” option on the rotor.
![](../../images/iOSdev/CustomContentProvider_2.png)
Using the vertical swipe with a finger, it is possible to hear “Telecommunications company type, Paris head office, 1988 creation date”.
![](../../images/iOSdev/CustomContentProvider_3.png)
</div>
<div class="tab-pane" id="CuCoPro-Links" role="tabpanel">
Expand Down Expand Up @@ -2285,19 +2284,19 @@ Since iOS7, it is possible to make the text size dynamic according to the device
id="TextSize-iOS16"
role="tabpanel">

![](../../images/iOSdev/TailleDesTextes_iOS16_1.png)
![On iOS 16 : menu Settings-Accessibility-Display & Text size, activate Larger Text](../../images/iOSdev/TailleDesTextes_iOS16_1.png)
</div>
<div class="tab-pane"
id="TextSize-iOS13"
role="tabpanel">

![](../../images/iOSdev/TailleDesTextes_iOS13_1.png)
![On iOS 13 : menu Settings-Accessibility-Display & Text size, activate Larger Text](../../images/iOSdev/TailleDesTextes_iOS13_1.png)
</div>
<div class="tab-pane"
id="TextSize-iOS12"
role="tabpanel">

![](../../images/iOSdev/TailleDesTextes_1.png)
![On iOS 12 : menu General-Accessibility, activate Larger Text](../../images/iOSdev/TailleDesTextes_1.png)
</div></div>

<br>The following steps should be respected in order to easily use this <abbr>API</abbr>:
Expand Down
30 changes: 15 additions & 15 deletions src/fr/mobile/ios/developpement.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,11 +137,7 @@ var body: some View {
</div>

<div class="tab-pane" id="TraitElt-BasicOperations" role="tabpanel" >

L'attribut `accessibilityTrait` est en réalité un `bitmask` pour lequel chaque élément pris individuellement peut prendre une valeur spécifique.

![](../../images/iOSdev/Traits.png)
<br>Il est donc possible d'ajouter et d'enlever plusieurs `traits` présents pour caractériser un élement après avoir vérifié leur existence par exemple.
Il est possible d'ajouter et d'enlever plusieurs `traits` présents pour caractériser un élement après avoir vérifié leur existence par exemple.

<div class="code-tab-pane">

Expand Down Expand Up @@ -383,10 +379,10 @@ La lecture des date, heure et nombres n'est pas compliquée mais peut très vite

Si on met directement sous forme de texte la date ou l'heure dans le `label`, on s'aperçoit rapidement que le rendu n'est pas naturel à l'écoute.

![](../../images/iOSdev/DateHeureNombres_10.png)
![Zéro un barre oblique zéro quatre barre oblique deux mille quinze. Cinq trente](../../images/iOSdev/DateHeureNombres_10.png)
Il faut absolument formater les données en entrée pour obtenir une vocalisation descriptive naturelle et compréhensible.

![](../../images/iOSdev/DateHeureNombres_4.png)
![Premier avril deux mille quinze. Cinq heure et trente minutes](../../images/iOSdev/DateHeureNombres_4.png)
<div class="code-tab-pane">

<pre><code class="objectivec">
Expand Down Expand Up @@ -467,11 +463,11 @@ Il faut absolument formater les données en entrée pour obtenir une vocalisatio

En indiquant la valeur d'un nombre directement dans le texte d'un `label`, la vocalisation se fera sur chacun des chiffres présentés rendant la véritable valeur du nombre difficile à deviner.

![](../../images/iOSdev/DateHeureNombres_8.png)
![cinq quatre zéro trois huit neuf deux un sept](../../images/iOSdev/DateHeureNombres_8.png)

Comme pour les date et heure, il faut formater la donnée en entrée pour qu'elle puisse être analysée et vocalisée selon la véritable valeur du nombre qu'elle représente.

![](../../images/iOSdev/DateHeureNombres_5.png)
![cinquante-quatre millions trente-huit mille neuf cent vingt et un virgule sept](../../images/iOSdev/DateHeureNombres_5.png)
<div class="code-tab-pane">

<pre><code class="objectivec">
Expand Down Expand Up @@ -513,10 +509,10 @@ La problématique liée à la vocalisation d'un numéro de téléphone est ident

L'exemple donné ci-dessous concerne la numérotation française avec une logique qui peut se décliner à n'importe quel type de format de numérotation.

![](../../images/iOSdev/DateHeureNombres_11.png)
![zéro six point onze point vingt-deux point trente-trois point zéro six](../../images/iOSdev/DateHeureNombres_11.png)

L'idée est de séparer chaque paire de chiffres par une virgule qui va fournir la ponctuation vocale.
![](../../images/iOSdev/DateHeureNombres_6.png)
![zéro six onze vingt-deux trente-trois zéro six](../../images/iOSdev/DateHeureNombres_6.png)
<div class="code-tab-pane">

<pre><code class="objectivec">
Expand Down Expand Up @@ -1555,7 +1551,7 @@ L'accès à ces informations se fait en **utilisant le rotor** qui contiendra al

L'exemple de code ci-dessous permet d'obtenir tout un tas d'informations présentes sur une image sous forme de données non visuelles mais vocalisables.

⚠️ Il faut absolument penser à **importer le framework Accessibility** auquel appartient le protocole `AXCustomContentProvider`. ⚠️
⚠️ Il faut absolument penser à **importer le framework Accessibility** auquel appartient le protocole `AXCustomContentProvider`.

Après avoir défini la classe pour la vue contenant l'image&nbsp;:

Expand Down Expand Up @@ -1665,7 +1661,11 @@ class ViewController: UIViewController {

</div>

Exemple d'utilisation :
Sur le logo de la marque Orange, il est possible d'ajouter du contenu personnalisé consultable à l'aide de l'option "Plus de contenu" du rotor.
![](../../images/iOSdev/CustomContentProvider_2.png)

En utilisant le balayage vertical avec un doigt, il est possible d'entendre "Télécommunications type de société, Paris siège social, 1988 date de création"
![](../../images/iOSdev/CustomContentProvider_3.png)
</div>
<div class="tab-pane" id="CuCoPro-Links" role="tabpanel">
Expand Down Expand Up @@ -2296,19 +2296,19 @@ Depuis iOS7, il est possible de modifier dynamiquement la taille des textes d'un
id="TextSize-iOS16"
role="tabpanel">
![](../../images/iOSdev/TailleDesTextes_iOS16_1.png)
![Sur iOS 16 : menu Réglages-Accessibilité-Affichage et taille du texte, activer Police plus grande](../../images/iOSdev/TailleDesTextes_iOS16_1.png)
</div>
<div class="tab-pane"
id="TextSize-iOS13"
role="tabpanel">
![](../../images/iOSdev/TailleDesTextes_iOS13_1.png)
![Sur iOS 13 : menu Réglages-Accessibilité-Affichage et taille du texte, activer Police plus grande](../../images/iOSdev/TailleDesTextes_iOS13_1.png)
</div>
<div class="tab-pane"
id="TextSize-iOS12"
role="tabpanel">
![](../../images/iOSdev/TailleDesTextes_1.png)
![Sur iOS 12 : menu Général-Accessibilité, activer Police plus grande](../../images/iOSdev/TailleDesTextes_1.png)
</div></div>

<br>Quelques points sont néanmoins essentiels pour la bonne utilisation du <span lang="en">Dynamic Type</span> mis à disposition&nbsp;:
Expand Down

0 comments on commit 27db892

Please sign in to comment.