ikkez / f3-template-directives
PHP Fat-Free 框架的模板指令集合
v1.2.2
2022-02-15 20:30 UTC
README
为 PHP Fat-Free 框架 收集了不同的模板指令。
此软件包为您提供了一个基础,以便您可以轻松编写自己的模板标签处理器(指令)。因此,扩展 \Template\TagHandler
类并实现其 build
方法。您还可以查看包含的、现成的指令
form
为 form / input / select / textarea 元素提供服务器端数据处理的额外表单相关 HTML 标签处理器集合。
初始化
\Template\Tags\Form::initAll();
这会自动注册以下指令:input
、select
、option
、textarea
、form
。
您可以将设置到全局 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
,导出图像的默认文件类型,png
、jpeg
、gif
或wbmp
default_quality
,图像质量,0-100not_found_fallback
,缺失图像的回退路径not_found_callback
,在此定义一个可调用的函数,当图像路径未找到时执行。函数接收$filePath
作为第一个参数。
用法
<image src="path/to/image.jpg" width="200" />
额外属性
width
,目标图像宽度height
,最大图像高度crop
,允许按宽度/高度比例裁剪图像enlarge
,当源图像小于目标大小时,放大图像quality
,覆盖默认质量
许可
GPLv3