clarify len

Author: NeloBlivion

discord/ui/action_row.py

@@ -63,6 +63,11 @@ class ActionRow(ViewItem[V]):
 
     .. versionadded:: 2.7
 
+    .. describe:: len(x)
+
+        Returns the total count of all items in this row.
+        This includes the row itself, counting towards Discord's component limits.
+
     Parameters
     ----------
     *items: :class:`ViewItem`

discord/ui/container.py

@@ -69,6 +69,11 @@ class Container(ViewItem[V]):
 
     .. versionadded:: 2.7
 
+    .. describe:: len(x)
+
+        Returns the total count of all items in this container.
+        This includes the container itself, counting towards Discord's component limits.
+
     Parameters
     ----------
     *items: :class:`ViewItem`

discord/ui/core.py

@@ -65,6 +65,13 @@ class ItemInterface:
 
     .. versionadded:: 2.7
 
+    .. container:: operations
+
+    .. describe:: len(x)
+
+        Returns the total count of all items in this interface.
+        This includes items that contain other items, which count towards Discord's component limits.
+
     Parameters
     ----------
     *items: :class:`Item`

discord/ui/item.py

@@ -58,6 +58,11 @@ class Item(Generic[T]):
 
     .. versionchanged:: 2.7
         Now used as base class for :class:`ViewItem` and :class:`ModalItem`.
+
+    .. describe:: len(x)
+
+        Returns how much this item counts towards Discord's component limits.
+        This is 1 for all items, plus 1 for each child item.
     """
 
     __item_repr_attributes__: tuple[str, ...] = ("id",)

discord/ui/section.py

@@ -55,6 +55,11 @@ class Section(ViewItem[V]):
 
     .. versionadded:: 2.7
 
+    .. describe:: len(x)
+
+        Returns the total count of all items in this section.
+        This includes the section itself, counting towards Discord's component limits.
+
     Parameters
     ----------
     *items: :class:`ViewItem`