DocumentationAEM 6.4Guide de Forms

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • User
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

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 avant qu’il ne change en réponse aux actions d’un utilisateur. Cette valeur peut être rappelée, comme pour une fonction d’annulation.

Ne fonctionne pas pour les listes déroulantes 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 $, (, ), &, @, etc.) dans les champs numériques sur l’iPad, et
  • Pour le champ 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 agit.
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 $, (, ), &, @, etc.) dans les champs numériques
  • Lorsque vous utilisez la combinaison maj+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.

modifier
Indique la valeur saisie ou collée par un utilisateur 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 $, (,), &, @, etc.) dans les champs numériques
  • Lorsque vous utilisez la combinaison maj+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 appuie sur la 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 si la touche de modification (par exemple, Ctrl sous Microsoft® Windows®) est enfoncée lors de l’exécution d’un événement particulier.
Aucune

$host host

Propriété
Description
Exception
apptype
Renvoie le type d’application de l’hôte. Disponible uniquement 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 du document.
La politique de pagination des formulaires HTML5 n’est pas identique à la politique de pagination PDF forms. L’API numPages peut 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. Il est disponible uniquement pour les applications clientes.
Elle renvoie le titre du document de HTML dans le formulaire, plutôt que le titre des métadonnées de formulaire comme dans le cas des PDF forms.
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.
Aucune
pageUp
Accède à la page précédente.
Les formulaires HTML5 ne suivent pas la même politique de pagination que le formulaire PDF. Par conséquent, la page précédente d’un formulaire HTML5 diffère de la page précédente d’un formulaire PDF.
pageDown
Accède à la page suivante d’un formulaire. Utilisez la méthode pageDown au moment de l’exécution.
setFocus
Définit la sélection au clavier sur le champ spécifié. Le champ est spécifié sous la forme d’un objet ou par l’expression SOM du champ. Il est disponible uniquement 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 avec des données fusionnées, plutôt que de les restaurer à des valeurs par défaut.
messageBox
Affiche une boîte de dialogue à l’écran. Il est disponible uniquement pour les applications client
La zone de message de type Oui/Non est convertie en OK/Annuler. La zone de message comportant trois boutons n’est pas prise en charge.
currentPage

Définit la principale page d’un document au moment de l’exécution.

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

La propriété currentPage est disponible lorsque layout:ready s’exécute sur un client. Cependant, elle n’est pas disponible lorsque layout:ready s’exécute sur le serveur, car la propriété ne s’exécute que lorsque la disposition du formulaire s’exécute.

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 ce contrôle applique.
Aucune
access
Contrôle l’accès de l’utilisateur au contenu.
Ne fonctionne pas pour le groupe d’exclusion. De plus, les formulaires HTML5 traitent de la même manière 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 d’une propriété en lecture seule pour les formulaires HTML5.
value
Élément de contenu qui renferme une unité unique de 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
Nombre d’éléments dans la liste.
Aucune
addItem
Ajoute de nouveaux éléments au champ actif.
Aucune
clearItem
Supprime tous les éléments du champ.
Aucune
boundItem
Obtient la valeur liée d’un élément d’affichage spécifique d’une liste déroulante ou d’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 actif. Il remplace les éléments préexistants.
Aucune
h
Mesure de la hauteur de la mise en page.
Aucune
w
Mesure indiquant la largeur de la mise en page.
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 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 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 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 sur ce noeud.

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 noeud avant un noeud spécifique dans la liste de noeuds.

node node

Propriété
Description
Exception
createNode
Crée un noeud à 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
Evalue 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
Evalue 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 noeud à partir d’un nom de classe valide.
Aucune
getElement
Renvoie un objet enfant spécifié.
Aucune
getAttribute
Obtient 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 des noeuds 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 de la mise en page.
Aucune
w
Mesure indiquant la largeur de la mise en page.
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 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 disposition positionnée.
Aucune
validate
L’objet validate contrôle la validation des données fournies par l’utilisateur 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 la visibilité d’un objet.
Aucune
access
Contrôle l’accès de l’utilisateur 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

envoyer submit

Propriété
Description
cible
URL à laquelle les données sont envoyées. L’omission de cet attribut implique que l’application de traitement XFA obtient 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 de configuration.

tree tree

Propriété
Description
Exception
nodes
Renvoie une liste de tous les objets enfants de l’objet actif.
  • 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 noeud.
La définition du nom à l’aide de scripts n’est pas autorisée par HTML.
parent
Obtient le parent pour ce noeud.
Aucune
index
Renvoie la position de ce noeud dans sa collection de noeuds de même nom, compris dans la plage indiquée, comme les noeuds de relation enfant.
Aucune
somExpression
Obtient l’expression SOM de ce noeud.
Aucune
resolveNode
Evalue 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
Evalue 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 la valeur nulle.

dataValue datavalue

