# j-ListForm

> j-ListForm: NUEVO: retraso {Número} retraso inicial para mostrar detalles (predeterminado: 1000 ms); NUEVO: componente.add() abre un formulario para crear registros

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: es
Content-SHA256: d4590b7a19f32c10803c5669a99d5d4d1acdc6ddab9ff017b32c2b78ad5389bb
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

__Configuración__:

- `autofocus {String/Boolean}` enfoca el primer elemento de entrada, `string` significa un selector personalizado (predeterminado: `false`)
- `empty {String}` texto de lista vacía (predeterminado: `---`)
- `default {Boolean}` realiza el método `DEFAULT()` para el alcance del formulario (predeterminado: `true`)
- El control `required {Boolean}` será "requerido" (predeterminado: `false`)
- `enter {Boolean}` permite usar `enter` como envío (predeterminado: `false`)
- `disabled {Boolean}` desactiva el control (por defecto: `false`)
- `formclass {String}` una clase personalizada para contenedor de formulario
- `itemclass {String}` una clase personalizada para contenedor de artículos
- `create {String}` un enlace a una función `function(empty_object, callback(DEFAULT_ITEM_OBJECT), arr)` (el valor `null` omite la creación)
- `submit {String}` un enlace a una función `function(form_data, callback(NEW_DATA), arr, item_ref_in_items)` (el valor `null` omite la actualización)
- `update {String}` un enlace a una función `function(form_data, callback(NEW_DATA), arr, item_ref_in_items)` (el valor `null` omite la actualización)
- `remove {String}` un enlace a una función `function(remove_item, callback(really_remove?), arr)`
- `selector {String}` un selector jQuery para plantilla personalizada (fuera del componente). Funciona como `custom template` en [data-binding](https://wiki.totaljs.com/jcomponent/08-data-binding/)
- `footertop {Boolean}` mueve el pie de página en la parte superior del componente (predeterminado: `false`)
- `move {String}` un enlace a una función `function(items)`
- `newbie {String}` un nombre de propiedad para cada elemento nuevo (siempre contendrá el valor `true`)
- `plugin {String}` un nombre de complemento personalizado dentro del componente (predeterminado: `component.ID`)
- `invalidform {Boolean}` deshabilita el componente `j-Validate` si `j-ListForm` está en modo de edición (predeterminado: `false`)
- __NUEVO__: `delay {Number}` retraso inicial para mostrar detalles (predeterminado: `1000` ms)

El componente debe tener definidas 3 plantillas incluidas en `<script type="text/html">`:

- `1` primero - con una plantilla Tangular para renderizar el elemento
- `2` segundo: un formulario con componentes (el formulario se envolverá en un ámbito aislado)
- Pie de página `3` - un pie de página con botón para el artículo `create`

__Es bueno saberlo:__

El componente observa un evento de clic en todos los botones con el atributo `name`:

- `name="submit"` realiza el envío/guardado de datos en el modelo.
- `name="update"` realiza el envío/guardado de datos en el modelo.
- `name="remove"` elimina el elemento actual del modelo.
- `name="cancel"` cancela la edición
- `name="create"` crea un formulario vacío
- `form` contiene la clase `ui-listform-new` al crear un nuevo elemento

__Botones de listado:__

- `name="remove"` elimina el elemento
- `name="up"` mueve el elemento hacia arriba
- `name="down"` mueve el elemento hacia abajo

__Métodos:__

- __NUEVO__: `component.add()` abre un formulario para crear un registro

Úselo con `<ui-component name="listform">`. 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.

```html example.html
<style>
	.ui-listform-item { height: 26px; line-height: 26px; overflow: hidden; padding: 0 5px; }
	button { background-color: white; border-radius: 2px; border: 1px solid #E0E0E0; font-size: 12px; height: 28px; line-height: 27px; padding: 0 10px; }
	button i { margin-right: 5px; }
	button:disabled { color: gray; background-color: #F8F8F8; }
	.ui-dark button { background-color: #303030; border-color: #454545; }
	.ui-dark button:disabled { background-color: #252525; color: #404040; }
</style>

<div style="width:400px">

	<ui-component name="listform" path="users" config="autofocus:1">

		<!-- LIST RENDERING -->
		<script type="text/html">
			<div>
				<div class="pull-right">
					<button name="up"><i class="ti ti-arrow-up"></i></button>
					<button name="down"><i class="ti ti-arrow-down"></i></button>
					<button name="remove"><i class="ti ti-remove"></i></button>
				</div>
				{{ name }}
			</div>
		</script>

		<!-- FORM RENDERING -->
		<script type="text/html">
			<div class="padding">
				<ui-component name="input" path="?.name" config="required:1" default="''" class="m">Name</ui-component>
				<ui-component name="validate" path="?">
					<button name="submit"><i class="ti ti-save"></i>Save</button>
					<button name="remove">Remove</button>
					<button name="cancel">Cancel</button>
				</ui-component>
			</div>
		</script>

		<!-- FOOTER -->

		<script type="text/html">
			<div style="margin-top:10px"><button name="create"><i class="ti ti-plus-circle green"></i>Create new</button></div>
		</script>

	</ui-component>
	<hr />
	<ui-bind path="users" config="text:STRINGIFY(value)" style="font-family:monospace" class="block"></ui-bind>

</div>

<script>

	var users = [{ name: 'Total.js' }, { name: 'Flow' }, { name: 'jComponent' }];

</script>
```