j-Dashboard
- Soporta dispositivos móviles
- Soporta toques
- Móvil
- Arrastrable
- Redimensionable
El componente espera Array de objetos.
Configuración:
axisX {Number}un tamaño de cuadrícula del eje X (predeterminado:12)axisY {Number}un tamaño de cuadrícula del eje Y (predeterminado:144)padding {Number}un relleno entre widgets (predeterminado:10)- Retraso de inicio
delay {Number}(predeterminado:200) serviceinterval {Number}un intervalo de servicio (predeterminado:5000)ondrop {String}una ruta al métodofunction(meta) {}, se ejecuta si alguien coloca algún elemento en el áreameta.xX posición de la rejillameta.yPosición de la rejilla Ymeta.elelemento arrastradometa.pageXmeta.pageYmeta.offsetXmeta.offsetYmeta.targetmeta.dun modo de visualizaciónxs,sm,mdolg
noemitresizedeshabilita la ejecución del métodoresizeen todos los componentes anidados (predeterminado:false)parent {String}un contenedor principal que establece una altura mínima (predeterminado:null)margin {Number}un margen superior/inferior para la opciónparent(predeterminado:0)minsizexs {Number}un tamaño mínimo de columna/fila para pantallas muy pequeñas (predeterminado:2)minsizesm {Number}un tamaño mínimo de columna/fila para pantallas pequeñas (predeterminado:2)minsizemd {Number}un tamaño mínimo de columna/fila para pantallas medianas (predeterminado:1)minsizelg {Number}un tamaño mínimo de columna/fila para pantallas grandes (predeterminado:1)iconsettings {String}icono de configuracióniconremove {String}eliminar iconochange {String}una ruta al métodofunction(type, id)(se ejecuta si el panel captura un cambiomoveoremove)animation {Number}estilo de animación:1opacidad2escala de grande a normal3escala de pequeño a normal (predeterminado)4rotación Z5cambio de posición X6cambio de posición Y
grid {Boolean}representa la cuadrícula de fondo (predeterminado:false)- NUEVO:
reanimate {Boolean}habilita la animación para cambiar los widgets (predeterminado:false)
// Component declaration
var component = {
// Component ID
id: 'COMPONENT_ID',
// Positioning
// You can define specific display size and if the display size is not specified then the component tries to find a size for larger display
offset: {
xs: { x: 1, y: 1, width: 6, height: 6 }, // Number means the position in the grid, so e.g. width "2" takes "2" columns in X axis
lg: { x: 1, y: 1, width: 6, height: 6 }
},
html: 'THE CONTENT OF COMPONENT', // or can be raw HTMLElement
// Default settings
actions: { move: true, remove: true, resize: true, resizeX: true, resizeY: true, resizeP: false, settings: true },
// resizeP means: resize "proportionally"
// Can disable header (default: true)
header: true,
// Can delay displaying (in "ms", default: config.delay)
delay: 0,
// A component title
title: 'Title for the component',
// Custom properties which will be assigned to the instance
template: Object,
config: Object,
// reset: true, // NEW: reloads the component again
// class: String // adds a class to the item
make: function(exports, config, el) {
// @exports {Object}
// @config {Object}
// @el {jQuery} a content of the component
// Handlers (optional):
exports.destroy = function() {
// @el {jQuery} a content of the component
// @this {Instance}
// is executed when the component is destroyed
};
exports.data = function(data, el) {
// @data {Object}
// @this {Instance}
// @el {jQuery} a content element of the component
// It can be executed via SETTER('dashboard/send', ....)
};
exports.service = function(counter, el) {
// @counter {Number} count of calls
// @el {jQuery} a content of the component
// @this {Instance}
// dashboard will execute this handler each 5 seconds
};
exports.focus = function() {
// Optional, when the "window" is focused the delegate will be executed
};
exports.resize = function(width, height, el, display) {
// @width {Number}
// @height {Number}
// @el {jQuery} a content of the component
// @display {String} a current display size "xs", "sm", "md" or "lg"
// @this {Instance}
// is executed when the component is resized
// @this {Instance}
};
exports.settings = function(config, el, elbtn) {
// @config {Object}
// @el {jQuery} a content element of the component
// @elbtn {jQuery} button element
// is executed when the users clicks on the settings icon
};
exports.remove = function(remove) {
// remove {Function} removes that widget
remove();
};
exports.configure = function() {
// is executed when the configuration is changed
};
// this.meta {Object} a reference to component object
// this.element {jQuery} a content element of the component
// this.container {jQuery} a main content element of the component
// this.main {Object} a reference to Dashboard component
// this.width {Number} a width of "this.element"
// this.height {Number} a height of "this.element"
// this.display {String} a current display size "xs", "sm", "md" or "lg"
// is executed when the component is making
}
};
PUSH('components', component);Métodos:
SETTER('dashboard/send', id, body)envía datos a todos los widgets que contienen el delegadodata.id {String}nullenvía a todos los componentes@componentenvía a los componentes específicos según el nombre del componentestringenvía a un componente específico según el identificador
SETTER('dashboard/call', method_name, [a], [b], [c], [d])ejecuta un método en cada widgetRETURN('dashboard/pixel')devuelve el tamaño del píxel (cuadrado)RETURN('dashboard/display')devuelve el ancho de visualización actual
Es bueno saberlo:
- el componente agrega clases al cuerpo del componente:
d_colNUMBERdetermina el recuento de columnas tomadas, p.d_col2d_rowNUMBERdetermina el recuento de filas tomadas, p.d_row3d_squareel componente tiene el mismo ancho/altod_verticalel componente tiene solo 1 paso de ancho y más de 1 paso de alturad_horizontalel componente tiene solo 1 paso de altura y más de 1 paso de ancho
Úselo con <ui-component name="dashboard">. 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.
<ui-component name="dashboard" path="components"></ui-component>
<script>
var components = [];
components.push({
id: 'A',
offset: { lg: { x: 0, y: 0, width: 4, height: 4 }},
title: 'A',
html: '<div class="padding">Lorem ipsum dolor sit amet.</div>',
actions: { settings: true, remove: true, move: true, resize: true },
make: function(exports, config, el) {
// If you change some action "exports.actions" then execute:
// exports.refresh();
exports.data = function(data) {
};
exports.configure = function() {
};
}
});
components.push({
id: 'B',
offset: { lg: { x: 4, y: 0, width: 4, height: 4 }},
title: 'B',
html: '<div class="padding">Lorem ipsum dolor sit amet.</div>',
actions: { settings: true, remove: true, move: true, resize: true }
});
</script>