View API Reference#

View #

View(
    *,
    timeout: (
        float | int | datetime.timedelta | None
    ) = 120.0,
    autodefer: bool | AutodeferOptions = True
)

Bases: ItemHandler[hikari.impl.MessageActionRowBuilder, ResponseBuildersT, ViewContext, hikari.ComponentInteraction, ViewItem]

Represents a set of Discord UI components attached to a message.

PARAMETER	DESCRIPTION
`timeout`	The duration after which the view times out, in seconds TYPE: `Optional[Union[float, int, datetime.timedelta]]` DEFAULT: `120.0`
`autodefer`	If enabled, interactions will be automatically deferred if not responded to within 2 seconds You may also pass an instance of miru.AutodeferOptions to customize the autodefer behaviour. TYPE: `bool \| AutodeferOptions` DEFAULT: `True`

RAISES	DESCRIPTION
`ValueError`	Raised if a view has more than 25 components attached.
`RuntimeError`	Raised if miru.install() was never called before instantiation.

children `property` #

children: t.Sequence[ItemT]

A list of all items attached to the item handler.

timeout `property` #

timeout: float | None

The amount of time the item handler is allowed to idle for, in seconds. Must be None for persistent views.

client `property` #

client: Client

The client that started this handler.

last_context `property` #

last_context: ContextT | None

The last context that was received by the item handler.

is_persistent `property` #

is_persistent: bool

Determines if this view is persistent or not. A view is persistent only if it has no timeout and all of it's items have explicitly set custom_ids.

message `property` #

message: hikari.Message | None

The message this view is bound to. Will be None if the view is not bound.

is_bound `property` #

is_bound: bool

Determines if the view should be bound to a message or not.

autodefer `property` #

autodefer: AutodeferOptions

The autodefer configuration of this view.

get_item_by #

get_item_by(
    predicate: t.Callable[[ItemT], bool],
    *,
    default: T | hikari.UndefinedType = hikari.UNDEFINED
) -> ItemT | T

Get the first item that matches the given predicate.

PARAMETER	DESCRIPTION
`predicate`	A predicate to match the item. TYPE: `Callable[[Item[Any]], bool]`
`default`	The default value to return if the item doesn't exist. TYPE: `T` DEFAULT: `hikari.UNDEFINED`

RETURNS	DESCRIPTION
`ItemT \| T`	The item that matched the predicate or default.

RAISES	DESCRIPTION
`KeyError`	No item that matches predicate was found and no default was provided.

get_item_by_id #

get_item_by_id(
    custom_id: str,
    default: T | hikari.UndefinedType = hikari.UNDEFINED,
) -> ItemT | T

Get the first item that matches the given custom ID.

PARAMETER	DESCRIPTION
`custom_id`	The custom_id of the component. TYPE: `str`
`default`	The default value to return if the item doesn't exist. TYPE: `T` DEFAULT: `hikari.UNDEFINED`

RETURNS	DESCRIPTION
`ItemT \| T`	The item that matched the custom ID or the default.

RAISES	DESCRIPTION
`KeyError`	No item that matches the custom ID was found and no default was provided.

build #

build() -> t.Sequence[BuilderT]

Creates the action rows the item handler represents.

RETURNS	DESCRIPTION
`List[hikari.impl.MessageActionRowBuilder]`	A list of action rows containing all items attached to this item handler, converted to hikari component objects. If the item handler has no items attached, this returns an empty list.

on_timeout `async` #

on_timeout() -> None

Called when the item handler times out. Override for custom timeout logic.

wait `async` #

wait(timeout: float | None = None) -> None

Wait until the item handler has stopped receiving interactions.

PARAMETER	DESCRIPTION
`timeout`	The amount of time to wait, in seconds TYPE: `Optional[float]` DEFAULT: `None`

from_message `classmethod` #

from_message(
    message: hikari.Message,
    *,
    timeout: (
        float | int | datetime.timedelta | None
    ) = 120.0,
    autodefer: bool = True
) -> te.Self

Create a new view from the components included in the passed message. Returns an empty view if the message has no components attached.

PARAMETER	DESCRIPTION
`message`	The message to read components from TYPE: `hikari.Message`
`timeout`	The timeout of the created view TYPE: `Optional[float]` DEFAULT: `120.0`
`autodefer`	If enabled, interactions will be automatically deferred if not responded to within 2 seconds TYPE: `bool` DEFAULT: `True`

RETURNS	DESCRIPTION
`View`	The view that represents the components attached to this message.
`!!! warning`	This function constructs a completely new view based on the information available in the message object. Any custom behaviour (such as callbacks) will not be re-created, if you want to access an already running view that is bound to a message, use `Client.get_bound_view()` instead.

add_item #

add_item(item: ViewItem) -> te.Self

Adds a new item to the view.

PARAMETER	DESCRIPTION
`item`	The item to be added. TYPE: `ViewItem`

RAISES	DESCRIPTION
`ValueError`	A view already has 25 components attached.
`TypeError`	Parameter item is not an instance of ViewItem.
`RuntimeError`	The item is already attached to this view.
`RuntimeError`	The item is already attached to another view.

RETURNS	DESCRIPTION
`View`	The view the item was added to.

remove_item #

remove_item(item: ViewItem) -> te.Self

Removes an item from the view.

PARAMETER	DESCRIPTION
`item`	The item to be removed. TYPE: `ViewItem`

RAISES	DESCRIPTION
`ValueError`	The item is not attached to this view.

RETURNS	DESCRIPTION
`View`	The view the item was removed from.

clear_items #

clear_items() -> te.Self

Removes all items from the view.

RETURNS	DESCRIPTION
`View`	The view the items were removed from.

view_check `async` #

view_check(context: ViewContext) -> bool

Called before any callback in the view is called. Must evaluate to a truthy value to pass. Override for custom check logic.

PARAMETER	DESCRIPTION
`context`	The context for this check. TYPE: `ViewContextT`

RETURNS	DESCRIPTION
`bool`	A boolean indicating if the check passed or not.

on_error `async` #

on_error(
    error: Exception,
    item: InteractiveViewItem | None = None,
    context: ViewContext | None = None,
) -> None

Called when an error occurs in a callback function or the built-in timeout function. Override for custom error-handling logic.

PARAMETER	DESCRIPTION
`error`	The exception encountered. TYPE: `Exception`
`item`	The item this exception originates from, if any. TYPE: `Optional[MessageItem[ViewT]]` DEFAULT: `None`
`context`	The context associated with this exception, if any. TYPE: `Optional[Context]` DEFAULT: `None`

stop #

stop() -> None

Stop listening for interactions.

wait_for_input `async` #

wait_for_input(timeout: float | None = None) -> None

Wait for any input to be received. This will also unblock if the view was stopped, thus it is recommended to check for the presence of a value after this function returns.

PARAMETER	DESCRIPTION
`timeout`	The amount of time to wait for input, in seconds TYPE: `Optional[float]` DEFAULT: `None`

View API Reference#

View #

children property #

timeout property #

client property #

last_context property #

is_persistent property #

message property #

is_bound property #

autodefer property #