Skip to content

Keyboard

Внимание

Подразумевается, что вы уже ознакомились с документацией вк

Создавать клавиатуры в vkbottle очень просто.

Импортируйте Keyboard, KeyboardButtonColor и нужные вам action (например: Text, OpenLink, Location, VKApps, Callback)

Создайте объект клавиатуры:

1
2
3
4
5
6
7
8
from vkbottle import Keyboard, KeyboardButtonColor, Text
keyboard = Keyboard(one_time=True, inline=False)
# О параметрах one_time и inline вы можете прочитать в документации к апи вконтакте
keyboard.add(Text("Кнопка 1"), color=KeyboardButtonColor.POSITIVE)
# Первая строка (ряд) добавляется автоматически
keyboard.row()  # Переходим на следующую строку
keyboard.add(Text("Кнопка 2"))
keyboard.add(Text("Кнопка 3", payload={"command": 3}))

Теперь, чтобы получить json для отправки клавиатуры в сообщении можно использовать метод объекта клавиатуры get_json()

Например:

1
await message.answer(message="Смотри сколько кнопок!!", keyboard=keyboard.get_json())

Для клавиатуры доступен интерфейс билдера, поэтому весь код выше можно заменить этим:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
from vkbottle import Keyboard, KeyboardButtonColor, Text

# ...
keyboard = (
    Keyboard(one_time=True, inline=False)
    .add(Text("Кнопка 1"), color=KeyboardButtonColor.POSITIVE)
    .row()
    .add(Text("Кнопка 2"))
    .add(Text("Кнопка 3", payload={"command": 3}))
).get_json()

await message.answer(
    message="Смотри сколько кнопок!!",
    keyboard=keyboard
)

Примечание

Для того, чтобы удалить клавиатуру у пользователя, вам нужно отправить EMPTY_KEYBOARD.