AttributeMatchPath
L’élément <AttributeMatchPath> peut être utilisé par une configuration de contrôle web pour rechercher le contrôle souhaité dans le document HTML actuellement chargé à l’aide des attributs de contrôles. Le « chemin de correspondance » est une liste ordonnée de paires clé/valeur qui est appliquée en itérant via chaque élément du HTML``Document Object Model (DOM), en mettant en correspondance les attributs sur les nœuds du chemin de correspondance. Chaque clé représente le nom de l’attribut à mettre en correspondance, et la valeur est mise en correspondance avec la valeur d’attribut assignée dans le document HTML. Lorsqu’une clé/valeur est mise en correspondance, la paire clé/valeur suivante de la séquence est utilisée pour comparer chaque élément du modèle DOM. Notez que lorsque keyn+1 = keyn, la correspondance avec la nouvelle paire clé/valeur commence par le nœud d’élément suivant dans le modèle DOM, pas par le nœud actuel.
Syntaxe de <AttributeMatchPath>
L’élément <AttributeMatchPath> peut être ciblé dans des cadres spécifiques d’une application HTML.
<AttributeMatchPath [framename=""|framesrc=""] [framematch="n"] [matchtype="equals|startswith|endswith|contains"]>
<attributeName1 [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatch1
</attributeName1>
<attributeName2 [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatch2
</attributeName2>
…
<attributeNamen [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatchn
</attributeNamen>
</AttributeMatchPath>
Éléments de <AttributeMatchPath>
Le tableau suivant décrit les éléments de <AttributeMatchPath>.
| Élément | Description |
|---|---|
| Framename | Correspond au nom de cadre de l’IFrame. |
| Framesrc | Correspond à la source de l’IFrame. |
| Framematch | Correspond au nième cadre du cadre spécifié ; la valeur par défaut est 1. |
| Matchtype | Spécifie comment la légende doit être mise en correspondance. Les valeurs possibles sont equals, startswith, endswith ou contains ; toute autre valeur lèvera une exception. |
Par exemple, si une application web a plusieurs cadres avec un nom donné, vous pouvez spécifier de rechercher les deuxième et troisième cadres de ce nom. L’attribut framematch n’est pas obligatoire, mais est supposé avoir la valeur 1, sauf mention contraire. Si framematch est spécifié, framename ou framesrc doit être spécifié ; sinon, une exception « Cadre introuvable » sera levée.
Note
Si aucun des attributs AttributeMatchPath n’est fourni, l’opération aura lieu dans la fenêtre de niveau supérieur comme s’il s’agissait d’un cadre. Si framename et framesrc sont spécifiés, framesrc est prioritaire.
Dans l’exemple suivant, matchtype est utilisé dans attributeValueToMatch.
<AttributeMatchPath>
<key1>val1</key1>
<key2>val2</key2>
<key3[matchtype="equals|startswith|endswith|contains"]>attributeValueToMatch</key3>
.
<keyn>valn</keyn>
</AttributeMatchPath>
L’exemple suivant illustre un chemin de correspondance d’attribut complet pour une balise Test.
Page code:
<Test FirstName='John' LastName='Smith'/>
Match path used in control description:
<AttributeMatchPath>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
</AttributeMatchPath>
Note
Il est fortement recommandé d’utiliser uniquement l’ID et/ou le nom comme attributs de recherche. Les autres attributs auront un impact négatif sur les performances.