在WordPress主题模板中调用
the_posts_pagination() 函数即可输出默认的分页导航，它会自动生成带页码和上下页按钮的链接。在WordPress网站中实现文章分页是提升用户体验和SEO效果的关键环节,WordPress内置了高效的分页函数，无需插件即可调用，以下是详细操作指南：
核心分页函数
在主题模板文件（如index.php、archive.php或category.php）的循环结束位置（endwhile;后）插入：
<?php
the_posts_pagination( array(
'mid_size' => 2, // 当前页码两侧显示的页码数
'prev_text' => __('« 上一页'),
'next_text' => __('下一页 »'),
'screen_reader_text' => __('文章分页导航') // 屏幕阅读器提示文本
) );
?>
参数自定义详解
通过调整数组参数控制分页样式：
mid_size：当前页左右显示的页码数量（推荐值2-3）end_size：首尾显示的页码数量（默认1）prev_next：是否显示上一页/下一页按钮（默认true）before_page_number/after_page_number：页码前后添加HTML（如<span class="page-link">）
样式优化技巧
默认输出结构包含以下CSS类,可直接通过主题样式表美化：
.pagination {
margin: 30px 0; /* 控制分页区域间距 */
}
.page-numbers {
padding: 8px 15px;
border: 1px solid #ddd;
margin: 0 5px;
}
.page-numbers.current {
background: #2271b1;
color: white;
border-color: #2271b1;
}
特殊场景处理
-
自定义查询分页
使用WP_Query时需在实例化后添加：$custom_query = new WP_Query( $args ); while ( $custom_query->have_posts() ) : ... // 循环结束后添加 echo paginate_links( array( 'total' => $custom_query->max_num_pages ) ); -
分页空白问题
当文章数量不足时，分页区域自动隐藏，如需强制显示，添加判断：if( $wp_query->max_num_pages > 1 ) { the_posts_pagination(); }
SEO最佳实践
- 语义化结构：默认输出
<nav class="navigation pagination">符合HTML5语义标准 - 链接可访问性：
screen_reader_text参数确保视障用户可识别导航区域 - URL规范化：分页链接自动添加
/page/2/结构，避免重复内容问题
故障排除
- 样式异常：检查主题是否已包含
.pagination类样式 - 链接404：确保后台设置→阅读→博客页面至多显示数量小于总文章数
- 插件冲突：停用第三方分页插件后测试
技术依据：本文实现方案遵循WordPress官方文档标准，适用于WordPress 4.1+版本，函数设计符合W3C无障碍标准（WCAG 2.1），分页结构已被Google搜索指南明确列为友好爬行路径。
原创文章，发布者：酷盾叔，转转请注明出处：https://www.kd.cn/ask/23589.html
