DocumentationAEM 6.5Guide de l’utilisateur

Prise en charge des scripts pour les formulaires HTML5 scripting-support-for-html-forms

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Administration
  • Utilisateur ou utilisatrice
  • Développeur

Les propriétés JavaScript, FormCalc et les méthodes prises en charge dans les formulaires HTML5 sont les suivantes :

$event event

Propriété
Description
Exception
prevText
Indique le contenu du champ une fois qu’il a été modifié suite aux actions de l’utilisateur ou utilisatrice. Il est possible de rappeler cette valeur de manière similaire à une fonction d’annulation.

Ne fonctionne pas sur les menus déroulants et les zones de liste. PrevText ne fonctionne pas correctement dans les cas suivants :

  • Lorsque vous appuyez sur certaines touches de caractères spéciaux (par exemple $, &, ou @, etc.) dans les champs numériques sur l’iPad, et
  • Pour le champ de date (lorsque la date est saisie via le calendrier).

La configuration de la valeur à l’aide du script n’est pas prise en charge.

target
Indique l’objet sur lequel l’événement a une influence.
La configuration de la valeur à l’aide du script n’est pas prise en charge.
newtext
Indique le contenu du champ une fois qu’il a été modifié suite aux actions de l’utilisateur.

La propriété newText ne fonctionne pas correctement dans les cas suivants :

  • Lorsque vous sélectionnez des textes de remplacement.
  • Lorsque vous supprimez, copiez et collez des textes.
  • Lorsque vous appuyez sur certaines touches de caractères spéciaux (par exemple, $, & ou @ etc.) dans les champs numériques.
  • Lorsque vous utilisez la combinaison Maj + caractère alphanumérique.
  • Lorsque vous utilisez des champs de date et heure

La configuration de la valeur à l’aide du script n’est pas prise en charge.

change
Indique la valeur saisie ou collée par un utilisateur ou une utilisatrice dans un champ immédiatement après avoir effectué l’action.

La propriété de modification ne fonctionne pas correctement pour les cas suivants :

  • Lorsque vous sélectionnez des textes de remplacement.
  • Lorsque vous supprimez, copiez et collez des textes.
  • Lorsque vous appuyez sur certaines touches de caractères spéciaux (par exemple, $, & ou @ etc.) dans les champs numériques.
  • Lorsque vous utilisez la combinaison Maj + caractère alphanumérique.
  • Lorsque vous utilisez des champs de date et heure

La configuration de la valeur à l’aide du script n’est pas prise en charge.

keydown
Détermine si un utilisateur ou une utilisatrice appuie sur une touche fléchée pour effectuer une sélection. Cette propriété est disponible uniquement pour les zones de liste et les listes déroulantes.
Aucune
modifier
Détermine l’utilisation de la touche de modification (par exemple, Ctrl sous Microsoft® Windows®) lors de l’exécution d’un événement particulier.
Aucune

$host host

Propriété
Description
Exception
apptype
Retourne le type d’application de l’hôte. Uniquement disponible pour les applications clientes.
Renvoie HTML 5.
name
Renvoie le nom de l’application active.
Renvoie le nom du navigateur et sa version. Par exemple, dans le navigateur Chrome, la valeur renvoyée est Chrome <version>.
numPages
Renvoie le nombre de pages que compte le document.
La politique de pagination des formulaires HTML5 n’est pas identique à celle des formulaires PDF. Les API numPages peuvent renvoyer des valeurs différentes dans les deux cas.
platform
Renvoie une chaîne représentant la plateforme de l’ordinateur qui exécute le script.
Aucune
title
Indique le titre du document. Cette méthode est uniquement disponible pour les applications clientes.
Elle renvoie le titre du document HTML dans un formulaire plutôt que le titre des métadonnées du formulaire comme dans le cas de formulaires PDF.
version
Renvoie une chaîne représentant le numéro de version de l’application active.
Elle renvoie la version du formulaire.
calculationsEnabled
Indique si les scripts de calcul seront exécutés ou non.
Aucune
validationsEnabled
Indique si les scripts de validation seront exécutés ou non.
Aucune
pageUp
Permet de revenir à la page précédente.
Les formulaires HTML5 ne suivent pas la même politique de pagination qu’un formulaire PDF, la page précédente d’un formulaire HTML5 est donc différente de la page précédente d’un formulaire PDF.
pageDown
Atteint la page suivante d’un formulaire. Utilisez la méthode pageDown au moment de l’exécution.
setFocus
Définit le focus du clavier sur le champ spécifié. Le champ est indiqué sous la forme d’un objet ou par l’expression SOM du champ. Cette méthode est uniquement disponible pour les applications clientes.
resetdata
Rétablit les valeurs par défaut des champs dans un document.
Efface toutes les données d’un formulaire en les remplaçant par les données fusionnées plutôt qu’en restaurant les valeurs par défaut.
messageBox
Affiche à l’écran une boîte de dialogue. Cette méthode est uniquement disponible pour les applications clientes.
La boîte de message de type Oui/Non est convertie en OK/Annuler. La boîte de message avec trois boutons n’est pas prise en charge.
currentPage

