Document how to define mandatory/default props

[alexislefebvre]

Q	A
Bug fix?	no
New feature?	no
Deprecations?	no
Documentation?	yes
Issues	-
License	MIT

Here is a “trick” to define default values for anonymous components.

[Kocal]

I don't think we need a new section for default properties values, and the code examples seem wrong to me. What about changing the previous code block?

[alexislefebvre]

What do you think is wrong in these examples?

The previous code blocks rely on {{ attributes.defaults({class: 'primary'}) }}: https://symfony.com/bundles/ux-twig-component/current/index.html#anonymous-components I preferred to separate these 2 different usages of props.

[Kocal]

Instead, what about making icon prop required:

Suggested change

	.. code-block:: html+twig
	{# templates/components/Button.html.twig #}
	{% props icon, type = 'primary' %}
	<button {{ attributes.defaults({class: 'btn btn-'~type}) }}>
	{% block content %}{% endblock %}
	{% if icon %}
	<span class="fa-solid fa-{{ icon }}"></span>
	{% endif %}
	</button>

and add some examples:

{# property "icon" is missing, an exception is thrown #}
<twig:Button>Share</twig:Button>

{# property "icon" is passed, property "type" use its default value "primary" #}
<twig:Button icon="share">Share</twig:Button> 

{# both properties "icon" and "type" are passed #}
<twig:Button icon="share" type="secondary></twig:Button>

[alexislefebvre]

Thanks, I added it below the current examples because I think that showing props icon = null + {% if icon %} is interesting too.

[Kocal]

Thank you @alexislefebvre.