ForgeComponentes
es

Componentes

j-Flow

jComponent 20 · jcomponent@20 component Ejemplo cargado con jComponent 20
  • los identificadores no pueden contener el carácter __

Configuración:

  • width {Number} un ancho del diseñador de flujo, predeterminado: 6000
  • height {Number} una altura del diseñador de flujo, predeterminado: 6000
  • grid {Number} un tamaño de cuadrícula de fondo, predeterminado: 25
  • paddingX {Number} relleno interno, predeterminado: 6
  • curvedlines {Boolean} habilita líneas curvas, predeterminado: false
  • infopath {String} una ruta a la variable/método, respuesta: { zoom: Number, selected: Object }
  • undopath {String} una ruta a la variable/método, la respuesta es Matriz de objetos
  • redopath {String} una ruta a la variable/método, la respuesta es Matriz de objetos
  • ondrop {String} una ruta al método fn(dropmeta, grid)
  • onmake {String} una ruta al método fn(el, com), se ejecuta cuando se crea el componente
  • ondone {String} una ruta al método fn(el, com), se ejecuta cuando se crea el componente
  • onmove {String} una ruta al método fn(el, com/group, type), se ejecuta cuando el componente/grupo se está moviendo
  • onremove {String} una ruta al método fn(el, com), se ejecuta cuando se elimina el componente
  • onconnect {String} una ruta al método fn(meta), se ejecuta cuando los dos componentes están conectados
  • ondisconnect {String} una ruta al método fn(meta), se ejecuta cuando los dos componentes están desconectados
  • NEW onpause {String} una ruta al método fn(path, is), se ejecuta cuando la salida/entrada está en pausa
  • steplines {Boolean} habilita líneas de pasos (predeterminado: false)
  • animationradius {Number} radio de animación en píxeles (predeterminado: 5)
  • contextmenu {String} una ruta a function(e, type, component/meta) (el tipo puede ser map, component, connection, group)
  • dblclick {String} un camino hacia function(component)
  • outputoffsetX {Number} un desplazamiento X predeterminado para el punto de salida (predeterminado: 10)
  • outputoffsetY {Number} un desplazamiento Y predeterminado para el punto de salida (predeterminado: 12)
  • inputoffsetX {Number} un desplazamiento X predeterminado para el punto de entrada (predeterminado: 10)
  • inputoffsetY {Number} un desplazamiento Y predeterminado para el punto de entrada (predeterminado: 12)
  • snapping {Number} ajuste en píxeles (predeterminado: 0 = deshabilitado)
  • multiple {Boolean} permite la selección múltiple del componente (predeterminado: true)
  • history {Number} un recuento de pasos en el historial de deshacer/rehacer (predeterminado: 100)
  • animationlimit {Number} un recuento máximo de puntos para todas las animaciones (predeterminado: 100)
  • animationlimitconnection {Number} un recuento máximo de puntos por conexión (predeterminado: 5)
  • allowpause {Boolean} permite pausar en salidas/entradas (predeterminado: true)
  • markers {Boolean} agrega marcadores de flecha a la conexión (predeterminado: true)

Comandos:

  • flow.refresh recalcula posiciones
  • flow.selected.disconnect desconecta la conexión seleccionada
  • flow.selected.remove elimina el componente seleccionado
  • flow.selected.clear elimina el componente o la conexión seleccionados
  • flow.zoom realiza zoom, argumento: type (puede ser: in, out, reset o percentage {Number}), segundo argumento opcional: percentage
  • flow.undo realiza el paso de deshacer
  • flow.redo realiza el paso de rehacer
  • flow.reset restablece el editor
  • flow.components.add agrega un nuevo componente, argumento: component_declaration
  • flow.components.find encuentra un componente, argumento: component_id
  • flow.clean limpia datos y conexiones inexistentes
  • flow.traffic(componentid__outputid, { count: 3, speed: 3, limit: 20, delay: 50, reverse: false }) carga animación
    • La animación reverse se puede habilitar agregando _ como carácter inicial del identificador _componentid__outputid.
  • NEW flow.groups.find encuentra un grupo, argumento: group_id
  • NEW flow.check una nueva alternativa más rápida al comando flow.refresh
  • NEW flow.find busca un componente o grupo, argumento: component_id o group_id

Agregar un nuevo componente:

  • el componente crea automáticamente el ID del componente
  • connections es {Object}