Définit la page active d’un document lors de l’exécution.

Les valeurs de page sont de base 0, de sorte que la première page d’un document renvoie la valeur 0.

La propriété currentPage est disponible lorsque layout:ready s’exécute sur un client. En revanche, elle n’est pas disponible lorsque l’événement layout:ready s’exécute sur le serveur, car l’exécution de la propriété doit être précédée par celle de la disposition du formulaire.

Aucune

field field

Propriété
Description
Exception
presence
Contrôle la participation de l’objet associé dans différentes phases de traitement. Si l’objet est un conteneur, le contenu du conteneur hérite des restrictions que cette commande applique.
Aucune
access
Définit l’accès de l’utilisateur ou de l’utilisatrice au contenu.
Ne fonctionne pas pour le groupe d’exclusion. De plus, les formulaires HTML5 traitent de la même façon les objets non interactifs et protégés.
name
Identificateur utilisé pour identifier cet élément dans les expressions de script.
Les formulaires HTML5 ne permettent pas de définir la propriété de nom des objets. Il s’agit de la propriété en lecture seule pour les formulaires HTML5.
value
Élément de contenu qui inclut une unité unique du contenu de données.
Aucune
rawValue
Indique la valeur non formatée de ce champ.
Aucune
formattedValue
Indique la valeur formatée de ce champ.
La configuration de formattedValue dans le script n’est pas prise en charge.
editValue
Indique la valeur de modification de ce champ.
La configuration de editValue dans le script n’est pas prise en charge.
formatMessage
Indique la chaîne de message pour la validation du format pour ce champ.
La configuration de formatMessage dans le script n’est pas prise en charge.
fillcolor
Indique la valeur de la couleur d’arrière-plan de ce champ. Vous devez définir la propriété border.fill.presence pour l’afficher séparément.
La couleur par défaut du champ n’est pas correctement renvoyée.
border
L’objet border décrit la bordure entourant un objet.
ui
L’objet ui renferme la description d’interface utilisateur d’un objet de formulaire.
mandatory
Indique la valeur nullTest pour le champ.
borderColor
Indique la valeur de la couleur de la bordure pour ce champ. Vous devez définir la propriété border.edge.presence pour l’afficher séparément.
La couleur de la bordure par défaut du champ n’est pas correctement renvoyée.
length
Le nombre d’éléments dans la liste.
Aucune
addItem
Ajoute de nouveaux éléments au champ actuel.
Aucune
clearItem
Supprime tous les éléments du champ.
Aucune
boundItem
Obtient la valeur liée d’un élément d’affichage spécifique dans une liste déroulante ou une zone de liste.
Aucune
execCalculate
Exécute le script de calcul du champ.
Aucune
execValidate
Exécute le script de validation du champ.
Aucune
execEvent
Exécute le script d’événement de l’objet.
Aucune
getItemState
Renvoie l’état de sélection de l’élément spécifié.
Aucune
setItemState
Définit l’état de sélection de l’élément spécifié.
Aucune
getDisplayItem
Récupère le texte d’affichage de l’élément pour l’index d’élément spécifié.
Aucune
getSaveItem
Récupère la valeur de données pour l’index d’élément spécifié.
Aucune
deleteItem
Supprime l’élément à l’index spécifié.
Aucune
setItems
Définit les éléments spécifiés dans le champ actuel. Remplace les éléments préexistants.
Aucune
h
Mesure de la hauteur pour la disposition.
Aucune
w
Mesure indiquant la largeur pour la disposition.
Aucune
x
Indique la coordonnée x du point d’ancrage du conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec une disposition positionnée.
Aucune
y
Indique la coordonnée y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec une disposition positionnée.
Aucune
caption
L’objet caption décrit un libellé descriptif associé à un objet de conception de formulaire.
Aucune
validate
L’objet validate contrôle la validation des données fournies par l’utilisateur ou l’utilisatrice sur un formulaire. L’objet validate peut être activé plusieurs fois pendant la durée de vie d’un formulaire.
Aucune
parentSubform
Indique le sous-formulaire (page) parent de ce champ.
Renvoie toujours le sous-formulaire parent au lieu de renvoyer le premier sous-formulaire parent hors portée.
selectedIndex
Index du premier élément sélectionné.
Aucune

