# j-ListForm

> j-ListForm: NOVO: atraso {Número} inicial atraso para exibir detalhes (default: 1000 ms); NOVO : component.add() abre um formulário para criar registros

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

__Configuração__:

- `autofocus {String/Boolean}` concentra o primeiro elemento de entrada, `string` significa um selector personalizado (default: `false`)
- `empty {String}` texto de lista vazia (default: `---`)
- `default {Boolean}` realiza o método `DEFAULT()` para o alcance da forma (default: `true`)
- Controle de `required {Boolean}` será "necessário" (default: `false`)
- `enter {Boolean}` permite usar `enter` como submetido (default: `false`)
- `disabled {Boolean}` desabilita o controle (default: `false`)
- `formclass {String}` uma classe personalizada para um contêiner
- `itemclass {String}` uma classe personalizada para o contenedor de item
- `create {String}` um link para uma função `function(empty_object, callback(DEFAULT_ITEM_OBJECT), arr)` (escípios de valor `null` criando)
- `submit {String}` um link para uma função `function(form_data, callback(NEW_DATA), arr, item_ref_in_items)` (`null` atualização de valores)
- `update {String}` um link para uma função `function(form_data, callback(NEW_DATA), arr, item_ref_in_items)` (`null` atualização de valores)
- `remove {String}` um link para uma função `function(remove_item, callback(really_remove?), arr)`
- `selector {String}` um seletor jQuery para o modelo personalizado (outside do componente). `custom template` em [Dados de ligação](https://wiki.totaljs.com/jcomponent/08-data-binding/)
- `footertop {Boolean}` move o footer na parte superior do componente (default: `false`)
- `move {String}` um link para uma função `function(items)`
- `newbie {String}` um nome de propriedade para cada item novo (ele sempre contém o valor `true`)
- `plugin {String}` um nome de plugin personalizado dentro do componente (default: `component.ID`)
- `invalidform {Boolean}` desabilita o componente `j-Validate` se o `j-ListForm` estiver em modo de edição (default: `false`)
- __NEW__: `delay {Number}` atraso inicial para exibir detalhes (default: `1000` ms)

O componente deve ter definido 3 modelos em `<script type="text/html">`:

- `1` primeiro - com um modelo Tangular para renderização de itens
- `2` segundo - uma forma com componentes (a forma será enrolada em um alcance isolado)
- `3` Footer - um footer com um botão para o item `create`

__É bom saber:__

O componente observa um evento de clique em todos os botões com o atributo `name`:

- `name="submit"` realiza a apresentação/salvação de dados para o modelo
- `name="update"` realiza a apresentação/salvação de dados para o modelo
- `name="remove"` remove o item atual do modelo
- `name="cancel"` Cancelamento
- `name="create"` cria uma forma vazia
- `form` contém classe `ui-listform-new` quando se cria um novo item

__Lista de botões:__

- `name="remove"` remove item
- `name="up"` move item para cima
- `name="down"` move item para baixo

__Métodos →__

- __NEW__: `component.add()` abre um formulário para criar registros

Use-o com `<ui-component name="listform">`Quando o componente ainda não está carregado, jComponent Descarrega-o no primeiro uso do endereço `DEF.fallback` (a partir do Componentator CDN por padrão). autor: Peter Širka. fonte: o Componentator Reserva de componentes, licença 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>
```