明凯博客

关注网站技术,一个特立独行的程序员

WordPress的body_class()函数详解

wordpress新增了一个body_class()函数,顾名思义,这个函数根据不同的页面类型为body标签生成class选择器,从而让设计人员可以各方便灵活的控制不同页面中的各个元素。
本文对这一函数进行了详细的解析,包括该函数生成了些什么,所包含的属性值有哪些,以及如何使用和如何新增class选择器等等。

1. body_class()生成什么?

body_class()函数在Wordpress2.7几乎和post_class()有同样的运行方式,唯一不同的是class的生成。 body_class()函数生成的class大多是根据你的访问者在网站的位置。例如,如果访问者在你的博客首页,但你没有设置一个静态主页,函数和类 可能会产生如下所示:

1
2
<body class="home blog">
</body>

注意,这些是两个不同的class,你可以选择任何一个。

然而,如果你在某个帖子,body标签看起来可能是这样:

1
2
<body class="single postid-64">
</body>

如果你正在浏览一个页面,body_class()会生成这样:

1
2
<body class="page page-id-3 parent-page-id-0 page-template-default">
</body>

从本质上讲,body_class()会生成基于内容的动态CSS class,以及在什么情况下浏览。
例如,如果你是注册用户,且已经登录,body_class()会在body标签生成一个登录class。

以下为可用的body class的完整列表:

* rtl
* home
* blog
* archive
* date
* search
* paged
* attachment
* error404
* single postid-(id)
* attachmentid-(id)
* attachment-(mime-type)
* author
* author-(user_nicename)
* category
* category-(slug)
* tag
* tag-(slug)
* page
* page-parent
* page-child parent-pageid-(id)
* page-template page-template-(template file name)
* search-results
* search-no-results
* logged-in
* paged-(page number)
* single-paged-(page number)
* page-paged-(page number)
* category-paged-(page number)
* tag-paged-(page number)
* date-paged-(page number)
* author-paged-(page number)
* search-paged-(page number)

2. 如何为自己的主题添加body_class()

这实际上是一件容易的事情。假设你正在使用Wordpress2.8以上的版本,所有你需要做的就是增加一个新的模板标记。
你需要找到这些模板文件生成开放标签的位置,它通常在header.php文件里。

当你找到标签的位置后,请把它更改为:

1
2
<body <?php body_class(); ?>>
</body>

保存文件并上传到服务器,你就大功告成了。

3. 使用动态Body Class

现在我们有了body class,有什么大不了呢?我将会解释:

除了html元素外,标签包围着其他所有的HTML代码。
因此,body class允许我们对网页任何元素进行修改,具体到当前页面。

也许通过实例更容易理解:

我们主题左边有一个

1
2
<div id="content">
</div>

右边有一个

1
2
<div id="sidebar">
</div>

他们都在一个960px宽

1
2
<div id="container">
</div>

content div为600px宽,sidebar div为360px宽。
但是,当浏览单独的帖子页面,我让我的主题不显示sidebar。
现在,我们只剩下一个content div。不幸的是,container div为960px宽,而我们的content div却只有600px宽。

我们难道用一个大空白区填充我们的工具栏?该如何解决呢?使用body class这将很简单。我们只需要针对

在帖子页的情况进行定义。在CSS里为:

1
.single #content{ width: 960px; }

通过这样做,在帖子页面,content div为960px宽。我们正在增加一个简单有选择性的CSS系统。

4. 新增body_class()的class

在某些情况下,你将要添加自己的Class到body_class()里。如果你发现自己处在这种情况下,这些有些方法可以做到这一点。

首先,最简单的方法是通过自定义Class函数调用

body_class()

例如:

1
2
<body <?php body_class('my-class'); ?>
</body>

通过这样做,我们现在告诉

body_class()

函数增加my-class的输出。

第二,困难但更灵活的方式是,利用Wordpress的过滤器,增加新的body class。在这种情况下,我们将使用

get_body_class()

函数中的body_class过滤器。如果你不清楚过滤器如何运行,我将会在不久后写一篇文章。在此之前,看看你是否能够赶上来,非常容易。

这是增加使用过滤器增加class的例子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
< ?php
 
add_filter('body_class','my_body_classes');
 
function my_body_classes($classes, $class) {
 
// add ‘my-class’ to the $classes array
 
$classes[] = 'my-class';
 
// return the $classes array
 
return $classes;
 
}
 
?>

函数输入结果

1
body

,

相关文章

发表评论

电子邮件地址不会被公开。 必填项已用*标注