Formulaire form

Propriété
Description
Exception
formNodes
Renvoie une liste de tous les objets de modèle de formulaire liés à un objet de données spécifié.

InstanceManager instancemanager

Propriété
Description
name
Identificateur utilisé pour identifier cet élément dans les expressions de script.
occur
Décrit les contraintes liées au nombre d’instances autorisées pour son conteneur englobant.
min
Indique le nombre minimum d’instances qui peuvent être instanciées.
max
Indique le nombre maximum d’instances qui peuvent être instanciées.
count
Indique le nombre actuel d’instances instanciées.
setInstances
Ajoute ou supprime les sous-formulaires ou jeux de sous-formulaires spécifiés de ce nœud.
addInstance
Ajoute une nouvelle instance d’un sous-formulaire ou d’un jeu de sous-formulaires à ce nœud.
removeInstance
Supprime un sous-formulaire ou un jeu de sous-formulaires de ce nœud.
moveInstance
Déplace un objet enfant d’un objet de modèle de formulaire vers un autre emplacement spécifié dans le modèle de formulaire. Les informations de modèle de données correspondantes pour l’objet sont également déplacées dans le modèle de données.
insertInstance
Insère une nouvelle instance d’un sous-formulaire ou d’un jeu de sous-formulaires à ce nœud.

list list

Propriété
Description
length
Le nombre d’éléments dans la liste.
item
Index à base zéro dans la collection.
append
Ajoute un nœud à la fin de la liste de nœuds.
remove
Supprime un nœud de la liste.
insert
Insère un nœud avant un nœud spécifique dans la liste de nœuds.

node node

Propriété
Description
Exception
createNode
Crée un nœud à partir d’un nom de classe valide.
Aucune
isContainer
Indique si cet objet est un objet conteneur.
Aucune
isNull
Indique si la valeur de données actuelle est une valeur nulle.
Aucune
resolveNode
Évalue l’expression SOM spécifiée, en commençant par l’objet de modèle d’objet de formulaire XML actif, et renvoie la valeur de l’objet spécifié dans l’expression SOM.
Aucune
resolveNodes
Évalue l’expression SOM spécifiée, en commençant par l’objet de modèle d’objet de formulaire XML actif, et renvoie la valeur de l’objet spécifié dans l’expression SOM.
Aucune
oneOfChild
Crée un nœud à partir d’un nom de classe valide.
Aucune
getElement
Renvoie un objet enfant spécifié.
Aucune
getAttribute
Récupère une valeur de propriété spécifiée.
Aucune
setAttribute
Définit la valeur d’une propriété spécifiée.
Aucune

model model

Propriété
Description
Exception
N/A
N/A
N/A

Sous-formulaire subform

Propriété
Description
Exception
instanceIndex
Spécifie l’index de l’objet, par rapport aux autres instances instanciées.
Aucune
execEvent
Exécute le script d’événement de l’objet.
Aucune
getInvalidObjects
Renvoie une liste de nœuds contenus dans le sous-formulaire (inclus) qui n’ont pas réussi le test de validation.
Aucune
border
L’objet border décrit la bordure entourant un objet.
Aucune
borderColor
Indique la valeur de la couleur de la bordure pour ce champ. Vous devez définir la propriété border.edge.presence pour l’afficher séparément.
Aucune
h
Mesure de la hauteur pour la disposition.
Aucune
w
Mesure indiquant la largeur pour la disposition.
Aucune
x
Indique la coordonnée x du point d’ancrage du conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec une disposition positionnée.
Aucune
y
Indique la coordonnée y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec une disposition positionnée.
Aucune
validate
L’objet validate contrôle la validation des données fournies par l’utilisateur ou l’utilisatrice sur un formulaire. L’objet validate peut être activé plusieurs fois pendant la durée de vie d’un formulaire.
Aucune
name
Identificateur utilisé pour identifier cet élément dans les expressions de script.
Aucune
presence
Indique si un objet est visible ou non.
Aucune
access
Définit l’accès de l’utilisateur ou de l’utilisatrice au contenu d’un objet conteneur, tel qu’un sous-formulaire.
Aucune
execValidate
Calcule l’index d’un sous-formulaire ou d’un jeu de sous-formulaires en fonction de son emplacement par rapport à d’autres instances du même objet de formulaire.
Aucune
InstanceManager
L’objet instanceManager gère la création, la suppression et le déplacement de l’instance des objets de modèle de formulaire.
Aucune

