new Image()

Description

Acteur Image permettant d'afficher une image.

Type : display/image

Details

Members


<readonly> accessories :Object

Description

Obtient la liste des accessoires.

Chaque accessoire est accessible par sa clé :

this.accessories.log.properties.onActorPropertyChanged = true;
			

pour accéder à l'accessoire log préalablement créé et activer la journalisation au changement de propriété de l'acteur.

La gestion des accessoires s'effectue avec les méthodes : Actor.BaseActor#createAccessory et Actor.BaseActor#removeAccessory

Details
Object

<readonly> actor :Element

Description

L'élément DOM de l'acteur.


Attention! L'élément n'est pas accessible dans tous les scripts.

Details
Element

décrire les évènements


<readonly> additionals :Synapps.PrototypedBase

Description

Obtient les propriétés additionnelles.


<readonly> BaseAccessory :BaseAccessory

Description

Obtient la classe de base des accessoire pour en définir des nouveaux

Details
BaseAccessory

dataContext :any

Description

Obtient ou définit le contexte de donnée.

Le contexte de donnée est obtenu par ruissellement si rien n'est définit au niveau de l'objet.

Details
any

<readonly> dataContextualParent :any

Description

Parent de donnée qui participe au ruissellement.

Details
any

<readonly> dataStores :REDY.Synapps.DataStores|HW.Synapps.DataStores

Description

Obtient les magasins de données de la synapp.


<readonly> events' :Object

Description

Obtient les évènements

Details
Object

<readonly> inBindingsRegister :Register

Description

Obtient le registre des liaisons qui utilisent l'objet comme source.

Details
Register

<readonly> inheritedDataContext :any

Description

Contexte de donnée ruisselé.

Details
any

<readonly> isDataContextual :Boolean

Description

Est-ce un objet qui participe au ruissellement de donnée.

Details
Boolean

<readonly> isDestroyed :Boolean

Description

Vrai quand l'acteur est détruit.

Details
Boolean

<readonly> isDestroying :Boolean

Description

Vrai quand l'acteur est en train d'être détruit.

Details
Boolean

<readonly> isLeadActor :Boolean

Description

Est-ce un acteur principal ?

Details
Boolean

<readonly> key :string

Description

La clé unique de l'acteur.

Son unicité est valable dans le contexte de la scène ou du composite parent direct de l'acteur.

Details
string

<readonly> leadActor :Actor.BaseActor

Description

Obtient l'acteur principal de la scène ou composite présentant l'acteur.

Details

<readonly> parent :Actor.BaseActor

Description

Acteur parent.

Peut être absent si l'acteur est le principal.

Details

<readonly> properties :Actor.Display.ImageProperties

Description

Obtient les propriétés de l'acteur.


<readonly> rootScene :Synapps.Scene

Description

Obtient la scène racine.

Ce n'est pas forcément la scène parente directe de l'acteur.

Details

<readonly> scene :Synapps.Scene

Description

Première scène parente de l'acteur.

Ce n'est pas forcément la scène parente directe de l'acteur ni même la scène racine.

Details

<readonly> stage :Stage

Description

Scene ou Composite parent directe de l'acteur.

Details
Stage

<readonly> styleName :String

Description

Le nom du style de l'acteur.


Pour changer de style, il faut utiliser Actor.BaseActor#changeStyleName

Details
String

<readonly> synapp :Synapps.Synapp

Description

Obtient la Synapp.

Details

<readonly> type :string

Description

Type de l'acteur.

Details
string

<readonly> uniqClass :string

Description

Classe CSS unique de l'acteur.

Elle permet de sélectionner l'élément du DOM de l'acteur.

Details
string

<readonly> uniqPath :string

Description

Chemin unique de l'acteur.

Details
string

Methods


changeStyleName( styleName )

Description

Changer le nom du style de l'acteur.

Parameters
Name Type Description
styleName String

Nom du style à appliquer.

Details

Que se passe t il si le nom de style ne correspond à aucun défini ?


createAccessory( key, setup, saveInSetup ) → {Accessory}

Parameters
Name Type Description
key *

Clé unique.

setup *
saveInSetup *
Returns

L'accessoire créé.

Details

à documenter. Création d'une instance d'accessoire.


createBasicBinding( targetValuePath, setup [, saveInSetup ] ) → {Binding.BasicBinding}

Description

Création d'une liaison basique.

La source est prise dans le contexte de donnée.

