# Eine eigene jComponent schreiben

> Registriere eine wiederverwendbare Komponente mit COMPONENT(), rendere sie in make(), reagiere in setter() auf Zustandsänderungen und schreibe mit set() zurück.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: de
Content-SHA256: 1bf2b1c9e8fdec5d72d8c8f12741a6387b4f3f1c5f97bee49c2ec30c768e4a41
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: jcomponent20@3fedd009a277f50fddc608b97afbec553b67c51b
Review: not-recorded

Eine Komponente wird mit `COMPONENT(name, config, declaration)` deklariert. Das zweite Argument ist die Standardkonfiguration als String (`key:value;key:value`). Die Deklaration erhält `self` (die Komponenteninstanz) und `config` (die geparste Konfiguration).

- `self.make` läuft einmal, wenn die Komponente erstellt wird. Baue hier das DOM auf.
- `self.setter(value)` läuft jedes Mal, wenn sich der Wert des `path` der Komponente ändert.
- `self.set(value)` schreibt einen neuen Wert in den `path`; `self.get()` liest ihn.

Nutze die Komponente mit einem `<ui-component>`-Element. `name` wählt die Deklaration, `path` den State und `config` überschreibt die Standardwerte.

```html public/index.html
<!DOCTYPE html>
<html>
<head>
	<meta charset="utf-8" />
	<title>jComponent</title>
	<link rel="stylesheet" href="//cdn.componentator.com/spa.min@20.css" />
	<script src="//cdn.componentator.com/spa.min@20.js"></script>
</head>
<body>

	<ui-component name="counter" path="cart.count" config="step:2"></ui-component>
	<p>Total: <ui-bind path="cart.count" config="text:value"></ui-bind></p>

	<script>

		COMPONENT('counter', 'step:1', function(self, config) {

			self.make = function() {
				self.html('<button type="button">Add</button> <b class="value">0</b>');
				self.event('click', 'button', function() {
					self.set((self.get() || 0) + config.step);
				});
			};

			self.setter = function(value) {
				self.find('.value').text(value || 0);
			};

		});

		SET('cart.count', 10);

	</script>

</body>
</html>
```

Das `ui-bind` neben der Komponente zeigt, dass beide denselben State lesen: Ein Klick auf den Button ändert den Pfad, und jedes daran gebundene Element aktualisiert sich.
