ratrijs/html-builder

一个小巧易用的类,用于使用面向对象的方法生成HTML。

1.0.0-alpha1 2012-05-21 22:27 UTC

This package is not auto-updated.

Last update: 2024-09-14 13:46:23 UTC


README

# HTMLBuilder - 最好的HTML生成类!

HTMLBuilder 可以用来通过简单的面向对象接口生成/构建HTML。

功能和使用方法概述

一些代码片段,展示了 HTMLBuilder 的功能和API。

实例检索

要开始构建你的HTML,你首先需要创建HTMLBuilder对象。构造函数不需要任何参数。

你有两种方式可以实现这一点

  • 使用new关键字
  • HTMLBuilder::dispatch()方法

它们都会达到相同的效果,但HTMLBuilder::dispatch()方法具有作为一行代码的能力(至少在PHP版本 < 5.4中)。

通过new关键字进行初始化

<?php
$html = new HTMLBuilder;
?>

通过HTMLBuilder::dispatch()方法进行初始化

<?php
$html = HTMLBuilder::dispatch();
?>

HTML生成

几乎所有的实例方法都会将一个HTML标签追加到生成的HTML中,其中标签名是方法名。这些方法支持两个参数

  • content - 标签内的内容
  • attributes - 标签属性作为键值数组,其中键是属性名,值是属性值

两个参数都是可选的。也可以只传递 attributes 作为唯一参数。标签将自动关闭。

要保持标签打开,你有两个选择

  • 在标签方法之前使用HTMLBuilder::open()方法
  • 使用HTMLBuilder::open()方法和传递标签名和属性作为此方法的参数

实例方法作为标签

php

<?php
echo HTMLBuilder::dispatch()->p("Hello World");
?>

html

<p>Hello World</p>

保持标签打开以构建嵌套HTML

在标签方法之前使用HTMLBuilder::open()

php

<?php
echo HTMLBuilder::dispatch()->open()->div()->p("Hello World");
?>

html

<div><p>Hello World</p></div>
使用HTMLBuilder::open()并传递标签参数到其中

php

<?php
echo HTMLBuilder::dispatch()->open("div")->p("Hello World");
?>

html

<div><p>Hello World</p></div>