Parameters
Name Type Attributes Default Description
targetValuePath string

Chemin de la cible de la liaison.

setup JSON.BasicBinding
saveInSetup Boolean <optional>
true
Returns

la liaison créée.

Examples
Le `setup` est un objet
```
actor.createBasicBinding('properties.width, { path: 'widthOfPanel' });
```
La propriété largeur de l'acteur est maintenant liée au champ `widthOfPanel` de son contexte de donnée.
Details

createEvent( eventName, eventScriptLines ) → {any}

Description

Crée un évènement dans les events.

Parameters
Name Type Description
eventName String

Nom de l'évènement

eventScriptLines Array.<String> | function

implémentation de l'évènement. Peut être un tableau de ligne de code ou une callback function(context).

Returns

Le retour éventuel dans la définition de l'évènement.

Examples
// avec un tableau de code
this.createEvent('onInit', ['const test = "test!";', 'console.log(context.eventName, test);']);

// avec une fonction
this.createEvent('onInit', context => {
  const test = "test!";
  console.log(context.eventName, test);
});
Details

createInternalBinding( targetValuePath, setup [, saveInSetup ] )

Description

Création d'une liaison interne.

Le type de source permet à la liaison d'aller cherche la bonne source à placer dans le contexte de donnée de la liaison.

Parameters
Name Type Attributes Default Description
targetValuePath string

Chemin de la cible de la liaison.

setup Object
saveInSetup Boolean <optional>
true
Examples
Le `setup` est un objet différent en fonction du type de source.

Pour un acteur :
```
{ sourceKey: '<clé acteur>', path: 'le chemin de la valeur de la source' }
```

getBinding( targetValuePath ) → {Binding}

Description

Obtient une liaison de l'acteur par son chemin de la cible.

Parameters
Name Type Description
targetValuePath string

Chemin de la cible ex.: properties.content

Returns

la liaison demandée ou null si non trouvée.

Details

removeAccessory( key )

Description

Suppression d'un accessoire

Parameters
Name Type Description
key string
Details

removeBinding( targetValuePath )

Description

Suppression d'une liaison sur un chemin cible.

Parameters
Name Type Description
targetValuePath string

Chemin vers la cible de la liaison

Details

removeEvent( eventName )

Description

Supprime un évènement dans les events.

Parameters
Name Type Description
eventName String

Nom de l'évènement à supprimer.

Details

runEvent( eventName, args ) → {any}

Description

Exécute un évènement s'il existe dans les events.

Parameters
Name Type Description
eventName String

Nom de l'évènement

args Object

Arguments à passer dans l'objet de contexte.

Returns

Le retour éventuel dans la définition de l'évènement.

Details

Events


additionals/[additionalName]/binding/onReadTransform

Description

Se produit à la lecture de la source d'une liaison vers une additionnelle additionalName.
Il est possible de transformer la valeur lue pour écrire autre chose dans la cible.


Par exemple l'évènement additionals/myText/binding/onReadTransform se produit lorsque la source de la liaison vers l'additionnelle myText est lue.

Parameters
Name Type Description
context Event.OnBindingTransformContext

Le contexte de l'évènement.

Returns

la valeur lue par défaut.


additionals/[additionalName]/binding/onWriteTransform

Description

Se produit à écriture de la source d'une liaison vers une additionnelle additionalName.
Il est possible de transformer la valeur lue pour écrire autre chose dans la source.


Par exemple l'évènement additionals/myText/binding/onWriteTransform se produit lorsque l'additionnelle myText change et que sa valeur est écrite dans la source.

Parameters
Name Type Description
context Event.OnBindingTransformContext
Returns

la valeur lue par défaut.


additionals/[additionalName]/onValueChanged

Description

Se produit lorsque la valeur de l'additionnelle [additionalName] a changé.


Par exemple l'évènement additionals/myText/onValueChanged se produit lorsque l'additionnelle myText a changé.

Parameters
Name Type Description
context Event.PropertyChangedContext

onClick

Description

Se produit au clic sur acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onComputeLayout

Description

Se produit lorsque l'acteur calcul son gabarit.

Parameters
Name Type Description
context Event.BaseContext

Contexte de l'évènement.

Details

onContextMenu

Description

Se produit lorsque un bouton droit est cliqué pour afficher le menu contextuel.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onCssStyling

Description

Se produit lorsque l'acteur applique son style CSS.

Parameters
Name Type Description
context Event.BaseContext

Contexte de l'évènement.

