pagesize 是一个用来控制“每页显示内容数量”的参数。

核心定义
- 名称:
pagesize - 类型: 变量/参数
- 作用: 在分页列表(如文章列表、产品列表、图集列表等)中,设定每一页要显示多少条数据。
你可以把它理解为“页面大小”或“分页大小”,当你在浏览一个网站的文章列表时,如果设置了 pagesize=10,那么每一页就会显示10篇文章,当你点击“下一页”时,就会显示第11到第20篇文章,以此类推。
在织梦中的具体应用场景
pagesize 主要在以下两个地方被广泛使用:
a) 在模板文件中
在织梦的列表模板(通常是 list_*.htm)中,你会在分页代码的底层模板里看到它。
文件位置: /templets/default/list_page.htm

在这个文件里,你会看到类似这样的代码:
<div class="dede_pages">
<ul class="pagelist">
{pagelist listitem="info,index,end,pre,next,pageno" listsize="5" /}
</ul>
</div>
这里的 {pagelist} 标签就是用来生成分页导航的,而 pagesize 的值,虽然不直接写在这个模板文件里,但它是由调用这个列表的页面或栏目来决定的。
b) 在标签中
pagesize 最主要的使用方式是在织梦的列表调用标签中作为属性出现,最常用的标签是 arclist 和 list。
示例 1: 在首页或栏目页调用文章列表

{dede:arclist typeid='1' titlelen='30' pagesize='10'}
<li>
<a href="[field:arcurl/]">[field:title/]</a>
<span>[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
</li>
{/dede:arclist}
代码解析:
typeid='1': 指定调用ID为1的栏目下的文章,len='30'`: 限制标题显示30个字符。pagesize='10': 这就是关键! 它告诉织梦,这个列表每页只显示10篇文章,如果这个列表被用于分页,织梦会根据这个值来切分数据。
*示例 2: 在自定义列表页(list_.php)中使用**
在织梦的列表页(如 list.php?tid=1),其对应的模板文件 list_1.htm 中,通常会使用 {dede:list} 标签来调用当前栏目的文章。
{dede:list pagesize='15'}
<div class="entry">
<h2><a href="[field:arcurl/]">[field:title/]</a></h2>
[field:description/]...
</div>
{/dede:list}
代码解析:
pagesize='15': 它指定了这个栏目列表页每页显示15篇文章,用户访问list.php?tid=1时,默认看到的就是最新的15篇文章。
pagesize 与 pagelist 的关系
这是一个非常重要的区别,很多新手会混淆:
pagesize(页面大小): 决定 每页显示多少条数据,这是后端逻辑,关乎数据如何被切分。pagelist(分页列表): 决定 分页导航栏如何显示,这是前端展示,关乎如何引导用户翻页。
pagelist 标签本身不控制 pagesize 的值,它只是根据 pagesize 的值来计算出总页数,并生成“首页、上一页、1, 2, 3... 下一页、末页”这样的导航链接。
如何修改 pagesize 的值?
修改 pagesize 的值非常简单,主要取决于你想要修改哪个列表的显示数量。
修改某个特定列表的显示数量
直接在你使用的列表标签(arclist 或 list)中修改 pagesize 的值即可。
你希望首页某个推荐模块每页显示20篇文章,就把 pagesize 改成20。
{dede:arclist typeid='2' pagesize='20' ...}
...
{/dede:arclist}
修改整个网站所有列表的默认显示数量
这个稍微复杂一点,需要修改织梦的核心文件。(操作前请务必备份文件!)
-
找到核心函数文件: 这个功能通常在
/include/arc.listview.class.php文件中定义,这个类是处理所有列表页面的核心。 -
查找并修改
PageSize属性: 打开arc.listview.class.php文件,搜索var $PageSize = 20;(或类似的行,默认值可能是20)。 将这里的数字20修改为你想要的默认值,15。// 在 arc.listview.class.php 文件中 class ListView extends Arc { // ... 其他代码 ... var $PageSize = 15; // 将这里的20修改为15 // ... 其他代码 ... } -
生效: 修改后,所有使用
{dede:list}标签且没有显式指定pagesize属性的列表页,都会自动使用这个新的默认值。
| 特性 | 说明 |
|---|---|
| 核心含义 | 页面大小,控制每页显示的内容条数。 |
| 主要用途 | 在列表标签(arclist, list)中作为属性使用。 |
| 作用对象 | 文章列表、产品列表、图集列表等所有需要分页展示的内容。 |
| 与分页导航关系 | pagesize 是 pagelist 生成的依据,决定了总页数。 |
| 修改方式 | 简单修改: 在标签里直接改值。全局修改: 修改核心文件 arc.listview.class.php。 |
理解 pagesize 是进行织梦CMS二次开发和网站内容布局优化的一个非常基础且重要的知识点。
