jsyg-editor
v1.1.0
Published
Editor of svg chapes (JSYG framework)
Downloads
852
Maintainers
Readme
JSYG.Editor
Editor of svg shapes with JSYG framework
If you look for a complete SVG editor with very simple API, try JSYG.FullEditor. This one is just a brick.
Demo
http://yannickbochatay.github.io/JSYG.Editor/
Installation
npm install jsyg-editor
Usage
with module bundler
import Editor from "jsyg-editor"
let editor = new Editor("#mySVGContainer");
editor.enable({
list:"#mySVGContainer > [data-editable]"
ctrls:"all"
});
API
Table of Contents
Editor
nécessite le module Editor Edition d'éléments (positionnement, dimensions, rotation, et édition des formes pour les éléments SVG).
Parameters
arg
argument JSYG canvas des éléments à éditeropt
optionnel, objet définissant les options.
Returns Editor
onchangetarget
Fonctions à exécuter quand on définit une autre cible
onbeforeshow
Fonctions à exécuter avant l'affichage de la boite d'édition (renvoyer false pour empecher l'événement)
onshow
Fonctions à exécuter à l'affichage de la boite d'édition
onbeforehide
Fonctions à exécuter avant la suppression de la boite d'édition (renvoyer false pour empecher l'événement)
onhide
Fonctions à exécuter à la suppression de la boite d'édition
onupdate
Fonctions à exécuter à la mise à jour de la boite d'édition
onstart
Fonctions à exécuter à chaque fois qu'une action d'édition se prépare, qu'elle est lieu ou non (mousedown sur un contrôle)
ondragstart
Fonctions à exécuter à chaque fois qu'une action d'édition débute
ondrag
Fonctions à exécuter pendant une action d'édition
ondragend
Fonctions à exécuter à la fin d'une action d'édition
onend
Fonctions à exécuter au relachement du bouton de souris, qu'il y ait eu modification ou non
onchange
Fonctions à exécuter à tout changement
setNode
définit le canvas d'édition
Parameters
arg
argument JSYG
Returns Editor
target
définit ou renvoie l'élément à éditer
Parameters
arg
argument JSYG optionnel, si renseigné définit la cible à éditer_preventEvent
targetRemove
Réinitialise la cible
Parameters
_preventEvent
isMultiSelection
Indique si plusieurs éléments sont édités à la fois
Returns Boolean
list
définit ou renvoie la liste des éléments éditables dans le canvas.
hide
Masque le conteneur d'édition
Parameters
e
_preventEvent
show
Affiche le conteneur d'édition
Parameters
e
optionnel, objet Event afin de commencer tout de suite le déplacement de l'élément (ainsi sur un meme événement mousedown on peut afficher le conteneur et commencer le déplacement)_preventEvent
Returns Editor
update
Mise à jour du conteneur d'édition. (Si l'élément est modifié par un autre moyen que les contrôles du conteneur, il peut s'avérer utile de mettre à jour le conteneur)
Parameters
e
_preventEvent
Returns Editor
enableCtrls
Activation des contrôles. appelée sans argument, tous les contrôles sont activés. Sinon, en arguments (nombre variable) les noms des contrôles à activer ('drag','resize','rotate','ctrlPoints','mainPoints').
disableCtrls
Désactivation des contrôles. appelée sans argument, tous les contrôles sont desactivés. Sinon, en arguments (nombre variable) les noms des contrôles à desactiver ('Drag','Resize','Rotate','CtrlPoints','MainPoints').
align
Aligne les éléments sélectionnés
Parameters
type
String (top,middle,bottom,left,center,right)
Returns Editor
editor
référence vers l'objet Editor parent
CtrlPoints
Edition des points de contrôle des chemins SVG
Parameters
editorObject
editor
référence vers l'objet Editor parent
list
liste des contrôles
container
Conteneur des contrôles
className
Classe appliquée au conteneur des contrôles
shape
Forme utilisée pour les contrôles
xlink
lien utilisé si shape est défini à "use"
width
largeur du contrôle
height
hauteur du contrôle
linked
Points de contrôle liés ou non (si on en déplace un, l'autre se déplace en miroir)
draggableOptions
- See: {Draggable}
Options supplémentaires pour le drag&drop
onshow
Fonction(s) à exécuter à l'affichage des contrôles
onhide
Fonction(s) à exécuter à la suppression des contrôles
onstart
Fonction(s) à exécuter quand on prépare un déplacement (mousedown sur le contrôle)
ondragstart
Fonction(s) à exécuter quand on commence un déplacement
ondrag
Fonction(s) à exécuter pendant le déplacement
ondragend
Fonction(s) à exécuter en fin de déplacement
onend
Fonction(s) à exécuter au relâchement de la souris, qu'il y ait eu modification ou non
enabled
Indique si les contrôles sont activés ou non
display
Indique si les contrôles sont affichés ou non
on
- See: JSYG.StdConstruct.prototype.on
Ajout d'écouteurs d'événements customisés
Returns CtrlPoints
off
- See: JSYG.StdConstruct.prototype.on
Retrait d'écouteurs d'événements customisés
Returns CtrlPoints
trigger
- See: JSYG.StdConstruct.prototype.trigger
Déclenche un événement customisé
enable
Activation des contrôles
Parameters
opt
optionnel, objet définissant les options
Returns CtrlPoints
disable
Désactivation des contrôles
Returns CtrlPoints
show
Affichage des contrôles
Parameters
opt
optionnel, objet définissant les options_preventEvent
Returns CtrlPoints
hide
Masque les contrôles
Parameters
_preventEvent
Returns CtrlPoints
update
Met à jour les contrôles
Returns CtrlPoints
MainPoints
Edition des points principaux des chemins SVG
Parameters
editorObject
editor
référence vers l'objet Editor parent
list
liste des contrôles
container
Conteneur des contrôles
className
Classe appliquée au conteneur des contrôles
shape
Forme utilisée pour les contrôles
width
largeur des contrôles
height
hauteur des contrôles
classNameClosing
classe appliquée au dernier point d'un chemin si le chemin est fermé
strengthClosingMagnet
Force de la magnétisation entre les points extremes pour fermer le chemin
autoSmooth
Lisse automatiquement les chemins
onshow
Fonction(s) à exécuter à l'affichage des contrôles
onhide
Fonction(s) à exécuter à la suppression des contrôles
onstart
Fonction(s) à exécuter quand on prepare un déplacement (mousedown sur le contrôle)
ondragstart
Fonction(s) à exécuter quand on commence un déplacement
ondrag
Fonction(s) à exécuter pendant le déplacement
ondragend
Fonction(s) à exécuter en fin de déplacement
onend
Fonction(s) à exécuter au relachement de la souris, qu'il y ait eu modification ou non
draggableOptions
- See: {Draggable}
Options supplémentaires pour le drag&drop
on
- See: JSYG.StdConstruct.prototype.on
Ajout d'écouteurs d'événements customisés
Returns MainPoints
off
- See: JSYG.StdConstruct.prototype.on
Retrait d'écouteurs d'événements customisés
Returns MainPoints
trigger
- See: JSYG.StdConstruct.prototype.trigger
Déclenche un événement customisé
enabled
Indique si les contrôles sont activés ou non
display
Indique si les contrôles sont affichés ou non
enable
Activation des contrôles
Parameters
opt
optionnel, objet définissant les options
Returns MainPoints
disable
Désactivation des contrôles
Returns MainPoints
show
Affichage des contrôles
Parameters
opt
optionnel, objet définissant les options_preventEvent
Returns MainPoints
hide
Masque les contrôles
Parameters
_preventEvent
Returns MainPoints
update
Met à jour les contrôles
Returns MainPoints
Drag
déplacement de l'élément
Parameters
editorObject
editor
référence vers l'objet Editor parent
type
Type de déplacement ("attributes" ou "transform" pour agir sur les attributs de mise en page ou sur la matrice de transformation)
bounds
Permet de limiter le déplacement à l'intérieur de l'offsetParent (null pour annuler, valeur numérique négative pour aller au delà de l'offsetParent)
options
- See: {Draggable}
Options supplémentaires pour le drag&drop
multiple
Indique si ce contrôle est actif dans le cas d'une sélection multiple
onstart
Fonction(s) à exécuter quand on prépare un déplacement (mousedown sur le contrôle)
ondragstart
Fonction(s) à exécuter quand on commence un déplacement
ondrag
Fonction(s) à exécuter pendant le déplacement
ondragend
Fonction(s) à exécuter en fin de déplacement
onend
Fonction(s) à exécuter au relachement de la souris, qu'il y ait eu déplacement ou non
on
- See: JSYG.StdConstruct.prototype.on
Ajout d'écouteurs d'événements customisés
Returns Drag
off
- See: JSYG.StdConstruct.prototype.on
Retrait d'écouteurs d'événements customisés
Returns Drag
trigger
- See: JSYG.StdConstruct.prototype.trigger
Déclenche un événement customisé
enabled
Indique si le controle est activé ou non
display
Indique si le contrôle est affiché ou non
enable
Activation du contrôle
Parameters
opt
optionnel, objet définissant les options
disable
Désactivation du contrôle
Returns Drag
start
commence le drag&drop
Parameters
e
objet Event
Returns Drag
show
Affiche le contrôle
Parameters
opt
optionnel, objet définissant les options
hide
Masque le contrôle
Returns Drag
update
Met à jour le contrôle
Returns Drag
Resize
Edition des dimensions
Parameters
editorObject
editor
référence vers l'objet Editor parent
list
liste des contrôles
stepsX
liste des paliers horizontaux (largeurs en px)
stepsY
liste des paliers verticaux (hauteurs en px)
container
Conteneur des contrôles
className
Classe appliquée au conteneur des contrôles
shape
Forme utilisée pour les contrôles
xlink
lien utilisé si shape est défini à "use"
width
largeur des contrôles
height
hauteur des contrôles
type
Type de déplacement ("attributes" ou "transform" pour agir sur les attributs de mise en page ou sur la matrice de transformation)
multiple
Indique si ce contrôle est actif dans le cas d'une sélection multiple
onshow
Fonction(s) à exécuter à l'affichage des contrôles
onhide
Fonction(s) à exécuter à la suppression des contrôles
onstart
Fonction(s) à exécuter quand on prépare un déplacement (mousedown sur le contrôle)
ondragstart
Fonction(s) à exécuter quand on commence un déplacement
ondrag
Fonction(s) à exécuter pendant le déplacement
ondragend
Fonction(s) à exécuter en fin de déplacement
onend
Fonction(s) à exécuter au relaéchement de la souris, qu'il y ait eu modification ou non
horizontal
définit si l'élément est redimensionnable horizontalement
vertical
définit si l'élément est redimensionnable verticalement
keepRatio
définit si le ratio doit etre conservé
bounds
Permet de limiter le redimensionnement à l'intérieur de l'offsetParent (null pour annuler, valeur numérique négative pour aller au delà de l'offsetParent)
options
- See: {Resizable}
Options supplémentaires pour le redimensionnement
on
- See: JSYG.StdConstruct.prototype.on
Ajout d'écouteurs d'événements customisés
Returns Resize
off
- See: JSYG.StdConstruct.prototype.on
Retrait d'écouteurs d'événements customisés
Returns Resize
trigger
- See: JSYG.StdConstruct.prototype.trigger
Déclenche un événement customisé
enabled
Indique si les contrôles sont activés ou non
display
Indique si les contrôles sont affichés ou non
enable
Activation des contrôles
Parameters
opt
optionnel, objet définissant les options
Returns Resize
disable
Désactivation des contrôles
Returns Resize
show
Affichage des contrôles
Parameters
opt
optionnel, objet définissant les options_preventEvent
Returns Resize
hide
Masque les contrôles
Parameters
_preventEvent
Returns Resize
update
Met à jour les contrôles
Returns Resize
canHideMainPoints
Pour les lignes simples, les poignées de controle masquent les extrémités à déplacer
Parameters
node
type
Returns Boolean
Rotate
Edition de la rotation
Parameters
editorObject
editor
référence vers l'objet Editor parent
list
liste des contrôles
steps
liste des paliers
container
Conteneur des contrôles
className
Classe appliquée au conteneur des contrôles
shape
Forme utilisée pour les contrôles
xlink
lien utilisé si shape est défini à "use"
width
largeur des contrôles
height
hauteur des contrôles
multiple
Indique si ce contrôle est actif dans le cas d'une sélection multiple
cursor
Curseur à appliquer à l'élément de contrôle
onshow
Fonction(s) à exécuter à l'affichage des contrôles
onhide
Fonction(s) à exécuter à la suppression des contrôles
onstart
Fonction(s) à exécuter quand on prépare un déplacement (mousedown sur le contrôle)
ondragstart
Fonction(s) à exécuter quand on commence un déplacement
ondrag
Fonction(s) à exécuter pendant le déplacement
ondragend
Fonction(s) à exécuter en fin de déplacement
onend
Fonction(s) à exécuter au relachement de la souris, qu'il y ait eu modification ou non
options
- See: {Rotatable}
Options supplémentaires pour la rotation
on
- See: JSYG.StdConstruct.prototype.on
Ajout d'écouteurs d'événements customisés
Returns Rotate
off
- See: JSYG.StdConstruct.prototype.on
Retrait d'écouteurs d'événements customisés
Returns Rotate
trigger
- See: JSYG.StdConstruct.prototype.trigger
Déclenche un événement customisé
enabled
Indique si les contrôles sont activés ou non
display
Indique si les contrôles sont affichés ou non
enable
Activation des contrôles
Parameters
opt
optionnel, objet définissant les options
Returns Rotate
disable
Désactivation des contrôles
Returns Rotate
show
Affichage des contrôles
Parameters
opt
optionnel, objet définissant les options_preventEvent
Returns Rotate
hide
Masque les contrôles
Parameters
_preventEvent
Returns Rotate
update
Met à jour les contrôles
Returns Rotate