README

Sim 是一个工具，它允许将脚本逻辑与其表示分离，并在数据结构（接口）注释的层面上组织专业之间的工作。

Sim 的语法基于 DOM 元素的数据属性。这种方法排除了表示对模板化引擎的依赖，从而可以使用演示数据预览模板，同时也解决了开发者编辑器中 HTML 语法的突出显示问题。

在已知的模板化引擎中，表示可能看起来像这样

<h1>Users</h1>
<ul>
    {% for user in users %}
    <li>
        {{ user.username|e }}
    </li>
    {% endfor %}
</ul>

Sim 中的表示

<h1>Users</h1>
<ul>
     <li data-sim="repeat($data.users as $user); content($user.item:e);">
          User 1
     </li>
     <li data-sim="ignore();">User 2</li>
     <li data-sim="ignore();">User 3</li>
     <li data-sim="ignore();">User 4</li>
</ul>-

这样的模板将在浏览器中直接调用时正确显示，即使它所处理的数据不存在，也可以向客户展示。

模板可以是任何 HTML 文档或语法正确的 XML 文档。例如，我们创建一个文件 — my_template_file.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8" />
    <title>Title</title>
</head>
<body>
    <h1 data-sim="content($data.title)">Header Example</h1>
    <table>
        <thead>
            <tr>
                <th>Name</th>
                <th>Phone</th>
            </tr>
        </thead>
        <tbody>
            <tr data-sim="repeat($data.people as $person);">
                <td data-sim="content($person.item.name);">Someone's name</td>
                <td data-sim="content($person.item.phone);">Someone's phone</td>
            </tr>
            <tr data-sim="ignore();">
                <td>Andreas</td>
                <td>5226611</td>
            </tr>
            <tr data-sim="ignore();">
                <td>Wolfgang</td>
                <td>5226611</td>
            </tr>
        </tbody>
    </table>
</body>
</html>

您在 PHP 中需要做的只是包含 Sim 库并设置一些变量来配置模板化引擎。

<?php
require_once('Sim.php');

//Создаем объект шаблонизатора
$sim = new \Sim\Sim();

//Путь до директории с шаблонами
$sim->setRootPath('/templates/');

//Путь до директории хранения кеш-файлов
$sim->setCachePath('/cache/');

//Создаем массив данных
$data = array(
    'title' => 'Employee phone numbers',
    'people' => array(
        array('name' => 'Alex', 'phone' => '+12132775504'),
        array('name' => 'William', 'phone' => '+12132102192'),
        array('name' => 'Daniel', 'phone' => '+12136402431')
    )
);

//Выполняем обработку шаблона
$sim->execute('my_template_file.html', $data);

执行结果

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8" />
    <title>Title</title>
</head>
<body>
    <h1>Employee phone numbers</h1>
    <table>
        <thead>
            <tr>
                <th>Name</th>
                <th>Phone</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td >Alex</td>
                <td >+12132775504</td>
            </tr>
            <tr>
                <td >William</td>
                <td >+12132102192</td>
            </tr>
            <tr>
                <td >Daniel</td>
                <td >+12136402431</td>
            </tr>            
        </tbody>
    </table>
</body>
</html>

{% hint style="warning" %} Sim 不关心可读文件和生成文件中的换行符和缩进。为了获得美观的 HTML（带有换行和正确的缩进），您可以在后处理阶段使用额外的实用工具。{% endhint %}

upfactor / sim

维护者

详细信息

README