ForgeComponentes
es

Componentes

j-Table

jComponent 20 · jcomponent@20 component Ejemplo cargado con jComponent 20
  • j-Table es una alternativa muy, muy, muy simple a j-DataGrid destinada a la interfaz de usuario.
  • data-source espera Array o Object con { page: 1, pages: 10, limit: 50, items: [], count: 1000 }

Configuración:

  • highlight {Boolean} habilita el resaltado de la fila (predeterminado: true)
  • unhighlight {Boolean} permite deshacer el resaltado de la fila (predeterminado: true)
  • multiple {Boolean} habilita el resaltado de varias filas (predeterminado: false)
  • detail {Boolean/String} si string entonces el valor debe ser un enlace a function(row_data, next_fn(new_data_for_detail_template_OR__new_html), tdelement)
  • exec {String} una ruta a function(row/rows) o una ruta a variable
  • remember {Boolean} permite recordar las últimas filas seleccionadas (predeterminado: false)
  • pk {String} una clave principal (predeterminada: id)
  • border {Boolean} habilita el borde (predeterminado: true)
  • scrollbar {Boolean} habilita la barra de desplazamiento personalizada (predeterminado: false) + importante: se debe especificar height
  • height {Number/String} altura de la rejilla o puede contener selector window, parent o selector personalizado .ui-viewbox-body
  • paginate {String} un enlace a function(model) para realizar la paginación { page: 1, limit: 10, sort: [] }
  • redraw {String} un enlace para funcionar, se evalúa cuando se vuelve a dibujar la tabla
  • filter {String} un enlace para funcionar, se evalúa antes de que se represente la tabla
  • dblclick {String} un enlace para funcionar, se evalúa cuando el usuario realiza doble clic
  • datasource {String} ruta a la fuente de datos (para otros datos adicionales en la plantilla. Uso: {{ $.data.something }})
  • click {String} una ruta a function(button_name, row, button_element), se ejecuta cuando el usuario hace clic en el botón
  • flat {Boolean} elimina el relleno en las celdas (predeterminado: false)
  • noborder {Boolean} elimina el borde alrededor (predeterminado: false)
  • NUEVO: hidewhenempty {Boolean} oculta la tabla cuando está vacía (predeterminado: false)

Es bueno saberlo:

  • cada elemento tr contiene el atributo data-index con índice row
  • cada td elemento de detalle contiene el atributo data-index con índice row

Definición HTML:

<ui-component name="table" path="" config="">

	<!--
		data-size="TD1,TD2,TD3"      : column width, optional (can contain pixels or percentage), "0" means "auto" width
		data-head="TD1,TD2,TD3"      : column names, optional
		data-align="TD1,TD2,TD3"     : column align, optional (0: left, 1: center, 2: right)
		data-type="TYPE"             : can be "detail" (Tangular template) or "empty" (empty is rendered when the Array is empty)
		data-display="MD,XS"         : can contain display types "LG" large, "MD" medium, "SM" small, "XS" extra small
		data-sort="name,,price"      : enables sorting, can contain the name of fields (a column with empty value will have disabled sorting)
	-->
	<script type="text/html" data-size="0,150px,50px" data-head="Name,Created,Opt" data-align="0,0,1" data-sort="1">
		<tr>
			<td>{{ name }}</td>
			<td>{{ dtcreated | format('[date]') }}</td>
			<td>OK</td>
		</tr>
	</script>

	<script type="text/html" data-type="detail">
		DETAIL: {{ name }}
		HIDDEN COMMANDS: {{ $.index }} or {{ $.user }}
	</script>

	<script type="text/html" data-type="empty">
		EMPTY
	</script>

</ui-component>

Es bueno saberlo:

  • data-head puede contener íconos de Font Awesome, debe envolverse así data-head="Name,'cog'" o data-name="Name,'youtube fab'"
  • NULL('link.to.data') evalúa config.paginate

Úselo con <ui-component name="table">. 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>
	body{padding:50px;margin:0;font-family:Arial;height:100%;}
	html{height:100%;}
</style>

<ui-component name="table" path="items" config="detail:true;datasource:extra">

	<!-- WITHOUT HEADERS -->

	<script type="text/html" data-size="0,120px,120px" data-head="Name,Price,Controls" data-align="0,2,1" data-sort="name,price,">
		<tr>
			<td><b>{{ $.data.author }}:</b> {{ name }}</td>
			<td class="right">{{ price | format(2) }} &euro;</td>
			<td class="center"><button><i class="ti ti-search"></i></button><button><i class="ti ti-pencil"></i></button><button class="red" disabled><i class="ti ti-trash"></i></button></td>
		</tr>
	</script>

	<script type="text/html" data-type="detail">
		<div class="padding npt npb">
			<div>Author: <b>{{ $.data.author }}</b></div>
			<div>Role: <b>{{ $.data.role }}</b></div>
			<div>Name: <b>{{ name }}</b></div>
			<div>Description: <b>{{ description }}</b></div>
		</div>
	</script>

	<script type="text/html" data-type="empty">
		No data
	</script>

</ui-component>

<br />

<ui-component name="table" path="items" config="border:0">

	<!-- WITHOUT HEADERS -->
	<script type="text/html" data-size="0,120px,120px">
		<tr>
			<td>{{ name }}</td>
			<td class="right">{{ price | format(2) }} &euro;</td>
			<td class="center">{{ created | format('yyyy-MM-dd') }}</td>
		</tr>
	</script>

	<script type="text/html" data-type="empty">
		No data
	</script>

</ui-component>

<script>

	var items = [];
	var extra = {
		author: 'Brutus',
		role: 'Planter'
	};

	items.push({ name: '1 Lorem ipsum dolor.', description: 'Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consectetur, mollitia!', price: 233, created: new Date().add('-5 days') });
	items.push({ name: '2 Lorem ipsum dolor.', description: 'Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consectetur, mollitia!', price: 122, created: new Date().add('-1 year') });
	items.push({ name: '3 Lorem ipsum dolor.', description: 'Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consectetur, mollitia!', price: 119, created: new Date().add('-1 month') });
	items.push({ name: '4 Lorem ipsum dolor.', description: 'Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consectetur, mollitia!', price: 35.34, created: new Date().add('-14 days') });
	items.push({ name: '5 Lorem ipsum dolor.', description: 'Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consectetur, mollitia!', price: 439.33, created: new Date().add('-5 hours') });
	items.push({ name: '6 Lorem ipsum dolor.', description: 'Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consectetur, mollitia!', price: 111.12, created: new Date().add('-349 minutes') });

</script>