Details

onDestroy

Description

Se produit au moment de la destruction d'un acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement

Details

onDoubleClick

Description

Se produit au double clic sur acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onFocusIn

Description

Se produit lorsque l'acteur est sur le point d'obtenir le focus.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
focusEvent FocusEvent

L'évènement de focus.

Details

onFocusOut

Description

Se produit lorsque l'acteur est sur le point de perdre le focus.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
focusEvent FocusEvent

L'évènement de clavier.

Details

onInit

Description

Se produit lorsque l'acteur est initialisé.


Attention, l'élément DOM n'est pas encore accessible, ni les autres acteurs présents.

Parameters
Name Type Description
context Event.BaseContext

Contexte de l'évènement.

Details

onKeyDown

Description

Se produit lorsque un touche de clavier est enfoncée dans l'acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
keyboardEvent KeyboardEvent

L'évènement de clavier.

Details

onKeyUp

Description

Se produit lorsque un touche de clavier est relâchée dans l'acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
keyboardEvent KeyboardEvent

L'évènement de clavier.

Details

onMouseDown

Description

Se produit lorsque un bouton de la souris est appuyé au dessus de l'acteur .

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onMouseEnter

Description

Se produit lorsque la souris entre dans acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onMouseLeave

Description

Se produit lorsque la souris sort de l' acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onMouseMove

Description

Se produit lorsque la souris se déplace au dessus de l' acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onMouseOut

Description

Se produit lorsque la souris survol autre chose que l' acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onMouseOver

Description

Se produit lorsque la souris survol l' acteur.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onMouseUp

Description

Se produit lorsque un bouton de la souris est relâché au dessus de l'acteur .

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement de souris.

Details

onPostInit

Description

Se produit juste avant le premier rendu de l'acteur mais après que tous les acteurs de la scène soient initialisés.


On a accès à tous les éléments DOM, liaisons, ...

Parameters
Name Type Description
context Event.BaseContext
Details

onPropertyChanged

Description

Se produit lorsque n'importe quelle propriété ou additionnelle de l'acteur ou de ses accessoires ou additionnelle voit sa valeur changer.

Parameters
Name Type Description
context Event.PropertyChangedContext

Le contexte de l'évènement.

Details

onRender

Description

Se produit à chaque rendu de l'acteur dans l'interface.
Un champs isFirstRender est à true dans le contexte au premier rendu uniquement.

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement. Avec en plus :

Name Type Description
isFirstRender Boolean

Vrai uniquement au premier rendu de l'acteur.

Details

onTouchEnd

Description

Se produit lorsque un ou plusieurs points de contact ont été relâchés sur l'acteur .

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement tactile.

Details

onTouchMove

Description

Se produit lorsque un ou plusieurs points de contact ont été déplacés sur l'acteur .

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement tactile.

Details

onTouchStart

Description

Se produit lorsque un ou plusieurs points de contact ont été réalisés sur l'acteur .

Parameters
Name Type Description
context Event.BaseContext

Le contexte de l'évènement.

Name Type Description
mouseEvent MouseEvent

L'évènement tactile.

Details

properties/[propertyName]/binding/onReadTransform

Description

Se produit à la lecture de la source d'une liaison vers une propriété propertyName.
Il est possible de transformer la valeur lue pour écrire autre chose dans la cible.


Par exemple l'évènement properties/width/binding/onReadTransform se produit lorsque la source de la liaison vers la propriété Actor.BaseActorProperties#width est lue.

Parameters
Name Type Description
context Event.OnBindingTransformContext

Le contexte de l'évènement.

Returns

la valeur lue par défaut.


properties/[propertyName]/binding/onWriteTransform

Description

Se produit à l'écriture de la source d'une liaison vers une propriété propertyName.
Il est possible de transformer la valeur lue pour écrire autre chose dans la source.


Par exemple l'évènement properties/width/binding/onWriteTransform se produit lorsque la propriété Actor.BaseActorProperties#width change et que sa valeur est écrite dans la source.

Parameters
Name Type Description
context Event.OnBindingTransformContext
Returns

la valeur lue par défaut.


properties/[propertyName]/onValueChanged

Description

Se produit lorsque la valeur de propriété [propertyName] change.


Par exemple l'évènement properties/width/onValueChanged se produit lorsque la propriété Actor.BaseActorProperties#width change.

Parameters
Name Type Description
context Event.PropertyChangedContext