[Twig] Tweaking docs for new HTML syntax

[weaverryan]

Q	A
Bug fix?	no
New feature?	no
Tickets	None
License	MIT

Just following up with a few more tweaks to @WebMamba's docs in #792.

Cheers!

[WebMamba]

Thanks @weaverryan! Looks good to me! 😁

[javiereguiluz]

Just asking ... is this convention based on the : prefix imposed somehow to us? Otherwise, it looks strange to introduce this new convention when we all know and use the {{ ... }} to output the value of variables or expressions. Thanks.

[weaverryan]

It's borrowed from Vue, and also is used Blade Components. I agree that it feels like an "extra" thing, but it's also a very common syntax to see.

[WebMamba]

And you can still use the {{ ... }}, the : is just a small shortcut.

[javiereguiluz]

OK, so this is a very common syntax outside of Symfony. Then, it makes sense to have it too. Thanks.

[weaverryan]

Btw, I found that it is more or less "needed" when you want to pass non-string values - like booleans or arrays:

<twig:Alert :showClose="false" :messages="['hello', 'world']" />

[jdreesen]

Suggested change

	Passing props is done with HTML attributes. For example if you have this component::
	Passing props is done with HTML attributes. For example if you have this component:

[javiereguiluz]

@jdreesen actually, the double :: is needed. We use RST format instead of Markdown. code blocks are declared as .. code-block:: php. But since we have so many PHP code blocks, it's boring to do that. That's why we use a RST trick to tell it that any code following two :: is to be considered as PHP code.

[jdreesen]

Oh, I didn't know that. Thx for the explanation.