submit submit

Propriété
Description
target
URL à laquelle les données sont envoyées. L’omission de cet attribut implique que l’application de traitement XFA obtienne l’URI à l’aide d’une technique spécifique au produit, telle que l’accès aux informations spécifiques au produit dans l’objet config.

tree tree

Propriété
Description
Exception
nodes
Renvoie une liste de tous les objets enfants de l’objet actuel.
  • Non pris en charge pour xfa.nodes, desc.
  • Les nombres de nœuds rapportés pour PDF et HTML sont différents.
name
Indique le nom de ce nœud.
La configuration du nom à l’aide de scripts n’est pas autorisée en format HTML.
parent
Récupère le parent de ce nœud.
Aucune
index
Renvoie la position de ce nœud dans sa collection de nœuds de même nom, compris dans la plage indiquée, ayant une relation de nœuds enfants identiques.
Aucune
somExpression
Récupère l’expression SOM de ce nœud.
Aucune
resolveNode
Évalue l’expression SOM spécifiée, en commençant par l’objet de modèle d’objet de formulaire XML actif, et renvoie la valeur de l’objet spécifié dans l’expression SOM.
Aucune
resolveNodes
Évalue l’expression SOM spécifiée, en commençant par l’objet de modèle d’objet de formulaire XML actif, et renvoie la valeur de l’objet spécifié dans l’expression SOM.
Aucune

subformset subformset

Propriété
Description
Exception
InstanceManager
L’objet instanceManager gère la création, la suppression et le déplacement de l’instance des objets de modèle de formulaire.
Aucune

content content

Propriété
Description
Exception
isNull
Indique si la valeur de données actuelle est nulle.

dataValue datavalue

Propriété
Description
Exception
isNull
Indique si la valeur de données actuelle est nulle.

edge edge

Propriété
Description
Exception
couleur
La propriété de couleur décrit une couleur unique pour l’objet pattern.
  • La valeur par défaut ne peut pas être récupérée.
  • Les modifications sont répercutées dans le modèle et disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

fill fill

Propriété
Description
Exception
couleur
Les propriétés de couleur définissent une couleur unique de remplissage.
  • La valeur par défaut ne peut pas être récupérée.
  • Les modifications sont répercutées dans le modèle et disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

linear linear

Propriété
Description
Exception
couleur
La propriété de couleur décrit une couleur unique pour un remplissage dégradé linéaire sur un formulaire.
  • La valeur par défaut ne peut pas être récupérée.
  • Les modifications sont répercutées dans le modèle et disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

line line

Propriété
Description
Exception
edge
L’objet edge décrit un arc, une ligne ou un côté d’une bordure ou d’un rectangle.
Les attributs tels que la couleur, la limite, etc. ne sont pas pris en charge.

pattern pattern

Propriété
Description
Exception
couleur
La propriété de couleur décrit une couleur unique pour l’objet pattern.
  • La valeur par défaut ne peut pas être récupérée.
  • Les modifications sont répercutées dans le modèle et disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

radial radial

Propriété
Description
Exception
couleur
La propriété de couleur décrit une couleur unique pour l’objet radial.
  • La valeur par défaut ne peut pas être récupérée.
  • Les modifications sont répercutées dans le modèle et disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

stipple stipple

Propriété
Description
Exception
couleur
La propriété de couleur décrit une couleur unique pour l’objet stipple.
  • La valeur par défaut ne peut pas être récupérée.
  • Les modifications sont répercutées dans le modèle et disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

draw draw

