nette/component-model

⚛ Component model foundation for Nette.

Nette Component Model

Introduction

Components are the foundation of reusable code. They make your work easier and allow you to profit from community work. Components are wonderful. Nette Framework introduces several classes and interfaces for all these types of components.

Documentation can be found on the website.

If you like Nette, please make a donation now. Thank you!

Installation

The recommended way to install is via Composer:

composer require nette/component-model

It requires PHP version 8.1 and supports PHP up to 8.3.

component-model's Issues

Can Container implement IteratorAgregate?

Describe use case:
If i prepare structure of the form by $form->addContainer('foo'); in every template i must use {foreach $form->getComponent('foo')->getComponents() as $key => $input} this help make shorter {foreach $form->getComponent('foo') as $key => $input}, because i never need parameters from getComponents() $deep and $fileter in template.

Implementation is easy.

namespace Nette\ComponentModel;

use Nette;

class Container extends Component implements IContainer, \IteratorAggregate
{

	public function getIterator()
	{
		return $this->getComponents();
	}

}

What do you think?

Container::getComponent() throws exception for already attached components

Because there is a check for component parent presence in https://github.com/nette/component-model/blob/master/src/ComponentModel/Container.php#L142 it's impossible return already created and attached controls.

class MyControl {

protected function createComponentTest() {
  return $this->anotherControlParent->getComponent("Test");
}

If another parent has attached component "test", exception about unknown component "test" is thrown. Throw such exception in this situation is misleading.

Maybe such component don't need to be attached to current parent but getComponent() method can return such component. That component is already attached to another parent doesn't matter.

IContainer::getComponent() is incompatible with Container::getComponent()

Either IContainer::getComponent() must have @throws annotation or Container::getComponent() must not throw by default (i.e. default value of bool $throw by me false).

attached() is called more than once with the same monitored class

When component monitors e.g. interface and monitors its descendant too, the attached() method is called twice with the same monitored object.

Following sandbox branch calls attached() with Presenter twice:

VladaHejda:double-monitoring