V4 Block Func

[ragboyjr]

Add a block func that will allow the following semantics:

<?php $v->block('section-name') ?>
// define the default block here
<?php $v->end() ?>

If the section exists, it should echo the section content and discard the content from the end callback. If it does not exist, it should output the contents from the end callback.

This maybe depends on #177

A different alternative is to use an if statement. This is more verbose, but allows us to not even buffer the default content if we don't want to.

<?php if ($v->block('section-name')): ?>
// define the default block content here
<?php endif; ?>

In this scenario, the block func simply echos the section content and returns false it exists, or just returns true.

[ragboyjr]

• Delayed rendering feature #73
• Less verbose section override? #48

[ragboyjr]

Would very much like other opinions on this one to see what the community would prefer.

[ragboyjr]

@velosipedist @gmazzap What do you think about this syntax?

[ragboyjr]

I'm leaning towards the if block syntax.

[carbontwelve]

Not that it carry's much weight but my personal opinion is that the if block syntax makes sense; however I do read if ($v->block('section-name')): as if block with name 'section-name' exists display default text.

[ragboyjr]

Hmm, interesting point. maybe if (!$v->block('section-name')):?

@carbontwelve

I was trying to save on characters, and i was worried people would omit the ! and end up having both options displayed.

But i'm not sold on either way. Just need feedback from the community to see what makes the most sense.

[ragboyjr]

If use the block/end syntax, there would be no ambiguity like you mention; however, we'd have to needlessly process everything in the if block.

[ragboyjr]

Maybe we could come up with a way that everything between block and end is lazily evaluated.

[ragboyjr]

I ended up going with just a second parameter to the section func instead of adding a new one. I felt like it was confusing to have two functions that do the same thing, and the if statement part was a little weird.

The new syntax allows a closure to be passed in as the second parameter which is lazily evaluated.

        <?=$v->section('meta', function() { ?>
        <meta charset="UTF-8"/>
        <?php }); ?>