格式化主题函数的 HTML 输出

Question

我已经实现了自己的主题函数 (theme_my_theme_function) 并实现了 hook_theme 来告诉 Drupal 我的函数。一切正常，我在页面上得到了我想要的输出，除了...

当我查看 HTML 源代码时，我的函数输出的所有 HTML 代码都在一长行中！如何让我的主题函数输出整洁且易于阅读的格式化 HTML？

Answer 1

如果您希望对 HTML 进行格式化，则必须在构建 HTML 字符串时自行完成。更简单的方法是使用模板文件，而不是手动构建 HTML 字符串（请记住，PHP 本质上是一种 HTML 模板语言）。这里有一篇关于如何做到这一点的很好的文章：http://drupal.org/node/165706

核心节点模块有一个很好的例子：

node.module:

<?php

/**
 * Implementation of hook_theme()
 */
function node_theme() {
  return array(
    'node' => array(
      'arguments' => array('node' => NULL, 'teaser' => FALSE, 'page' => FALSE),
      'template' => 'node',
    )
  );
}

node.tpl.php:

<div id="node-<?php print $node->nid; ?>" class="node<?php if ($sticky) { print ' sticky'; } ?><?php if (!$status) { print ' node-unpublished'; } ?> clear-block">

<?php print $picture ?>

<?php if (!$page): ?>
  <h2><a href="<?php print $node_url ?>" title="<?php print $title ?>"><?php print $title ?></a></h2>
<?php endif; ?>

  <div class="meta">
  <?php if ($submitted): ?>
    <span class="submitted"><?php print $submitted ?></span>
  <?php endif; ?>

  <?php if ($terms): ?>
    <div class="terms terms-inline"><?php print $terms ?></div>
  <?php endif;?>
  </div>

  <div class="content">
    <?php print $content ?>
  </div>

  <?php print $links; ?>
</div>

还有一种方法可以将 HTMLTidy 集成到 Drupal 中，以便它在输出之前“美化”标记，但我自己从未这样做过。

最后，我强烈建议不要担心 HTML 输出的格式。相反，请使用适用于 Firefox 的 Firebug 或适用于 Chrome/Safari 的 Inspector。它们都有一个“检查元素”工具，可以让您在一个漂亮的可浏览、可编辑的树中查看页面的标记。这对于 Web 开发来说是无价的。

*编辑*
theme_item_list 对 HTML 输出进行最少的格式化。下面是 theme_item_list 生成的列表示例：

<div class="item-list"><ul><li class="first">1</li> 
<li>2</li> 
<li>3</li> 
<li class="last">4</li> 
</ul></div>

在 theme_item_list 的代码中，您可以看到它只是在

后面添加了一个“\n”：

$output .= '<li' . drupal_attributes($attributes) . '>' . $data . "</li>\n";