Propriété
Description
Exception
ui
L’objet ui renferme la description d’interface utilisateur d’un objet de formulaire.
caption
L’objet caption décrit un libellé descriptif associé à un objet de conception de formulaire.
presence
Indique si un objet est visible ou non.
name
Identificateur qui permet de désigner cet objet ou cet événement dans les expressions de script.
La définition de la valeur au moment de l’exécution n’est pas prise en charge.
value
L’objet value renferme une unité de contenu unique.

corner corner

Propriété
Description
Exception
couleur
La propriété de couleur décrit une couleur unique de l’objet corner.
  • La valeur par défaut ne peut pas être récupérée.
  • Les modifications sont répercutées dans le modèle et disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

checkButton checkbutton

Propriété
Description
Exception
border
L’objet border décrit la bordure entourant un objet checkButton.
Les modifications sont répercutées dans le modèle et disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments HTML. Par conséquent, les modifications ne sont pas répercutées dans l’IU.

choiceList choicelist

Propriété
Description
Exception
border
L’objet border décrit la bordure entourant un objet choiceList.

dateTimeEdit datetimeedit

Propriété
Description
Exception
border
L’objet border décrit la bordure entourant un objet dateTimeedit.

Image image

Propriété
Description
Exception
contentType
Spécifie le type de contenu présent dans le document référencé, à savoir un type MIME.
Aucune
name
Identificateur utilisé pour identifier cet élément dans les expressions de script.
Aucune

imageEdit imageedit

Propriété
Description
Exception
border
L’objet border décrit la bordure entourant un objet imageEdit.

numericEdit numericedit

Propriété
Description
Exception
border
L’objet border décrit la bordure entourant un objet.
aucune

object object

Propriété
Description
Exception
className
Détermine le nom de la classe de cet objet.
aucune

rectangle rectangle

Propriété
Description
Exception
edge
L’objet edge décrit un arc, une ligne, ou le côté d’une bordure ou d’un rectangle.
Les attributs tels que la couleur, la limite, etc. ne sont pas pris en charge.

textEdit textedit

Propriété
Description
Exception
border
L’objet border décrit la bordure entourant un objet.
Aucune

exclGroup exclgroup

Propriété
Description
Exception
disposition
Indique la stratégie de disposition utilisée par cet objet.
Aucune
border
Indique la bordure entourant ce champ.
Aucune
mandatory
Indique la valeur nullTest pour le champ.
Aucune
borderColor
Indique la valeur de couleur de bordure pour ce champ. Une bordure doit être définie avant de pouvoir modifier la couleur par script.
Aucune
borderWidth
Indique la largeur de la bordure pour ce champ.
Aucune
h
Mesure de la hauteur pour la disposition.
Aucune
transient
Spécifie si l’application de traitement doit enregistrer la valeur du groupe d’exclusion lors de l’envoi du formulaire ou d’une opération de sauvegarde.
Aucune
w
Mesure indiquant la largeur pour la disposition.
Aucune
x
Indique la coordonnée x du point d’ancrage du conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec une disposition positionnée.
Aucune
y
Indique la coordonnée y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec une disposition positionnée.
Aucune
caption
L’objet caption décrit un libellé descriptif associé à un objet de conception de formulaire.
Aucune
validate
L’objet validate contrôle la validation des données fournies par l’utilisateur ou l’utilisatrice sur un formulaire. L’objet validate peut être activé plusieurs fois pendant la durée de vie d’un formulaire.
Aucune
dataNode
Obtient le nœud de données auquel est lié un nœud de formulaire après la fusion.
Aucune
presence
Indique si un objet est visible ou non.
access
Définit l’accès de l’utilisateur ou de l’utilisatrice au contenu d’un objet conteneur, tel qu’un sous-formulaire.
Pour les éléments individuels dans l’exclgrp, il renvoie toujours ouvert.
name
Identificateur qui permet de désigner cet objet ou cet événement dans les expressions de script.
Aucune
members
Indique les membres du groupe d’exclusion.
Aucune
selectedMember
Renvoie le membre sélectionné d’un groupe d’exclusion.
Aucune
execCalculate
Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.
Aucune
calculate
L’objet calculate contrôle le calcul de la valeur d’un champ.
Aucune

arc arc

Propriété
Description
Exception
edge
L’objet edge décrit un arc, une ligne, ou le côté d’une bordure ou d’un rectangle.
Les attributs tels que la couleur, la limite, etc. ne sont pas pris en charge.

bordure border

