/**
* Gets the current content of a slot, if any.
* If slot content is null, then raises an event
* to try to fill the slot. If it is filled,
* returns the content. Otherwise, returns null.
* @method fillSlot
* @static
* @param {string|array} $slotName The name of the slot.
* @param {boolean} [$default_slotName=null] If the slot named in $slotName returns null,
* the handler corresponding to the default slot will be called,
* passing it the requested slot's name in the 'slotName' parameter,
* and its value will be returned instead.
* Note: this does not fill the slot named $default_slotName!
* That is to say, the computed value is not saved, so that
* the slot's handler is called again if it is ever consulted again.
* @param {string} [$prefix=null] Sets a prefix for the HTML ids of all the elements in the slot.
* @return {string|null}
*/
static function fillSlot($slotName, $default_slotName = null, $prefix = null)
{
if (isset(self::$slots[$slotName])) {
return self::$slots[$slotName];
}
$prev_slotName = self::$slotName;
self::$slotName = $slotName;
if (isset($prefix)) {
Q_Html::pushIdPrefix($prefix);
}
try {
if (isset($default_slotName)) {
if (!Q::canHandle("Q/response/{$slotName}")) {
/**
* @event Q/response/$default_slotName
* @param {string} slotName
* @return {string}
*/
$result = Q::event("Q/response/{$default_slotName}", compact('slotName'));
if (isset(self::$slots[$slotName])) {
// The slot was already filled, while we were rendering it
// so discard the $result and return the slot's contents
return self::$slots[$slotName];
}
return self::$slots[$slotName] = $result;
}
}
/**
* @event Q/response/$slotName
* @return {string}
*/
$result = Q::event("Q/response/{$slotName}");
} catch (Exception $e) {
self::$slotName = $prev_slotName;
if (isset($prefix)) {
Q_Html::popIdPrefix();
}
throw $e;
}
self::$slotName = $prev_slotName;
if (isset($prefix)) {
Q_Html::popIdPrefix();
}
if (isset(self::$slots[$slotName])) {
// The slot was already filled, while we were rendering it
// so discard the $result and return the slot's contents
return self::$slots[$slotName];
}
if (isset($result)) {
self::setSlot($slotName, $result);
return $result;
}
// Otherwise, render default slot
if (!isset($default_slotName)) {
return null;
}
/**
* @event Q/response/$default_slotName
* @param {string} slotName
* @return {string}
*/
return Q::event("Q/response/{$default_slotName}", compact('slotName'));
}