// Component declaration
var component = {
	x: 100,
	y: 50,
	html: 'Component test',

	outputs: ['1 output name', '2 output name'],
	// or
	// outputs: [{ id: 'A', name: 'A output name' }, { id: 'B', name: 'B output name', color: '#FF8E37' }],

	connections: { '0': [{ id: '0002', index: '2', disabled: false }] }, // Look to the connection object below
	// or
	// connections: { 'A': [{ id: '0002', index: 'B', disabled: false }] },

	actions: { select: true, move: true, disabled: false, remove: true, connect: true }
};

// Appends component
CMD('flow.components.add', component);
// Connection object
// connections: { '0': [CONNECTION_OBJECT1, CONNECTION_OBJECT2, CONNECTION_OBJECT3] }
{
	id: 'TARGET_ID_COMPONENT',
	index: '0', // An input index or index id, must be string!!!
	disabled: false // Optional, it's the connection disabled? Disabled connection can't be removed
}

Salida de flujo:

  • devuelve Object cuyas claves son ID de componentes
{
	'F1562743923216': { x: 1, y: 1, connections: [], ... },
	'F1562743965303': { x: 1, y: 1, connections: [], ... },

	// Contains paused endpoints
	paused: { 'input__COMPONENTID__INDEXID': 1, 'output__COMPONENTID__INDEXID': 1 },

	// Contains groups
	groups: [{ id: 'GroupID', name: 'Name', x: 100, y: 100, width: 100, height: 100, background: 'rgba(0,0,0,0.1)', color: '#000', border: 'rgba(0,0,0,0.1)' }, ...];
}

Es bueno saberlo:

  • cada componente (en el Flujo) contiene la clase f-COMPONENTNAME
  • La clase selectable en el elemento componente permite copiar texto y deshabilita moverlo
  • connections admite type:"transform" con línea discontinua

Úselo con <ui-component name="flow">. Cuando el componente aún no está cargado, jComponent lo descarga en el primer uso desde la dirección en DEF.fallback (el CDN Componentator de forma predeterminada). Autor: Peter Širka. Fuente: repositorio de componentes Componentator, licencia MIT.

example.html
<style>
	.toolbar { margin-bottom: 10px; }
	.toolbar button { min-width: 26px; height: 24px; background-color: transparent; border: 0; font-size: 12px; color: gray; }
	.toolbar button span { margin-left: 3px; }
	.toolbar button[name="remove"] { color: red !important; }
	.toolbar button:disabled { color: #C0C0C0 !important; cursor: not-allowed; }
	.toolbar button:hover { color: black; }
	.toolbar button:first-child { border-left: 0; }
</style>

<div class="toolbar">
	<button is="is-button" path="floweditor.undo" config="enabled:value && value.length > 0;click:floweditor_undo" disabled="disabled"><i class="ti ti-undo"></i></button>
	<button is="is-button" path="floweditor.redo" config="enabled:value && value.length > 0;click:floweditor_redo" disabled="disabled"><i class="ti ti-redo"></i></button>
	<button is="is-button" path="floweditor.info.selected" config="enabled;click:floweditor_remove" name="remove" disabled="disabled"><i class="ti ti-trash"></i></button>
</div>

<ui-component name="flow" path="flowmodel" config="width:6000;height:6000;grid:26;infopath:floweditor.info;undopath:floweditor.undo;redopath:floweditor.redo"></ui-component>

<script>

	var flowmodel = {
		groups: [{ id: 'G12345', name: 'My group', x: 50, y: 50, width: 300, height: 300 }],
		'F1562743923216': { x: 100, y: 150, html: 'Component 1', outputs: ['Done', 'Error'], connections: { '0': [{ id: 'F1562743965303', index: '2', disabled: false }] }},
		'F1562743965303': { x: 500, y: 250, html: 'Component 2', inputs: ['1', '2', '3'] }
	};

	var floweditor = {};

	function floweditor_undo() {
		CMD('flow.undo');
	}

	function floweditor_redo() {
		CMD('flow.redo');
	}

	function floweditor_remove() {
		CMD('flow.selected.clear');
	}

	// Extend buttons for using Web components
	customElements.define('is-button', class extends HTMLButtonElement {
		constructor() {
			super();
			setTimeout(NEWUIBIND, 2, this);
		}
	}, { extends: 'button' });

</script>