Изображения

Класс ChatImages предоставляет набор предопределённых изображений и иконок, используемых в интерфейсе чата. Поддерживает как SF Symbols, так и кастомные изображения из бандла приложения.

к сведению

Для упрощения настройки и уменьшения размера SDK в качестве иконок по умолчанию используются SF Symbols

Описание

ChatImages — это базовый класс, предоставляющий унифицированный доступ к различным иконкам и изображениям приложения. Все изображения реализованы через класс ChatImage, который поддерживает:

• SF Symbols с возможностью указания размера и цвета
• Кастомные изображения из ресурсов SDK
• Унифицированное управление цветом заливки (tintColor)

Этот подход обеспечивает консистентность UI и упрощает темизацию.

---

Доступные изображения

🔍 Поиск

Переменная	Тип	Назначение
searchButtonImage	SF Symbol	Иконка поиска
searchNotFoundPlaceholderImage	SF Symbol	Изображение для "ничего не найдено"

---

⬅️➡️ Навигация

Переменная	Тип	Назначение
backButtonImage	SF Symbol	Иконка кнопки "Назад"
nextButtonImage	SF Symbol	Иконка кнопки "Вперёд"
keyboardShowImage	SF Symbol	Показ клавиатуры
keyboardHideImage	SF Symbol	Скрытие клавиатуры

---

✉️ Отправка сообщений

Переменная	Тип	Назначение
sendButtonImage	SF Symbol	Отправить сообщение
attachButtonImage	SF Symbol	Прикрепить файл

---

📭 Плейсхолдеры

Переменная	Тип	Назначение
emptyChatPlaceholderImage	SF Symbol	Чат пустой
errorPlaceholderImage	SF Symbol	Ошибка загрузки чата

---

👍👎 Реакции

Переменная	Тип	Назначение
likeEmptyImage	SF Symbol	Неактивный лайк
likeFullImage	SF Symbol	Активный лайк
dislikeEmptyImage	SF Symbol	Неактивный дизлайк
dislikeFullImage	SF Symbol	Активный дизлайк

---

⭐ Рейтинг

Переменная	Тип	Назначение
starRatingEmptyImage	SF Symbol	Неактивная звезда
starRatingFullImage	SF Symbol	Активная звезда

---

📎 Файлы и медиа

Переменная	Тип	Назначение
fileImage	SF Symbol	Файл
chatBubble	Кастомное	Маска сообщения

---

🔺🔻 Прокрутка

Переменная	Тип	Назначение
scrollToTopImage	SF Symbol	Прокрутка наверх
scrollToBottomImage	SF Symbol	Прокрутка вниз

---

👤 Аватары

Переменная	Тип	Назначение
avatarPlaceholderImage	SF Symbol	Плейсхолдер аватара

---

❌ Меню и действия

Переменная	Тип	Назначение
closeButtonImage	SF Symbol	Закрыть
menuCopyImage	SF Symbol	Скопировать
menuQuoteImage	SF Symbol	Цитировать

---

🗣️ Голосовые сообщения

Переменная	Тип	Назначение
voiceButtonImage	SF Symbol	Запись голосового
voiceSendButtonImage	SF Symbol	Отправка голосового
voicePlayImage	SF Symbol	Воспроизведение
voicePauseImage	SF Symbol	Пауза

---

✅ Статусы сообщений

Переменная	Тип	Назначение
sentStatusImage	Кастомное	Сообщение отправлено
pendingStatusImage	SF Symbol	Сообщение в процессе
readStatusImage	Кастомное	Сообщение прочитано

---

⚠️ Предупреждения

Переменная	Тип	Назначение
alertImage	SF Symbol	Предупреждение
shieldImage	SF Symbol	Защита
editImage	SF Symbol	Редактировать

---

⚠️ Ошибки и уведомления

Переменная	Тип	Назначение
errorInfoImage	SF Symbol	Иконка информации об ошибке
errorAlertImage	SF Symbol	Иконка предупреждения об ошибке
errorShieldImage	SF Symbol	Иконка ошибки типа файла
editImage	SF Symbol	Иконка редактирования
scheduleImage	SF Symbol	Иконка расписания/нерабочего времени

Класс ChatImage

Класс ChatImage представляет собой унифицированную обёртку над UIImage, поддерживающую:

• SF Symbols
• Кастомные изображения
• Настройку цвета (tintColor)
• Управление размером

Конструкторы

/// SF Symbol
init(system name: String, tintColor: UIColor? = nil, renderingMode: UIImage.RenderingMode? = nil)

/// SF Symbol с указанием размера
init(system name: String, size: CGFloat = 14, tintColor: UIColor? = nil)

/// Кастомное изображение (для него нужно укзаать бандл, в котором оно хранится)
init(named: String,
    bundle: Bundle = Bundle(for: ChatImage.self)
    tintColor: UIColor? = nil,
    renderingMode: UIImage.RenderingMode? = nil)

Пример использования

Актуальный пример можно найти в демо приложении в MainViewController+Themes

import ChatCenterUI

/// Настройки тем оформления
extension MainViewController {
    func makeDarkTheme() -> ChatTheme {
        return ChatTheme(images: darkImages)
    }

    private var darkImages: ChatImages {
        let images = ChatImages()
        images.avatarPlaceholderImage = ChatImage(system: "person.circle.fill", tintColor: UIColor.white)
        return images
    }
}