feat: components v2 #2707

NeloBlivion · 2025-02-06T04:42:20Z

Summary

Soon

Edit by Lala:
Temporary reference: https://github.com/Lulalaby/discord-api-docs/blob/comp_v2/docs/interactions/Message_Components.md#v2-components

Yet another edit by Lala:
Official PR for the docs is available now at Components v2 discord/discord-api-docs#7487

Information

This PR fixes an issue.
This PR adds something new (e.g. new method or parameters).
This PR is a breaking change (e.g. methods or parameters removed/renamed).
This PR is not a code change (e.g. documentation, README, typehinting,
examples, ...).

Checklist

I have searched the open pull requests for duplicates.
If code changes were made then they have been tested.
- I have updated the documentation to reflect the changes.
If type: ignore comments were used, a comment is also left explaining why.
I have updated the changelog to include these changes.

Reference:

discord/flags.py

discord/types/components.py

thank u for proofreading Co-authored-by: JustaSqu1d <89910983+JustaSqu1d@users.noreply.github.com> Signed-off-by: UK <41271523+NeloBlivion@users.noreply.github.com>

Co-authored-by: JustaSqu1d <89910983+JustaSqu1d@users.noreply.github.com> Signed-off-by: plun1331 <plun1331@gmail.com>

NeloBlivion · 2025-04-23T17:30:20Z

When using a decorator in a container, should the items appear above or below items set in __init__

Icebluewolf · 2025-04-23T17:39:39Z

Can row not be used? But I would say below when not specified.

plun1331

disable_all_items and enable_all_items need to be updated

plun1331 · 2025-04-24T17:10:41Z

discord/abc.py

@@ -1605,6 +1605,8 @@ async def send(
                )

            components = view.to_components()
+            if view.is_components_v2():
+                flags.is_components_v2 = True


We should add an error here if content or embeds are provided, because some of the discord errors aren't very clear

discord/components.py

plun1331 · 2025-04-24T17:19:50Z

discord/ui/file.py

+
+class File(Item[V]):
+    """Represents a UI File.
+


Suggested change

.. note::

This component does not show media previews. Use :class:`MediaGallery` for previews instead.

plun1331 · 2025-04-24T17:20:01Z

discord/ui/file.py

+    .. versionadded:: 2.7
+
+    Parameters
+    ----------


plun1331 · 2025-04-24T17:20:46Z

discord/ui/media_gallery.py

+    Parameters
+    ----------
+    *items: :class:`MediaGalleryItem`
+        The initial items contained in this gallery, up to 10.


Document id

plun1331 · 2025-04-24T17:24:48Z

discord/ui/text_display.py

+    ----------
+    content: :class:`str`
+        The text display's content.
+    """


document id

plun1331 · 2025-04-24T17:24:56Z

discord/ui/thumbnail.py

+    .. versionadded:: 2.7
+
+    Parameters
+    ----------


discord/ui/view.py

plun1331 · 2025-04-24T17:26:47Z

discord/webhook/async_.py

    if view is not MISSING:
        payload["components"] = view.to_components() if view is not None else []
+        if view and view.is_components_v2():
+            flags.is_components_v2 = True


Error if content or embeds are sent with this flag enabled

plun1331 · 2025-04-24T17:28:12Z

examples/views/new_components.py

+    @button(label="Delete Message", style=ButtonStyle.red, id=200)
+    async def delete_button(self, button: Button, interaction: Interaction):
+        await interaction.response.defer(invisible=True)
+        await interaction.delete_original_response()


Suggested change

await interaction.delete_original_response()

await interaction.message.delete()

I think officially delete_original_response is recommended because defer is a response?

delete_original_response deletes whatever response you sent, it looks like what you want is to delete the message the button is on

I think having an edit button would be more useful in this scenario anyways, then the id functionality can be shown. That change can be made in a future PR though.

Co-authored-by: plun1331 <plun1331@gmail.com> Signed-off-by: UK <41271523+NeloBlivion@users.noreply.github.com>

Co-authored-by: Paillat <jeremiecotti@ik.me> Signed-off-by: UK <41271523+NeloBlivion@users.noreply.github.com>

Paillat-dev · 2025-04-27T22:43:05Z

discord/ui/container.py

@@ -137,6 +137,7 @@ def add_item(self, item: Item) -> None:

        self.items.append(item)
        self._add_component_from_item(item)
+        return self


The return types need to be changed to typing.Self

NeloBlivion and others added 4 commits February 6, 2025 05:40

base types and flags

714b2f6

style(pre-commit): auto fixes from pre-commit.com hooks

468f996

textdisplayComponent

905b9ff

more

49080e7

Lulalaby assigned Lulalaby and NeloBlivion Feb 6, 2025

Lulalaby added discord limitation Limitation imposed by discord priority: medium Medium Priority status: in progress Work in Progess feature Implements a feature upcoming discord feature Involves a feature not yet fully released by Discord labels Feb 6, 2025

Lulalaby added this to the v2.7 milestone Feb 6, 2025

Lulalaby requested review from Lulalaby, plun1331 and JustaSqu1d February 6, 2025 05:35