Propriété
Description
Exception
isNull
Indique si la valeur de données actuelle est la valeur 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 sont disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments de 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 sont disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments de 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 sont disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments de HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

ligne 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 casquette, 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 sont disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments de 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 sont disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments de 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é color 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 sont disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments de 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 la visibilité d’un objet.
name
Indique un identifiant qui peut être utilisé pour spécifier 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 pour 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 sont disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments de 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 sont disponibles pour les scripts, mais ne sont pas synchronisées avec les éléments de HTML. Par conséquent, les modifications ne sont pas répercutées dans l’interface utilisateur.

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
Indique le type de contenu dans le document référencé, exprimé sous la forme d’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

objet 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 un côté d’une bordure ou d’un rectangle.
Les attributs tels que la couleur, la casquette, 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 mise en page à utiliser 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 la couleur de la 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 de la mise en page.
Aucune
transient
Indique si l’application de traitement doit enregistrer la valeur du groupe d’exclusion dans le cadre d’un envoi de formulaire ou d’une opération d’enregistrement.
Aucune
w
Mesure indiquant la largeur de la mise en page.
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 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 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 sur un formulaire. L’objet validate peut être activé plusieurs fois pendant la durée de vie d’un formulaire.
Aucune
dataNode
Obtient le noeud de données auquel un noeud de formulaire est lié après la fusion.
Aucune
presence
Indique la visibilité d’un objet.
access
Contrôle l’accès de l’utilisateur au contenu d’un objet conteneur, tel qu’un sous-formulaire.
Pour les éléments individuels dans l’exclgrp, il renvoie toujours ouvert.
name
Indique un identifiant qui peut être utilisé pour spécifier cet objet ou cet événement dans les expressions de script.
Aucune
membres
Indiquez 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 un côté d’une bordure ou d’un rectangle.
Les attributs tels que la couleur, la casquette, etc. ne sont pas pris en charge.

bordure border

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 casquette, 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é 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é 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é 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é 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 de PDF et de 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 de PDF et de 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 la visibilité d’un objet.
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. FormCalcul 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éfinition d’une variable
var a
var a=3
a=3
Expression logique
  • Logique (et/ou)
  • Comparaison (supérieur/inférieur/égal)
A ou 1
1 <> 2
A NE B
A ou 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. Somme()

  2. Fonctions scientifiques

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

  3. Fonctions financières

    1. Avr()
    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. Dans()

  5. Fonctions de chaîne

    1. dans/le()
    2. Concat()
    3. Gauche()
    4. Len()
    5. Lower()
    6. Ltrim()
    7. Remplacer()
    8. Droite()
    9. Rtrim()
    10. Espace()
    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 vide la sortie dans la console JavaScript.
app.alert()
Cette API Acrobat envoie un message d’alerte par le biais d’une fenêtre contextuelle JavaScript.
app.beep()
Permet au système de jouer un son.
Aucune action n’est effectuée.
app.execDialog()
Présente une boîte de dialogue modale à l’utilisateur. Les boîtes de dialogue modales doivent être fermées par l’utilisateur pour que l’application hôte puisse à nouveau être directement utilisée.
Aucune action n’est effectuée.
app.launchURL()
Lance une URL dans une fenêtre de navigateur.
app.setInterval()
Indique 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 contenue 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 mettre fin à l’exécution périodique, transmettez l’objet interval à clearInterval.
app.setTimeOut()
Indique un script JavaScript et une période. Le script est exécuté une seule fois, une fois le délai écoulé. 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 provoquerait l’arrêt de l’horloge. Pour annuler l’événement de délai d’expiration, transmettez l’objet de délai d’expiration renvoyé à clearTimeOut.
app.clearInterval()
Annule un intervalle précédemment enregistré initialement défini par la méthode setInterval.
Dans les formulaires HTML5, l’API ne fonctionne pas correctement.
app.clearTimeOut()
Annule un intervalle de délai d’expiration enregistré précédemment. Cet 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
Un tableau contenant l’objet Doc pour chaque principal document. Si aucun document n’est principal, activeDocs ne renvoie rien ; en d’autres termes, il a 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 HTMl5 Forms.
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 et désactive le rectangle ciblé. Le rectangle ciblé est la ligne pointillée faible autour des boutons, cases à cocher, boutons radio et signatures pour indiquer que le champ de formulaire est sélectionné par le clavier. La valeur true active le rectangle ciblé.
Toujours true pour les formulaires HTML5.
app.formsVersion
Numéro de version du logiciel de formulaires de visionneuse. Vérifiez cette propriété pour déterminer si des objets, des propriétés ou des méthodes dans des versions plus récentes du logiciel sont disponibles si vous souhaitez maintenir 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). Il est recommandé d’utiliser des scripts validate et calculate côté client au lieu des scripts côté serveur.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da