Altova MobileTogether Designer

•Pour réinitialiser un style ou une propriété (dans le Volet Styles & Propriétés), sélectionner la propriété et cliquer Réinitialiser dans la barre outils du volet.

•Pour éditer l'expression XPath d'un style ou d'une propriété (dans le Volet Styles & Propriétés), sélectionner le style ou la propriété et cliquer Éditer XPath dans la barre outils du volet.

•Pour copier une commande dans un autre emplacement dans le design, appuyer sur Ctrl et glisser-déposer la commande dans l'emplacement de copie souhaité.

Le nom est utilisé pour référencer la commande depuis un autre endroit de la page ou du projet. Double-cliquer dans le champ de valeur pour l'éditer.

La propriété Tous les styles deviennent visibles si le paramètre Tous les styles du dialogue Plus de projets a été défini sur true. (Le réglage par défaut de ce paramètre est faux.)

Cette propriété vous permet de définir tous les styles du composant que vous souhaitez via une seule expression de mappage XPath. Consultez les deux expressions de mappage ci-dessous pour voir des exemples de la manière de procéder. Une carte se compose d’une séquence de paires clé-valeur, où la clé correspond à l’un des styles de MobileTogether et la valeur à une valeur valide pour cette propriété. Les propriétés et valeurs autorisées sont indiquées dans le volet Styles et propriétés. Par exemple, dans la liste ci-dessous, on constate que le premier style est Bold Text ; selon la liste déroulante de cette propriété dans le volet Styles et propriétés, il peut prendre la valeur true ou false. Dans l’expression de mappage, la valeur $XML1/R/@bold = "1" renvoie une valeur booléenne (true() ou false()) selon que le nœud d’attribut R/@bold contient ou non la chaîne 1. De cette manière, nous avons défini la propriété Bold Text de manière dynamique : elle changera en fonction du contenu du nœud R/@bold. De la même manière, la propriété Background Color est définie de manière dynamique.

map{

  "Bold Text"        : $XML1/R/@bold = "1",

  "Italic Text"      : true(),

  "Text"             : "hello",

  "Text Color"       : "red",

  "Background Color" : $XML1/R/@background,

  "Text Size"        : $XML1/R/@textsize

  }

map{

  "Style Sheet"      : "Sheet-1"

  }

Notez les points suivants :

•Lorsque vous saisissez une valeur pour la propriété Tous les styles, même s’il ne s’agit pas d’un mappage, toutes les propriétés du composant actuel dans le Volet Styles & Propriétés ne seront plus visibles.

•En l’occurrence, il s’agit d’une fonction avancée, vous devez donc vous assurer que votre expression de map Xpath est correcte, aussi bien en termes de syntaxe que de valeurs.

•Vous pouvez saisir les paires de clé-valeur du map dans n’importe quel ordre.

•Les noms de clé sont les noms des propriétés de style (ou les styles). Dans le premier map ci-dessus, par exemple, Texte gras et Taille de texte sont des noms de style. Tous les styles et leurs valeurs disponibles sont indiqués sous chaque composant dans le volet Styles et propriétés.

•Vous pouvez également spécifier une feuille de style à utiliser, comme illustré dans la deuxième carte ci-dessus.

La propriété Texte prend pour valeur l'une des options suivantes :

•une chaîne de texte à valeur fixe à afficher dans le contrôle

•Une expression XPath qui récupère des données à partir d'un nœud du code source d'une page et affiche ces données dans le contrôle

Double-cliquez à l'intérieur du champ de valeur pour le modifier, ou cliquez sur le bouton XPath de la barre d'outils et saisissez une expression XPath qui génère le texte requis. Vous pouvez également cliquer avec le bouton droit sur la propriété et sélectionner la méthode de saisie souhaitée dans le menu contextuel (valeur fixe ou XPath).

Note :  dans le contrôle Texte enrichi, vous pouvez saisir une expression XPath sous la forme d’une chaîne encodée en HTML. Si des styles pour les éléments HTML ont été définis dans la feuille de style active du Texte enrichi, la valeur textuelle de cette propriété s’affichera avec la mise en forme appropriée. Reportez-vous à la section Texte enrichi pour plus d'informations.

Note :  la variable $MTControlValue n’est pas disponible pour la génération de la valeur de la propriété Texte. Si elle est utilisée, une erreur de validation se produit.

Une expression XPath qui doit évaluer à vrai() ou faux(). Si l'expression évalue à faux()(et seulement dans ce cas) la commande ne sera pas visible. Si l'expression évalue à vrai() ou retourne d'autres valeurs, la commande sera visible. Le réglage par défaut est vrai(). Double-cliquer dans le champ de valeur ou cliquer sur le bouton XPath pour saisir ou éditer une expression XPath. La propriété Visible peut être utilisée pour rendre un objet visible ou pas selon le fait qu'une expression XPath évalue à vrai()ou pas. En résultat, l'affichage d'un objet peut être forcé à être dynamiquement dépendant du contexte ou de la structure des données.

