Renderers¶
The renderer types are the base that tk-form, tk-table and tk-base build on.
use Tk\DomTemplate\Renderer\Renderer;
use Tk\DomTemplate\Template;
final class UserCard extends Renderer
{
public function __construct(private User $user) {}
protected function makeTemplate(): ?Template
{
return Template::file(__DIR__ . '/user-card.html');
}
public function show(): ?Template
{
return $this->getTemplate()?->text('name', $this->user->name);
}
}
| Type | Provides |
|---|---|
DisplayInterface |
show(): ?Template |
RendererInterface |
adds getTemplate() and setTemplate() |
RendererTrait |
the template handling, for classes that can't extend Renderer |
Renderer |
abstract base using the trait |
getTemplate()callsmakeTemplate()on first use. Override it, or callsetTemplate().- Cloning a
Rendererclones its template. A rendered template can't be copied, so a clone made after rendering starts without one and callsmakeTemplate()again on first use (a template given withsetTemplate()and nomakeTemplate()leaves the clone with none). A class that only usesRendererTraitshares its template between clones unless it adds its own__clone(). - Nothing is final; override what you need.