# j-ListForm

> j-ListForm: NOWOŚĆ: opóźnienie {Number} początkowego opóczu wyświetlania szczegółów (default: 1000 ms); NEW: component.add() otwiera formularz do tworzenia rekordów

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

__Konfiguracja__:

- `autofocus {String/Boolean}` koncentruje się na pierwszym elementie wejściowym, `string` oznacza wybrany selektor (default: `false`)
- `empty {String}` puste tekst listy (default: `---`)
- `default {Boolean}` wykonuje metodę `DEFAULT()` dla zakresu formularza (default: `true`)
- Kontrola `required {Boolean}` będzie „wymagana” (default: `false`)
- `enter {Boolean}` umożliwia wykorzystanie `enter` jako podania (default: `false`)
- `disabled {Boolean}` wyłącza kontrolę (default: `false`)
- `formclass {String}` klasę do formy kontenera
- `itemclass {String}` klasę dla kontenera
- `create {String}` link do funkcji `function(empty_object, callback(DEFAULT_ITEM_OBJECT), arr)` (`null` wartość skips tworzenie)
- `submit {String}` link do funkcji `function(form_data, callback(NEW_DATA), arr, item_ref_in_items)` (`null` wartość skips aktualizacja)
- `update {String}` link do funkcji `function(form_data, callback(NEW_DATA), arr, item_ref_in_items)` (`null` wartość skips aktualizacja)
- `remove {String}` Link do funkcji `function(remove_item, callback(really_remove?), arr)`
- `selector {String}` wybór jQuery dla szablonu dostosowanego (poza składnikiem). `custom template` w [Dane wiążące](https://wiki.totaljs.com/jcomponent/08-data-binding/)
- `footertop {Boolean}` porusza stopę na górze składnika (default: `false`)
- `move {String}` Link do funkcji `function(items)`
- `newbie {String}` nazwa nieruchomości dla każdego nowego przedmiotu (w tym zawsze będzie zawierać wartość `true`)
- `plugin {String}` nazwa wtyczki w składzie (default: `component.ID`)
- `invalidform {Boolean}` wyłącza składnik `j-Validate` jeśli `j-ListForm` jest w trybie edycji (default: `false`)
- __NEW__: `delay {Number}` początkowe opóźnienie w wyświetlaczu szczegółów (default: `1000` ms)

Składnik musi mieć określone 3 szablony włożone w `<script type="text/html">`:

- `1` pierwszy - z szablonem Tangular do renderowania przedmiotu
- `2` sekundy - forma z składnikami (formuła zostanie włożona w izolowany zakres)
- `3` Footer - stopień z przyciskiem do elementu `create`

__Dobrze jest wiedzieć:__

Komponent obserwuje wydarzenie kliknięte na wszystkich przyciskach z atrybutem `name`:

- `name="submit"` wykonuje przesyłanie/zbawienie danych do modelu
- `name="update"` wykonuje przesyłanie/zbawienie danych do modelu
- `name="remove"` usuwa aktualny element z modelu
- `name="cancel"` odwołuje
- `name="create"` tworzy pustą formę
- `form` zawiera klasę `ui-listform-new` przy tworzeniu nowego elementu

__Wyświetlanie przycisków:__

- `name="remove"` usuwa elementy
- `name="up"` przesuwa element do góry
- `name="down"` przesuwa element do dolnej

__Metody są:__

- __NEW__: `component.add()` otwiera formularz do tworzenia rekordów

Użyj go z `<ui-component name="listform">`Gdy element nie jest jeszcze ładowany, jComponent Pobierz go po pierwszym użyciu z adresu `DEF.fallback` (Wydaje się Componentator Autor: Peter Širka Źródło: Componentator Zestaw składników, licencja 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>
```