Note :  Pour plus d'informations concernant la visibilité des colonnes/lignes couvertes, voir les Propriétés de table.

Note :  La variable $MTControlValue n'est pas disponible pour l'évaluation de la propriété Visible. En cas d'utilisation, une erreur de validation en résultera

La commande est soit activée soit désactivée, selon que la valeur de la propriété est vrai (activée) ou faux (désactivée). La valeur peut être saisie directement (en la sélectionnant dans la liste de choix ou en double-cliquant dans le champ de valeur et en saisissant la valeur que vous souhaitez). La valeur peut aussi être une expression XPath qui évalue à vrai ou faux (booléenne). La valeur par défaut est vrai. Généralement, l'expression XPath de la propriété Enabled/Editable d'une commande contrôle la présence ou la valeur d'un nœud. Si l'expression évalue à vrai, la commande sera activée.

Propose un conseil sous forme de texte à l'utilisateur final. Par exemple, un conseil concernant une action que l'utilisateur final doit effectuer par le biais de la commande. Double-cliquer dans le champ de valeur de la propriété pour éditer le conseil ou cliquer sur le bouton de la barre outils XPath et saisir une expression XPath pour générer le texte nécessaire.

Définit la couleur du texte du conseil pour la commande. Cette couleur de texte sera la couleur du texte définit pour la propriété Conseil (voir ci-dessus). Vous pouvez choisir une des options suivantes pour choisir la couleur :

•Cliquer sur la palette de couleurs pour sélectionner une couleur d'arrière-plan

•Choisir une couleur depuis la liste déroulante de la liste de choix

