如何通过表单提交将HTML的data-pk传递给Django？哪种方案更优？

一、修改现有表单：使用隐藏输入字段传递PK #

当前模板里的data-pk是HTML自定义属性，表单提交时不会自动携带这个值，需要改成隐藏输入框来传递PK：

模板修改代码 #

{% for item in items %}
    <div class="product">
        {{ item.item_name }}
        <form method="POST">
            {% csrf_token %}
            <!-- 添加隐藏输入框，携带商品PK -->
            <input type="hidden" name="item_pk" value="{{ item.pk }}">
            <input type="submit" value="add to cart" class="add_product"/>
        </form>
    </div>
{% endfor %}

视图处理逻辑 #

在对应的视图函数中，通过request.POST.get('item_pk')获取传递的PK值：

from django.shortcuts import redirect
from .models import Item

def add_to_cart(request):
    if request.method == 'POST':
        # 获取提交的商品PK
        item_pk = request.POST.get('item_pk')
        try:
            # 验证商品是否存在
            item = Item.objects.get(pk=item_pk)
            # 这里写添加到购物车的逻辑：比如存入session或数据库
            # 示例：
            # cart = request.session.get('cart', {})
            # cart[str(item.pk)] = cart.get(str(item.pk), 0) + 1
            # request.session['cart'] = cart
        except Item.DoesNotExist:
            # 处理商品不存在的情况
            pass
        return redirect('cart')  # 重定向到购物车页面
    # GET请求直接重定向回首页
    return redirect('home')

二、更优方案：将PK包含在URL中 #

这种方案符合RESTful设计规范，语义更清晰，代码逻辑更直接，推荐新手使用。

1. 配置URL路由 #

在urls.py中添加带PK参数的路由：

from django.urls import path
from .views import add_to_cart_view

urlpatterns = [
    # 其他路由...
    path('add-to-cart/<int:pk>/', add_to_cart_view, name='add_to_cart'),
]

2. 编写视图函数 #

视图直接从URL参数中获取PK，无需处理表单字段：

from django.shortcuts import redirect
from .models import Item

def add_to_cart_view(request, pk):
    if request.method == 'POST':
        try:
            item = Item.objects.get(pk=pk)
            # 执行添加到购物车的逻辑
        except Item.DoesNotExist:
            pass
        return redirect('cart')
    return redirect('home')

3. 修改模板表单 #

将表单的action属性指向带PK的URL：

{% for item in items %}
    <div class="product">
        {{ item.item_name }}
        <form method="POST" action="{% url 'add_to_cart' item.pk %}">
            {% csrf_token %}
            <input type="submit" value="add to cart" class="add_product"/>
        </form>
    </div>
{% endfor %}

两种方案对比 #

对于Django新手，优先推荐URL包含PK的方案，因为它更贴合Django的设计理念，代码可读性更高，也更容易维护。

内容的提问来源于stack exchange，提问作者k_roszczak