Documentation for custom data structures

[s2b]

Add example for custom data structures to documentation

[viu-x]

I want to use a custom class as parameter which can be constructed from an array (and maybe a string).

<fc:param
   name="background"
   type="Viux\Sitepackage\Domain\Model\Components\GenericBackground"
   optional="1"
/>

I see in your code interfaces and tried to use the ConstructibleFromArray but before your ComponentArgumentConverter can check if the type is convertible the fluid type validator throws an error

fluid-components/Classes/Fluid/ViewHelper/ComponentRenderer.php

Lines 385 to 393 in 1c64606

	if (!$this->isValidType($type, $value)
	&& !$this->componentArgumentConverter->canTypeBeConvertedToType($givenType, $type)
	) {
	throw new InvalidArgumentException(
	'The argument "' . $argumentName . '" was registered with type "' . $type . '", but is of type "' .
	$givenType . '" in component "' . $this->componentNamespace . '".',
	1530632537
	);
	}

How do I make use of this mechanism? Especially needed in combination with fluid style guide.

And to take this to the next level… where do I register my own conversion interface?

fluid-components/Classes/Utility/ComponentArgumentConverter.php

Lines 100 to 105 in 1c64606

	public function addConversionInterface(string $fromType, string $interface, string $constructor): self
	{
	$this->conversionInterfaces[$fromType] = [$interface, $constructor];
	$this->conversionCache = [];
	return $this;
	}

Thx in advance
Tobi