Обратная совместимость стилей

Команда SberMobile делает все возможное, чтобы обеспечить обратную совместимость между всеми релизами SberMobile, включая основные. Однако в некоторых редких случаях нам приходится модифицировать компоненты платформы, сущности унифицированной модели данных и программные интерфейсы, так что после обновления до новой версии может потребоваться незначительная доработка продуктов и сервисов на базе платформы.

Что касается компонентов веб-интерфейса SberMobile, то команда предоставляет конвертеры совместимости с изменениями компонентов фронтенда при любом незначительном и большинстве крупных обновлений. Ситуация, когда вы сталкиваетесь с необходимостью пересмотреть и исправить/обновить пользовательский CSS, в идеале должна возникать только в том случае, если UI-компонент был полностью заменен на новый, более совершенный.

Как убедиться, что ваши стили в порядке

Следуйте основным правилам, чтобы убедиться, что ваши пользовательские стили CSS доживут до следующего обновления Сервера:

  • Избегайте слишком специфических комбинаторов в селекторах пользовательских правил CSS для стилизации элементов компонентов пользовательского интерфейса
    Комбинаторы потомков и детей не добавляют специфичности селектору, но могут "сломать" стиль, если между элементами появятся дополнительные HTML-обертки.

  • Избегайте слишком специфических селекторов в целом для пользовательских CSS-стилей
    Не полагайтесь на точную разметку компонента в данный момент и обращайтесь только к ключевым классам и элементам его структуры для составления правила.

  • Предпочитайте использовать HTML-классы, а не теги или идентификаторы элементов при написании CSS-селекторов
    HTML-элементы, используемые для компоновки UI-компонентов, могут меняться, но основные значения классов останутся прежними.

  • Не используйте в селекторах автоматически генерируемые классы, такие как sc-dIfARi или jUhsgI
    Эти классы не сохраняются долго даже в пределах пользовательской сессии и постоянно обновлены при повторном рендеринге компонента.

  • Используйте переменные CSS по умолчанию, чтобы переопределить их в соответствии с вашими потребностями
    Управление переменными CSS поможет сохранить массовую замену свойств стиля.

  • В худшем случае сохраняйте экспортированные версии Инструментальных панелей
    Это может помочь, если вы импортируете их на обновленный Сервер вместо того, чтобы работать с версиями до обновления.

Чтобы ознакомиться с общими рекомендациями по написанию пользовательских CSS, прочтите статью Лучшие практики пользовательских CSS.

Что делать, если возникли проблемы

Если после обновления Сервера что-то пошло не так:

  • Сначала устраните неполадки с пользовательским CSS, как описано в статье Устранение неполадок с CSS, чтобы найти возможные подсказки о том, что именно могло произойти.

  • Проверьте, не нарушены ли некоторые рекомендации из раздела Как убедиться, что ваши стили в порядке.

  • Попробуйте изменить любой из стилей, чтобы проверить, применится ли новое значение

  • Попробуйте импортировать Инструментальную панель из резервной копии

Если видимых причин, по которым ваши пользовательские стили перестали работать, нет и ничего из списка выше не помогает, пожалуйста, свяжитесь с нами для получения дальнейшей поддержки.