How to display a List as a whole, not one at a time
Normally, when you pass a List to a Text, Querki displays one copy of the text for each element of the List. For example, if you say:
<A, B, C> -> ""That is ____""
It will display as:
That is A That is B That is C
Most of the time, that's what you want. (Or so we've found so far.) But occasionally you may want to do something with the entire List. How do you do that?
If you start the Text with an asterisk, it makes this change:
<A, B, C> -> *""That is ____""
shows as:
That is A B C
Instead of showing the Text once for each element, it shows it once, period, and passes the List down into its guts.
This is also helpful when you want to show some Text if the received value is Empty. For example, say you want to show something only if the current user is not a member of this Space. The function _me(warnIfNotLocal = false)
gives you Empty in this case. But if you just passed that to a Text, it does work:
_me(warnIfNotLocal = false) -> _if(_isEmpty, ""You need to create an account!"")
This doesn't show anything! It's showing the Text once for each received element, but there aren't any. But if you instead say:
_me(warnIfNotLocal = false) -> _if(_isEmpty, *""You need to create an account!"")
Now the Text will show once, and the Empty value (which you don't care about) will be passed into it.