Html 助手（Html）

由  创建， 最后一次修改 2016-02-24 Html 帮助类任何一个 web 应用程序会生成很多 HTMl 超文本标记。如果超文本标记是静态的， 那么将 PHP 和 HTML 混合在一个文件里?这种做法是非常高效的。但是，如果这些超文本标记是动态生成的，那么如果没有额外的辅助工具，这个过程将会变得复杂。 Yii 通过 HTML 帮助类来提供生成超文本标记的方法。这个帮助类包含有一系列的用于处理通用的 HTML 标签和其属性以及内容的静态方法。注意：如果你的超文本标记接近静态的，那么最好是直接使用 HTML。 没有必要把所有的超文本标记都用 HTML 辅助类来生成。基础由于通过字符串连接来生成动态的 HTML 会很容易变得凌乱， Yii 提供了一系列的静态方法来操作标签配置并基于这些配置来创建对应的标签。生成标签生成一个标签的代码类似如下：<?= Html::tag('p', Html::encode($user->name), ['class' => 'username']) ?>这个方法的第一个参数是标签名称。第二个是要装入到开始和结束标签间的内容。 注意到我们使用?Html::encode?。那是因为内容不会被自动的转码以允许在有需要的时候嵌套 HTML。 第三个参数是一个 HTML 配置数组，或者换言之，标签属性。在这个数组中，数组的下标是属性名称， 比如?class，href?或者?target，而值则是对应属性的值。以上代码会生成如下 HTML ：<p class="username">samdark</p>如果你只需要开启一个标签或者关闭一个标签，你可以使用?Html::beginTag()?和?Html::endTag()?方法。标签属性（ Options ）在 Html 帮助类很多方法和大量的小部件中都有使用。在这些情况下， 有一些额外的处理我们需要知道：如果一个值为 null ，那么对应的属性将不会被渲染。如果是布尔类型的值的属性，将会被当做?布尔属性?来处理。属性的值将会用 yii\helpers\Html::encode() 方法进行 HTML 转码处理。如果一个属性的值是一个数组，那么它将会被如下处理：如果这个属性是一个如 yii\helpers\Html::$dataAttributes 所列的数据属性， 比如?data?或者?ng，一系列的属性列表将会被渲染，每个代表值数组中的元素。 比如：?'data' => ['id' => 1, 'name' => 'yii']?将会生成?data-id="1" data-name="yii"；?'data' => ['params' => ['id' => 1, 'name' => 'yii'], 'status' => 'ok']?生成?data-params='{"id":1,"name":"yii"}' data-status="ok"。 注意后者 中，一个子数组被输出为 JSON 。如果这个属性不是一个数据属性，那么值将会被 JSON-encoded。比如：['params' => ['id' => 1, 'name' => 'yii']?生成?params='{"id":1,"name":"yii"}'。生成 CSS 类和样式当开始构造一个 HTML 标签的属性时，我们经常需要对默认的属性进行修改。 为了添加或者删除 CSS 类，你可以使用如下代码：$options = ['class' => 'btn btn-default'];if ($type === 'success') { Html::removeCssClass($options, 'btn-default'); Html::addCssClass($options, 'btn-success');}echo Html::tag('div', 'Pwede na', $options);// in case of $type of 'success' it will render// <div class="btn btn-success">Pwede na</div>基于同样的目的，针对?style?属性：$options = ['style' => ['width' => '100px', 'height' => '100px']];// gives style="width: 100px; height: 200px; position: absolute;"Html::addCssStyle($options, 'height: 200px; position: absolute;');// gives style="position: absolute;"Html::removeCssStyle($options, ['width', 'height']);当使用 yii\helpers\Html::addCssStyle() 方法时，你可以指定一个和 CSS 属性相关的名值对的数组， 也可以直接是一个类似?width: 100px; height: 200px;?的字符串。这些格式将会自动的被 yii\helpers\Html::cssStyleFromArray() 和yii\helpers\Html::cssStyleToArray() 方法进行转换。方法 yii\helpers\Html::removeCssStyle() 接收一个包含要被移除的属性数组作为参数。 如果只想移除一个属性，你可以直接传递一个字符串。标签内容的转码和解码为了让内容能够正确安全的显示，一些 HTML 特殊字符应该被转码。在 PHP 中， 这个操作由?htmlspecialchars?和htmlspecialchars_decode?完成。 直接使用这些方法的问题是，你总是需要指定转码所需的额外标志。由于标志一般总是不变的，而内容转码的过程为了避免一些安全问题， 需要和应用的默认过程匹配， Yii 提供了两个简单可用的对 PHP 原生方法的封装：$userName = Html::encode($user->name);echo $userName;$decodedUserName = Html::decode($userName);表单处理表单标签是大量的重复性劳动并且易错。因此， Yii 也提供了一系列的方法来辅助处理表单标签。注意： 考虑在处理 models 以及需要验证的情形下，使用 yii\widgets\ActiveForm 组件。创建表单表单可以用类似如下代码，使用 yii\helpers\Html::beginForm() 方法开启：<?= Html::beginForm(['order/update', 'id' => $id], 'post', ['enctype' => 'multipart/form-data']) ?>方法的第一个参数为表单将要被提交的 URL 地址。它可以以 Yii 路由的形式被指定，并由 yii\helpers\Url::to() 来接收处理。 第二个参数是使用的方法，默认为?post?方法。第三个参数为表单标签的属性数组。在上面的例子中， 我们把编码 POST 请求中的表单数据的方式改为?multipart/form-data。 如果是上传文件，这个调整是必须的。关闭表单标签非常简单：<?= Html::endForm() ?>按钮你可以用如下代码生成按钮：<?= Html::button('Press me!', ['class' => 'teaser']) ?><?= Html::submitButton('Submit', ['class' => 'submit']) ?><?= Html::resetButton('Reset', ['class' => 'reset']) ?>上述三个方法的第一个参数为按钮的标题，第二个是标签属性。标题默认没有进行转码，如果标题是由终端用输入的，那么请自行用 yii\helpers\Html::encode() 方法进行转码。输入栏input 相关的方法有两组：以?active?开头的被称为 active inputs，另一组则不以其开头。 active inputs 依据指定的模型和属性获取数据，而普通 input 则是直接指定数据。一般用法如下：type, input name, input value, options<?= Html::input('text', 'username', $user->name, ['class' =