4.2.16 Type image

4.2.16.1 Description

Les attributs de type image permettent d'insérer une image.

4.2.16.2 Représentation

• consultation :

  une balise img alignée à droite.

  

  Figure 38. image - consultation html

  L'image affichée par défaut est une miniature de l'image (sauf si l'option iwidth=auto) au format png.
  3.2.20 Dans le cas d'image jpeg, la miniature est réorientée automatiquement en fonction des données exif de l'image. Par contre, si c'est l'image originale qui est affichée, elle n'est pas réorientée par le navigateur.
  Les navigateurs (pour l'instant) ne tiennent pas compte de l'orientation dans les tags image mais seulement lors de l'affichage direct sur une page.

• modification :

  Un input de type text présentant une miniature de l'image précédemment enregistrée et le nom du fichier, suivi de 3 boutons :

  • pour choisir un nouveau fichier image,
  • restaurer le fichier préalablement enregistré,
  • effacer le fichier image.
  

  Figure 39. image - Modification html

  Au survol de la miniature, une version plus grande est affichée.

  S'il s'agit d'une modification de document et que le fichier est déjà enregistré alors le clic sur le nom du fichier permet de télécharger l'image.

  Des différences de comportement sont présentes en fonction des navigateur. Sur IE < 11, le bouton original "Parcourir" est affiché lorsqu'on clique sur le bouton "...". Le paramètre applicatif "FDL_OLDFILEINPUTCOMPAT" indique si l'attribut doit présenter, de manière systématique, le bouton original "Parcourir"

  

  Figure 40. image - Modification html

• odt :

  Une image.

  

  Figure 41. image - consultation odt

4.2.16.3 Comportement

Lors de l'upload du fichier, il est enregistré dans le vault.

4.2.16.4 Format de stockage

La valeur stockée est l’identifiant vault du fichier (sous la forme <type-mime>|<vaultid>|<file-title>).

Le type utilisé en base de donnée est text.

4.2.16.5 Options

En plus des options communes à tous les types d'attributs, ce type d'attribut dispose des options suivantes :

hideindav

Indique si le fichier apparaît lors de l'accès au moyen du protocole webdav.

Les valeurs possibles sont :

• yes (comportement par défaut)
• no

inline

Indique si l'image' doit être consultée directement dans le navigateur. Dans le cas contraire, le téléchargement est forcé.

Les valeurs possibles sont :

• yes
• no(comportement par défaut)

iwidth

Indique la largeur de l'image dans l'interface web de consultation.

L'image est redimensionnée coté serveur, avec respect des proportions.

Les valeurs possibles sont:

• Une taille en pixels (par exemple 150px).
• auto (dans ce cas, l'image est affichée dans sa taille originale).

La valeur par défaut est 80px.

preventfilechange

Ajoute une contrainte pour que le fichier à remplacer provienne de la dernière version du serveur.

Cela ne bloque pas un changement de fichier mais avertit l'utilisateur dans le cas où le fichier ne correspond pas à cette dernière version.

Lors du téléchargement du fichier un code identifiant la version est ajouté dans le nom du fichier (exemple foo{i47307-56}.ods pour le fichier foo.ods). Lorsque l'utilisateur uploade à nouveau le fichier, le serveur vérifie ce numéro de version. Si le numéro correspond à la dernière version, alors le fichier est accepté. Dans le cas contraire, une confirmation est demandée à l'utilisateur.

Attention: si l'utilisateur renomme le fichier, la vérification échoue, et le serveur demande la confirmation.

Les valeurs possibles sont :

• yes
• no (comportement par défaut)

rn

Indique que le fichier sera renommé sur le serveur.

Les valeurs possibles sont :

• un nom de méthode de la famille courante (par exemple ::myNewName()). La méthode prend en entrée le nom du fichier et doit retourner le nouveau nom sous la forme d'une chaîne de caractères.

Note: Il est recommandé que la méthode fournisse une extension compatible avec le type mime pour l'utilisation ultérieure sur le poste client et les transformations. Pour récupérer l'extension d'un nom de fichier vous pouvez utiliser la fonction getFileExtension de la librairie Lib.FileMime.php