ikkez/f3-template-directives

PHP Fat-Free 框架的模板指令集合

v1.2.2 2022-02-15 20:30 UTC

This package is auto-updated.

Last update: 2024-09-16 02:09:49 UTC


README

PHP Fat-Free 框架 收集了不同的模板指令。

此软件包为您提供了一个基础,以便您可以轻松编写自己的模板标签处理器(指令)。因此,扩展 \Template\TagHandler 类并实现其 build 方法。您还可以查看包含的、现成的指令

form

form / input / select / textarea 元素提供服务器端数据处理的额外表单相关 HTML 标签处理器集合。

初始化

\Template\Tags\Form::initAll();

这会自动注册以下指令:inputselectoptiontextareaform

您可以将设置到全局 POST 变量的任何数据相应地填充到注册的表单元素中。如果您想使用不同的蜂巢密钥,可以这样做

// change source key
$f3->copy('POST','form1');
\Template\Tags\Form::instance()->setSrcKey('form1');

您还可以根据表单名称属性动态填充表单字段

<form name="contact">

字段目标设置为 FORM.contact

$f3->copy('POST','FORM.contact');
\Template\Tags\Form::instance()->setDynamicSrcKey(true);

更多测试,请参阅:http://f3.ikkez.de/formtest

markdown

转换行内 markdown 文本或渲染文件。

<markdown>
# Headline

You can write **markdown** here
</markdown>

<markdown src="path/to/file.md" />

初始化

\Template\Tags\Markdown::init('markdown');

image

自动渲染图像缩略图。

初始化

\Template\Tags\Image::init('image' [, $tmpl [, $options ] ] );

选项

  • temp_dir,生成临时缩略图的公共可访问路径
  • file_type,导出图像的默认文件类型,pngjpeggifwbmp
  • default_quality,图像质量,0-100
  • not_found_fallback,缺失图像的回退路径
  • not_found_callback,在此定义一个可调用的函数,当图像路径未找到时执行。函数接收 $filePath 作为第一个参数。

用法

<image src="path/to/image.jpg" width="200" />

额外属性

  • width,目标图像宽度
  • height,最大图像高度
  • crop,允许按宽度/高度比例裁剪图像
  • enlarge,当源图像小于目标大小时,放大图像
  • quality,覆盖默认质量

许可

GPLv3