From d0863429a39dbc99a52a6d781006e7075c743d33 Mon Sep 17 00:00:00 2001
From: Swann <swann.bouviermuller@gmail.com>
Date: Thu, 6 Jan 2022 15:34:31 -0500
Subject: [PATCH] Fixed documentation of Widget.id_for_label() empty return
value.
---
django/forms/widgets.py | 4 ++--
docs/ref/forms/widgets.txt | 3 ++-
2 files changed, 4 insertions(+), 3 deletions(-)
diff --git a/django/forms/widgets.py b/django/forms/widgets.py
index fffa7430fc..71f2710a2b 100644
--- a/django/forms/widgets.py
+++ b/django/forms/widgets.py
@@ -301,8 +301,8 @@ class Widget(metaclass=MediaDefiningClass):
def id_for_label(self, id_):
"""
- Return the HTML ID attribute of this Widget for use by a <label>,
- given the ID of the field. Return None if no ID is available.
+ Return the HTML ID attribute of this Widget for use by a <label>, given
+ the ID of the field. Return an empty string if no ID is available.
This hook is necessary because some widgets have multiple HTML
elements and, thus, multiple IDs. In that case, this method should
diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt
index e29a54c876..40c030669c 100644
--- a/docs/ref/forms/widgets.txt
+++ b/docs/ref/forms/widgets.txt
@@ -277,7 +277,8 @@ foundation for custom widgets.
.. method:: id_for_label(id_)
Returns the HTML ID attribute of this widget for use by a ``<label>``,
- given the ID of the field. Returns ``None`` if an ID isn't available.
+ given the ID of the field. Returns an empty string if an ID isn't
+ available.
This hook is necessary because some widgets have multiple HTML
elements and, thus, multiple IDs. In that case, this method should