python - 我如何在模板中使用 Flask 的 url_for？

Question

我正在构建一个 Flask 应用程序来使用 SQL 数据库管理角色扮演游戏的角色表。

目前，我有以下脚本显示数据库中当前用户的角色列表。

@app.route("/<cha_name>")
@login_required
def character_sheet():
    characters = db.execute(
        """SELECT
          *
        FROM
            characters
        WHERE
            user_id = :user_id AND
            name = :cha_name
        """,
        user_id=session["user_id"],
        cha_name="???",
    )

    if not characters:
        return render_template("add_char.html")

我想包含一个按钮，用于导航到特定所选角色的角色表。因此，下面的页面将详细介绍角色的一些统计信息，然后一个按钮会将用户带到另一页上填充的角色表。

到目前为止，这是我用于显示特定用户角色的内容。

{% extends "main.html" %}

{% block title %}
    Characters
{% endblock %}

{% block main %}
      <table border = 1>
         <thead>
            <td>Player</td>
            <td>Name</td>
            <td>Race</td>
            <td>Class</td>
            <td>Level</td>
            <td>Status</td>
            <td>View</td>
         </thead>

         {% for row in rows %}
            <tr>
               <td>{{ character["user"] }}</td>
               <td>{{ character["name"] }}</td>
               <td>{{ character["race"] }}</td>
               <td>{{ character["cha_class"] }}</td>
               <td>{{ character["level"] }}</td>
               <td>{{ character["status"] }}</td>
               <td><a href={{ url_for('cha_name') }}>View Sheet</a></td> <!-- HERE -->
            </tr>
         {% endfor %}

      </table>
      <a href = "/add_char">Add a new Character</a>
      <a href = "/">Go back to home page</a>

   </body>
{% endblock %}

我在 <!-- HERE --> 线上使用什么？链接到字符表 URL？

Answer 1

哇，这里有很多东西要打开!

您的示例无效/无效，例如cha_name= 在 db.execute() 调用结束时，如果找到字符，则不会调用 render_template，因此它'即使有有效请求也永远不会产生响应。

接下来，您已告诉 Flask 将 cha_name 参数传递给您的 character_sheet 函数，但尚未在函数本身上定义参数。

最后，在您的模板中，您将 cha_name 传递给 url_for 函数，这(目前我们从示例代码中可以看出)不是路由你定义的，所以不能工作。

您需要提供更多信息以便我们提供帮助，例如告诉我们您遇到的错误。现在，我想 Flask 服务甚至不会因为语法错误而启动。修复后，我希望看到如下内容:

werkzeug.routing.BuildError: Could not build url for endpoint 'cha_name'. Did you mean 'character_sheet' instead?

我建议您返回 documentation on URL building并查看 docs for the route decorator .您会在后者上看到“Flask 本身将 View 函数的名称假定为端点”。这意味着为了让 Flask 为您的 character_sheet 函数生成一个 URL，您需要将该名称传递给 url_for，然后是参数，如下所示:

url_for('character_sheet', cha_name=character.name)

如果用户重命名他们的角色，所有的 URL 都会改变，这是一种糟糕的用户体验 — 如果他们为特定角色添加了书签，然后修复了名称中的拼写错误，会发生什么情况？

将所有这些放在一起，这是一个希望更好的示例:

# app.py
@login_required
@app.route("/<character_id>")
def character_sheet(character_id):
    characters = db.execute(
        """SELECT
          *
        FROM
            characters
        WHERE
            id = :id AND
            user_id = :user_id
        """,
        id=character_id,
        user_id=session["user_id"],
    )

    if not characters:
        return abort(404)

    return render_template(
        "characters/sheet.html",
        character=characters[0],
    )

<!-- templates/characters/list.html -->
{% extends "main.html" %}

{% block title %}
    Characters
{% endblock %}

{% block main %}
    <table>
         {% for character in characters %}
            <tr>
               <td>{{ character.name }}</td>
               <td><a href={{ url_for('character_sheet', character_id=character.id) }}>View Sheet</a></td>
            </tr>
         {% endfor %}
    </table>
    <a href = "{{ url_for('add_char') }}">Add a new Character</a>
{% endblock %}