如何在 discord.py 中添加分页 - Python

在编写 Discord 机器人时，我们经常需要将长文本或消息拆分为多个页面进行显示。为此，我们可以使用 Discord.py 中的分页模块，使得呈现数据更加美观且易读。

1. 安装分页模块

为了在 Discord.py 中使用分页功能，我们需要安装一个额外的模块 discord-ext-menus。您可以使用以下命令进行安装：

pip install discord-ext-menus

2. 创建菜单

接下来，我们需要创建一个菜单来显示分页信息。示例菜单如下：

from discord.ext import menus

class PaginatedMenu(menus.ListPageSource):
    def __init__(self, data):
        super().__init__(data, per_page=10)

    async def format_page(self, menu, entries):
        offset = menu.current_page * self.per_page
        return '\n'.join(f'{i}. {v}' for i, v in enumerate(entries, start=offset))

此菜单将数据拆分成一页一页，每页最多显示 10 条数据。format_page 方法将当前页的数据格式化为字符串，并将其返回。这里我们将数据拼接为多行文本，每行包括一条信息的编号和内容。

3. 将菜单添加到命令中

一旦我们创建了菜单，就可以将其添加到我们的命令中。以下是一个使用 PaginatedMenu 的示例命令：

@bot.command()
async def history(ctx):
    # 模拟一些数据
    data = [f'Message {i+1}' for i in range(100)]

    # 创建菜单
    menu = menus.MenuPages(source=PaginatedMenu(data), clear_reactions_after=True)

    # 显示菜单
    await menu.start(ctx)

此命令将生成 100 条假数据，并将其传递给 PaginatedMenu。接着，我们使用 MenuPages 类创建菜单。该类提供了许多配置选项，例如是否显示嵌入式菜单、是否显示页码等。在这个例子中，我们使用默认的配置。最后，我们使用 menu.start() 方法显示菜单。

4. 显示效果

当我们运行 history 命令时，会弹出一个嵌入式菜单，并显示 10 条数据。菜单下方将有一排控制按钮，我们可以使用这些按钮来翻页或关闭菜单。效果如下：

结论

通过使用 Discord.py 提供的分页模块，我们很容易为机器人命令添加分页功能。此方法可以使得机器人命令中的数据更易读，并且更加美观。