•Double-cliquer dans le champ de valeur pour saisir un code de couleur (par exemple #FF0000) ou cliquer dans le bouton de la barre outils XPath et saisir une expression XPath pour générer le texte nécessaire.

Spécifie laquelle des feuilles de styles de Rich Text du design doit être utilisée pour la mise en page du texte dans la commande Rich Text. La liste déroulante de la liste de choix des propriétés affiche toutes les feuilles de styles du Rich Text de ce projet (créées dans le dialogue Feuilles de style pour Rich Text).

Cette propriété s'applique dans le cas de certaines commandes (comme des images et des lignes verticales) dans la commande, dans d'autres cas (comme des boutons radio et des cases à cocher) dans le texte qui accompagne la commande. Elle définit l'alignement horizontal à gauche, centre ou droite. Le réglage par défaut est centre. La valeur peut aussi être spécifiée par le biais d'une expression XPath (qui permet de générer la valeur dynamiquement).

définit la largeur de la commande. Sélectionner une valeur depuis la liste déroulante de la liste de choix. Les valeurs suivantes sont disponibles :

•fill_parent: permet d'obtenir une commande de la même largeur que le parent. Cela peut être par exemple une cellule de la table ou la page

•wrap_content: permet d'obtenir une commande ne dépassant pas la largeur du contenu de la commande ; lorsque cette valeur est sélectionnée, la propriété Largeur de commande maximum est disponible

•wrap_content_longest_entry: est disponible pour les commande de liste de choix et permet d’adapter la largeur des listes de choix au contenu le plus long ; lorsque cette valeur de propriété est sélectionnée, la propriété Largeur maximum de commande est disponible

•valeur pourcentuelle : un pourcentage de la largeur de la page ; sélectionner une valeur depuis la liste déroulante ou saisir directement une valeur

•valeur de pixel, dp ou sp : sélectionner une valeur de pixel, dp ou sp depuis la liste déroulante ou saisir directement une valeur

De fait, fill_parent crée une largeur maximum, alors que wrap_content crée une largeur minimum. Si la liste de choix se trouve dans une cellule de table, par exemple, fill_parent laissera la liste de choix remplir la cellule, alors que wrap_content pourrait ne pas remplir la cellule.

La valeur par défaut est fill_parent pour toutes les commandes sauf :

•Image et Graphique: dans ces cas, le défaut est wrap_content.

•Carte de géolocalisation : le défaut est la plus petite des deux valeurs $MT_CanvasX et$MT_CanvasY. Ces deux variables dynamiques donnent, respectivement, la largeur et la hauteur du viewport de l'appareil. Puisque la valeur par défaut de Control Height et Control Width sont les mêmes (dans chacun des cas, la valeur la plus petite de $MT_CanvasX et $MT_CanvasY), la forme et la taille par défaut du viewport dans la commande seront toujours un carré dont les côtés sont égaux à min($MT_CanvasX, $MT_CanvasY).

Pour plus d’informations concernant les relations entre les pixels, dp (pixels dépendant des appareils), et sp (pixels indépendants de l’échelle), voir Tailles : Pixels, DPI, DP, SP.

Points vs pixels sur les appareils iOS

Cette propriété est disponible uniquement lorsque la propriété du contrôle Control Width a été définie pour wrap_content. La propriété Max Control Width définit la largeur de contrôle maximale. Sélectionnez une valeur depuis la propriété de la zone de liste modifiable. Les valeurs suivantes sont disponibles :

•valeur pourcent : un pourcentage de la largeur de la page ; sélectionnez une valeur depuis la liste déroulante, ou saisissez une valeur directement

•pixel, dp, ou valeur sp : sélectionnez un pixel, dp, ou une valeur sp depuis la liste déroulante, ou saisissez une valeur directement

Spécifie la hauteur de la commande Rich Text. Le comportement par défaut (wrap_content) est pour augmenter la hauteur de la commande lorsque le contenu augmente, jusqu’à un niveau maximum de la hauteur de l’écran sur les appareils et sur les fenêtres de navigateur sur les clients web. Une fois que la hauteur maximum est atteinte, la partie du contenu affiche une barre défilante ; la barre d'outils est fixée dans la partie supérieure de la commande. En alternative, vous pouvez définir une hauteur fixe (en pixels, dp ou sp) pour la commande.

Définit les décalages de marge de la commande (ou de la page) relatifs aux objets environnants ou aux rebords de l'objet contenu. Sélectionner une valeur en pixels, dp ou sp à partir de la liste déroulante de la liste de choix ou double-cliquer dans le champ de valeur pour saisir une longueur de pixel. Le décalage spécifié sera créé sur les quatre côtés de la commande ou de la page. Si vous souhaitez définir une marge différente pour un des quatre côtés, agrandir la propriété Marge pour afficher les propriétés de remplissage individuelles (gauche, droite, haut et bas), et définir la valeur différente. Par exemple : Par exemple : si vous définissez Marge sur 6px et Marge Bas sur 12px, alors les marges haut, gauche et droite seront 6px et la marge bas sera 12px.

Pour plus d’informations concernant les relations entre les pixels, dp (pixels dépendant des appareils), et sp (pixels indépendants de l’échelle), voir Tailles : Pixels, DPI, DP, SP.

Points vs pixels sur les appareils iOS

La propriété Ordre de tabulation prend un entier en tant que sa valeur ou une expression XPath qui évalue en tant qu'un entier. Ce nombre entier est la position de la commande dans l'ordre de la séquence de tabulation.

L'ordre de tabulation est la séquence dans laquelle les commandes apparaissent lorsque l'utilisateur de l'Appareil client effleurent la touche Tab. L'ensemble de la séquence peut être défini rapidement et dans le contexte visuel de toutes les commandes de la page dans la commande de menu Page | Afficher/Définir l'ordre de Tab. La propriété Ordre de tab des différentes commandes définissent la position séquentielle de cette seule commande.

Note :    La fonction Ordre de tabulation est uniquement disponible sur les clients Web et Windows.

La propriété Feuille de style définit la feuille de style à utiliser pour la commande. La liste déroulante de la liste de choix de la propriété Feuille de style affiche toutes les feuilles de style créée par l'utilisateur qui ont été définies dans le projet. Sélectionner la feuille de style que vous souhaitez utiliser pour la commande. En alternative, vous pouvez utiliser une expression XPath pour sélectionner la feuille de style que vous souhaitez ; cela a l'avantage que vous pouvez rendre la sélection de la feuille de style conditionnelle (voir Appliquer les feuilles de style créées par l'utilisateur). Voir la section Feuilles de style pour plus d'informations.

Le nom d’une ou de plusieurs classes CSS peut ensuite être associée avec cette commande. Utiliser l’espace pour assigner de multiples classes : LabelClassOne LabelClassTwo. Ces classes peuvent ensuite être utilisées dans un fichier CSS (spécifié dans les dialogue Paramètres du navigateur) pour attribuer des propriétés particulier pour cette commande. Vous pouvez également utiliser une expression XPath pour générer ou récupérer les noms de la/des classe/s.

Vous pouvez utiliser la valeur prédéfinie suivante pour définir le comportement spécifique :

•mt-combo-open-on-focus ouvre la liste déroulante de la zone combinée quand l’utilisateur appuie sur la touche. Vous pouvez utiliser cette valeur dans (i) la zone combinée et (ii) sur les commandes de table si la table contient des commandes de la zone combinée. En alternative, si vous voulez ouvrir toutes les zones de liste dur une page individuellement, alors vous pouvez définir cette valeur dans la propritété de la page Browser CSS Class .