JustaSqu1d reviewed Feb 6, 2025

View reviewed changes

discord/flags.py Outdated Show resolved Hide resolved

NeloBlivion and others added 7 commits February 6, 2025 06:57

Section, TextDisplay

e3e7aba

style(pre-commit): auto fixes from pre-commit.com hooks

e961db5

remaining classes

947890d

style(pre-commit): auto fixes from pre-commit.com hooks

6e7dde9

basic view support start

d18a9c4

style(pre-commit): auto fixes from pre-commit.com hooks

5ab45fd

flag clarification

fb8d13d

plun1331 reviewed Feb 6, 2025

View reviewed changes

discord/types/components.py Outdated Show resolved Hide resolved

NeloBlivion and others added 6 commits February 7, 2025 05:53

complete models

65dc63d

style(pre-commit): auto fixes from pre-commit.com hooks

f86f707

Merge branch 'master' into components-v2

1cced5a

fix

3e03e84

fix2

0f8c20a

update loading_state

bf60ffc

NeloBlivion and others added 7 commits April 23, 2025 14:31

rough example

a09b8ce

style(pre-commit): auto fixes from pre-commit.com hooks

4dee8de

Apply suggestions from code review

0d1e695

thank u for proofreading Co-authored-by: JustaSqu1d <89910983+JustaSqu1d@users.noreply.github.com> Signed-off-by: UK <41271523+NeloBlivion@users.noreply.github.com>

style(pre-commit): auto fixes from pre-commit.com hooks

19e2f9f

Apply suggestions from code review

d3b78aa

Co-authored-by: JustaSqu1d <89910983+JustaSqu1d@users.noreply.github.com> Signed-off-by: plun1331 <plun1331@gmail.com>

adjust copy_text and fix example

8befa8b

style(pre-commit): auto fixes from pre-commit.com hooks

a1b7ed4

plun1331 requested changes Apr 23, 2025

View reviewed changes

pullapprove4 bot removed the PA: Maintainers pending label Apr 23, 2025

NeloBlivion and others added 6 commits April 24, 2025 16:19

disable_all_items and enable_all_items

6cfa8cc

style(pre-commit): auto fixes from pre-commit.com hooks

9c591c6

VAR

b624930

remove_item qol

7778210

brackets

0f3e7cd

style(pre-commit): auto fixes from pre-commit.com hooks

29c1d40

plun1331 self-requested a review April 24, 2025 17:09

pullapprove4 bot added the PA: Maintainers pending label Apr 24, 2025

plun1331 requested changes Apr 24, 2025

View reviewed changes

pullapprove4 bot removed the PA: Maintainers pending label Apr 24, 2025

NeloBlivion and others added 8 commits April 24, 2025 18:40

Update discord/ui/view.py

98a9bc5

Co-authored-by: plun1331 <plun1331@gmail.com> Signed-off-by: UK <41271523+NeloBlivion@users.noreply.github.com>

Update discord/components.py

45fe45e

Co-authored-by: plun1331 <plun1331@gmail.com> Signed-off-by: UK <41271523+NeloBlivion@users.noreply.github.com>

textdisplay limits

7c2d96d

Merge branch 'master' into components-v2

bd17372

Update discord/components.py

1c54b08

Co-authored-by: Paillat <jeremiecotti@ik.me> Signed-off-by: UK <41271523+NeloBlivion@users.noreply.github.com>

style(pre-commit): auto fixes from pre-commit.com hooks

2adca36

Update discord/components.py

2ee8c01

Co-authored-by: Paillat <jeremiecotti@ik.me> Signed-off-by: UK <41271523+NeloBlivion@users.noreply.github.com>

chaining support

6296f72

Paillat-dev suggested changes Apr 27, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: components v2 #2707

feat: components v2 #2707

NeloBlivion commented Feb 6, 2025 •

edited by Lulalaby

Loading

NeloBlivion commented Apr 23, 2025

Icebluewolf commented Apr 23, 2025

plun1331 left a comment

plun1331 Apr 24, 2025

plun1331 Apr 24, 2025

plun1331 Apr 24, 2025

plun1331 Apr 24, 2025

plun1331 Apr 24, 2025

plun1331 Apr 24, 2025

plun1331 Apr 24, 2025

plun1331 Apr 24, 2025

NeloBlivion Apr 24, 2025

plun1331 Apr 24, 2025

Icebluewolf Apr 24, 2025

Paillat-dev Apr 27, 2025



	.. note::
	This component does not show media previews. Use :class:`MediaGallery` for previews instead.

	await interaction.delete_original_response()
	await interaction.message.delete()

feat: components v2 #2707

Are you sure you want to change the base?

feat: components v2 #2707

Conversation

NeloBlivion commented Feb 6, 2025 • edited by Lulalaby Loading

Summary

Information

Checklist

Reference:

NeloBlivion commented Apr 23, 2025

Icebluewolf commented Apr 23, 2025

plun1331 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

NeloBlivion commented Feb 6, 2025 •

edited by Lulalaby

Loading