Class Card

constructor

• new Card(appContext: AppContext): Card

  Карточка с изображениями, заголовком и кнопками.

  Предоставляет унифицированный интерфейс для описания контента. Фактическая адаптация под формат целевой платформы происходит в адаптере платформы при вызове метода getCards().

  Parameters

  • appContext: AppContext

    Контекст приложения. ⚠️ Обычно НЕ создаётся вручную — автоматически передаётся через контроллер:

    // Правильно — через контроллер:
    this.card.addImage('token', 'Title');
    
    // НЕ рекомендуется — ручное создание:
    new Card(this.appContext); // appContext берётся из контроллера
    Copy

  Returns Card

button

card.addButton('Купить');
card.addButton({
    title: 'Подробнее',
    url: 'https://example.com'
});
Copy

desc

card.setDescription('Подробное описание товара');
Copy

images

card.addImage('product.jpg', 'Название товара', 'Описание товара');
Copy

isOne

card.isOne = true; // Отобразить только первый элемент
Copy

isUsedGallery

card.isUsedGallery = true; // Включить режим галереи
Copy

template

card.template = {
    type: 'custom_card',
    content: { ... }
};
Copy

title

card.setTitle('Название товара');
Copy

addButton

• addButton(button: TButton): this

  Добавляет кнопку в карточку.

  Parameters

  • button: TButton

    Кнопка для добавления (строка или объект)

  Returns this

  Example

  // Добавление простой кнопки
  card.addButton('Купить');
  
  // Добавление кнопки с дополнительными параметрами
  card.addButton({
      title: 'Подробнее',
      url: 'https://example.com',
      payload: { action: 'details' }
  });
  Copy

addImage

• addImage(
      image: string | null,
      title?: string,
      desc?: string,
      button?: TButton | null,
  ): this

  Добавляет изображение в карточку.

  Parameters

  • image: string | null

    Идентификатор или URL изображения

  • title: string = ' '

    Заголовок изображения

  • Optionaldesc: string = ' '

    Описание изображения

  • Optionalbutton: TButton | null = null

    Кнопки для элемента

  Returns this

  Remarks

  Ограничения на изображения:

  • Алиса: до 1MB, 1024x1024px, JPG/PNG
  • VK: до 5MB, рекомендуется 13:8, JPG/PNG/GIF
  • Telegram: до 10MB, 1280x1280px, JPG/PNG/WEBP
  • Viber: до 1MB, рекомендуется 400x400px, JPG/PNG

  Example

  // Добавление одного изображения
  card.addImage('image.jpg', 'Название', 'Описание');
  
  // Добавление изображения с кнопкой
  card.addImage('product.jpg', 'Товар', 'Описание', {
      title: 'Купить',
      url: 'https://shop.com/product',
      payload: { action: 'buy', id: 123 }
  });
  
  // Добавление нескольких изображений в галерею
  card.isUsedGallery = true;
  card.addImage('image1.jpg', 'Фото 1')
      .addImage('image2.jpg', 'Фото 2')
      .addImage('image3.jpg', 'Фото 3');
  Copy

addOneImage

• addOneImage(
      image: string | null,
      title?: string,
      desc?: string,
      button?: TButton | null,
  ): this

  Добавляет одно изображение в виде карточки. Внутри себя выставляет isOne в true. Если ранее были указаны другие изображения, то они очистятся. Стоит использовать в том случае, если у вас всегда должно отобразиться только 1 изображение.

  Parameters

  • image: string | null

    Идентификатор или URL изображения

  • title: string = ' '

    Заголовок изображения

  • Optionaldesc: string = ' '

    Описание изображения

  • Optionalbutton: TButton | null = null

    Кнопки для элемента

  Returns this

clear

• clear(): void

  Очищает все элементы карточки.

  Returns void

  Example

  card.clear(); // Удалить все изображения
  Copy

getCards

• getCards<TResult = unknown>(
      cardProcessing: TCardProcessing<TResult>,
      controller: BotController,
  ): TResult

  Получает карточку в формате для текущей платформы.

  Type Parameters

  • TResult = unknown

  Parameters

  • cardProcessing: TCardProcessing<TResult>
  • controller: BotController

  Returns TResult

setAppContext

• setAppContext(appContext: AppContext): this

  Устанавливает контекст приложения.

  Parameters

  • appContext: AppContext

  Returns this

setDescription

• setDescription(description: string): this

  Устанавливает описание для карточки.

  Parameters

  • description: string

    Описание карточки

  Returns this

  Example

  card.setDescription('Подробное описание товара');
  Copy

setTitle

• setTitle(title: string): this

  Устанавливает заголовок для карточки.

  Parameters

  • title: string

    Заголовок карточки

  Returns this

  Example

  card.setTitle('Название товара');
  Copy