Propriété
Description
Exception
edge
L’objet edge décrit un arc, une ligne, ou le côté d’une bordure ou d’un rectangle.
Les attributs tels que la couleur, la limite, etc. ne sont pas pris en charge.

$layout layout

Propriété
Description
Exception
h
Détermine la hauteur d’un objet de conception de formulaire donné.
  • La propriété de hauteur (h) n’est pas prise en charge pour les zones de page et de contenu.
  • Le paramètre « Décalage à partir de la première zone de contenu où l’objet XFA-Form se produit » n’est pas pris en charge.
w
Détermine la largeur d’un objet de conception de formulaire donné.
  • La propriété de largeur (w) n’est pas prise en charge pour les zones de page et de contenu.
  • Le paramètre « Décalage à partir de la première zone de contenu où l’objet XFA-Form se produit » n’est pas pris en charge.
x
Détermine la coordonnée x d’un objet de conception de formulaire donné par rapport à son objet parent.
  • La propriété de coordonnée x (x) n’est pas prise en charge pour les zones de page et de contenu.
  • Le paramètre « Décalage à partir de la première zone de contenu où l’objet XFA-Form se produit » n’est pas pris en charge.
y
Détermine la coordonnée y d’un objet de conception de formulaire donné par rapport à son objet parent.
  • La propriété de coordonnée y (y) n’est pas prise en charge pour les zones de page et de contenu.
  • Le paramètre « Décalage à partir de la première zone de contenu où l’objet XFA-Form se produit » n’est pas pris en charge.
pagecount
Détermine le nombre de pages du formulaire actif.
  • La méthode layout.pageCount() renvoie des valeurs différentes pour les formulaires PDF et HTML.
  • Lors de la diminution du nombre de pages en masquant un objet, la méthode abspagecount renvoie une valeur incorrecte.
pagecontent
Récupère les types d’objets de conception de formulaire à partir d’une page spécifiée d’un formulaire.
Aucune
absPageCount
Détermine le nombre de pages du formulaire actif.
  • La méthode layout.pageCount() renvoie des valeurs différentes pour les formulaires PDF et HTML.
  • Lors de la diminution du nombre de pages en masquant un objet, la méthode abspagecount renvoie une valeur incorrecte.

items items

Propriété
Description
Exception
presence
Indique si un objet est visible ou non.
Aucune

FormCalc formcalc

FormCalc est un langage spécifique à XFA qui permet de créer une logique centrée sur les formulaires électroniques et des racines de calcul. FormCalculation fournit un puissant ensemble de fonctions de création.

Fonctions FormCalc prises en charge formcalc-supported-functions

Prise en charge des expressions FormCalc formcalc-expression-support

Catégorie
Description
Échantillon
Expression simple
Ajouter, soustraire, multiplier, diviser et parenthèses
(a+b)*3
Déclaration de variable
Définir une variable
var a
var a=3
a=3
Expression logique
  • Logique (et/ou)
  • Comparaison (supérieur/inférieur/égal)
A or 1
1 <> 2
A NE B
A or 1
1 <> 2
A NE B
Expression if
if (a>b) then 2 endif
quelques instants,
while (i lt 5) do i = i + 1 endwhile
pour
for i = 100 downto 1
do s = s + i endfor
for each
for each i in (1, 2, 3)
do s = s + i endfor
déclaration de fonction
Définition d’une fonction personnalisée dans FormCalc
func foo(n) do var f = n endfunc

Prise en charge des API Acrobat acrobat-api-support

  1. Fonctions arithmétiques

    1. Abs()
    2. Avg()
    3. Ceil()
    4. Décompte()
    5. Floor()
    6. Max()
    7. Min()
    8. Mod()
    9. Round()
    10. Sum()

  2. Fonctions scientifiques

    1. Acos()
    2. Asin()
    3. Atan()
    4. Atan2()
    5. Cos()
    6. Sin()
    7. Tan()
    8. Exp()
    9. Log()
    10. Pow()
    11. Sqrt()
    12. Deg2Rad()
    13. Rad2Deg()
    14. Pi()

  3. Fonctions financières

    1. Apr()
    2. Cterm()
    3. Fv()
    4. Ipmt()
    5. Npv()
    6. Pmt()
    7. Ppmt()
    8. Pv()
    9. Rate()
    10. Terme()

  4. Fonctions logiques

    1. Choose()
    2. If()
    3. Oneof()
    4. Within()

  5. Fonctions de chaîne

    1. At()
    2. Concat()
    3. Left()
    4. Len()
    5. Lower()
    6. Ltrim()
    7. Remplacer()
    8. Right()
    9. Rtrim()
    10. Space()
    11. Stuff()
    12. Substr()
    13. Upper()
    14. WordNum()

  6. Date et heure

    1. Date()
    2. num2date()
    3. DateFmt()
