Bileşen Modeli
**************

.[perex]
Nette önemli bir kavram da bileşendir. Sayfalara [görsel etkileşimli bileşenler |application:components] ekleriz, formlar veya tüm öğeleri de bileşenlerdir. Tüm bu bileşenlerin miras aldığı, `nette/component-model` paketinin bir parçası olan ve bileşen ağacı hiyerarşisini oluşturmaktan sorumlu olan iki temel sınıf vardır.


Component
=========
[api:Nette\ComponentModel\Component] tüm bileşenlerin ortak atasıdır. Bileşenin adını döndüren `getName()` yöntemini ve ebeveynini döndüren `getParent()` yöntemini içerir. Her ikisi de `setParent()` yöntemiyle ayarlanabilir - ilk parametre ebeveyn, ikincisi ise bileşen adıdır.


lookup(string $type): ?Component .[method]
------------------------------------------
İstenen sınıf veya arayüzün bir nesnesi için hiyerarşide arama yapar. Örneğin, `$component->lookup(Nette\Application\UI\Presenter::class)`, birkaç seviyeye rağmen bileşen kendisine bağlıysa presenter öğesini döndürür.


lookupPath(string $type): ?string .[method]
-------------------------------------------
Geçerli bileşen ile aranan bileşen arasındaki yoldaki tüm bileşenlerin adlarının birleştirilmesiyle oluşturulan bir dize olan sözde yolu döndürür. Örneğin, `$component->lookupPath(Nette\Application\UI\Presenter::class)`, sunum yapan kişiye göre bileşenin benzersiz tanımlayıcısını döndürür.


Container
=========
[api:Nette\ComponentModel\Container] ana bileşendir, yani çocukları içeren ve böylece ağaç yapısını oluşturan bileşendir. Bileşenleri kolayca eklemek, almak ve kaldırmak için yöntemleri vardır. Örneğin formun veya `Control` ve `Presenter` sınıflarının atasıdır.


getComponent(string $name): ?Component .[method]
------------------------------------------------
Bir bileşen döndürür. Tanımsız alt öğeyi çağırma girişimi, [createComponent($name) |api:Nette\ComponentModel\Container::createComponent()] fabrikasının çağrılmasına neden olur. Yöntem `createComponent($name)` yöntemi çağırır `createComponent<component name>` ve bileşenin adını bir parametre olarak geçirir. Oluşturulan bileşen daha sonra mevcut bileşene çocuğu olarak aktarılır. Bunlara bileşen fabrikaları diyoruz, `Container` adresinden miras alınan sınıflarda uygulanabilirler.


getComponents(): array .[method]
--------------------------------
Doğrudan torunları bir dizi olarak döndürür. Anahtarlar bu bileşenlerin adlarını içerir. Not: 3.0.x sürümünde, yöntem bir dizi yerine bir yineleyici döndürüyordu ve ilk parametresi bileşenler arasında derinlemesine yineleme yapılıp yapılmayacağını belirtiyordu, ikincisi ise bir tür filtresini temsil ediyordu. Bu parametreler kullanımdan kaldırılmıştır.


getComponentTree(): array .[method]{data-version:3.1.0}
-------------------------------------------------------
İç içe geçmiş tüm alt bileşenler de dahil olmak üzere tüm bileşen hiyerarşisini dizinlenmiş dizi olarak döndürür. Arama önce derinlemesine yapılır.


Ataların İzlenmesi .[#toc-monitoring-of-ancestors]
==================================================

Nette bileşen modeli çok dinamik ağaç çalışmasına izin verir (bileşenleri kaldırabilir, taşıyabilir, ekleyebiliriz), bu nedenle bir bileşen oluşturduktan sonra ebeveynin, ebeveynin ebeveyninin vb. hemen (yapıcıda) bilindiği gerçeğine güvenmek hata olur. Genellikle bileşen oluşturulduğunda ebeveyn hiç bilinmez.

Bir bileşenin sunum ağacına ne zaman eklendiğini nasıl öğrenebilirim? Ebeveyn değişikliğini takip etmek yeterli değildir, çünkü örneğin ebeveynin ebeveyni sunum yapan kişiye eklenmiş olabilir. [monitor($type, $attached, $detached) |api:Nette\ComponentModel\Component::monitor()] yöntemi yardımcı olabilir. Her bileşen istediği sayıda sınıfı ve arayüzü izleyebilir. Bağlantı veya bağlantının kesilmesi, sırasıyla `$attached` ve `$detached` geri çağrılarının çağrılması ve izlenen sınıfın nesnesinin aktarılmasıyla bildirilir.

Bir örnek: Nette Forms'ta dosya yüklemek için form öğesini temsil eden `UploadControl` sınıfı, formun `enctype` özniteliğini `multipart/form-data` değerine ayarlamalıdır. Ancak nesnenin oluşturulması sırasında herhangi bir forma eklenmesi gerekmez. Form ne zaman değiştirilir? Çözüm basittir - yapıcıda izleme için bir istek oluştururuz:

```php
class UploadControl extends Nette\Forms\Controls\BaseControl
{
	public function __construct($label)
	{
		$this->monitor(Nette\Forms\Form::class, function ($form): void {
			$form->setHtmlAttribute('enctype', 'multipart/form-data');
		});
		// ...
	}

	// ...
}
```

ve form kullanılabilir olduğunda, geri arama çağrılır. (Önceden bunun yerine `attached` ve `detached` ortak yöntemleri kullanılıyordu).


{{leftbar: nette:@menu-topics}}