API
Description
Aberration
console.println()
Cette API Acrobat transfère la sortie vers la console JavaScript.
app.alert()
Cette API Acrobat envoie un message d’alerte via une boîte de dialogue contextuelle JavaScript.
app.beep()
Entraîne l’émission d’un son par le système.
Aucune action n’est effectuée.
app.execDialog()
Affiche une boîte de dialogue modale à l’utilisateur ou à l’utilisatrice. Les boîtes de dialogue modales doivent être fermées par l’utilisateur ou l’utilisatrice avant que l’application hôte ne puisse être directement utilisée à nouveau.
Aucune action n'est effectuée.
app.launchURL()
Lance une URL dans une fenêtre du navigateur.
app.setInterval()
Spécifie un script JavaScript et une période. Le script est exécuté chaque fois que la période s’écoule. La valeur renvoyée par cette méthode doit être conservée dans une variable JavaScript. Dans le cas contraire, l’objet interval est soumis au nettoyage de la mémoire, ce qui entraînerait l’arrêt de l’horloge. Pour terminer l’exécution périodique, transmettez l’objet interval renvoyé à clearInterval.
app.setTimeOut()
Spécifie un script JavaScript et une période. Le script est exécuté une seule fois, une fois la période écoulée. La valeur renvoyée par cette méthode doit être contenue dans une variable JavaScript. Dans le cas contraire, l’objet timeout est soumis au nettoyage de la mémoire, ce qui entraînerait l’arrêt de l’horloge. Pour annuler l’événement timeout, transmettez l’objet timeout renvoyé à clearTimeOut.
app.clearInterval()
Annule un intervalle précédemment enregistré et initialement défini par la méthode setInterval.
Dans les formulaires HTML5, l’API ne fonctionne pas correctement.
app.clearTimeOut()
Annule un intervalle timeout précédemment enregistré. Un tel intervalle est initialement défini par setTimeOut.
Dans les formulaires HTML5, l’API ne fonctionne pas correctement.
app.eval()
Exécute un script donné.
app.activeDocs
Tableau contenant l’objet Doc de chaque document actif. Si aucun document n’est actif, activeDocs ne renvoie rien, c’est-à-dire qu’il adopte le même comportement que d = new Array(0) dans le code JavaScript principal.
Renvoie un tableau vide pour les formulaires HTMl5.
app.calculate
Si la valeur est true (valeur par défaut), les calculs peuvent être effectués. Si la valeur est false, les calculs ne sont pas autorisés.
Toujours true pour les formulaires HTMl5.
app.constants
Un objet enveloppant pour différentes valeurs constantes. Actuellement, cette propriété renvoie un objet avec une seule propriété : align.
Les formulaires HTML5 renvoient un objet d’alignement vide.
app.focusRect
Active ou désactive le rectangle ciblé. Le rectangle ciblé correspond au léger trait en pointillés autour des boutons, des cases à cocher, des boutons radio et des signatures pour indiquer que le champ de formulaire est ciblé par le clavier. La valeur true est activée sur le rectangle ciblé.
Toujours true pour les formulaires HTML5.
app.formsVersion
Numéro de version du logiciel de la visionneuse de formulaires. Vérifiez cette propriété pour déterminer si des objets, des propriétés ou des méthodes dans les versions plus récentes du logiciel sont disponibles si vous souhaitez préserver la compatibilité ascendante dans vos scripts.
Toujours 11.001.
app.language
Langue de la visionneuse Acrobat en cours d’exécution.
Toujours « ENU » pour les formulaires HTMl5.

Événements XFA pris en charge supported-xfa-events

Les événements XFA côté client suivants sont pris en charge :

  • Initialiser
  • Valider
  • Calculer
  • Cliquez sur
  • Enter
  • Quitter
  • Modification
  • ValidationState
NOTE
Les formulaires HTML5 sont rendus côté client (navigateur). Utilisez des scripts validate et calculate côté client au lieu des scripts côté serveur.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2