INSTRUCTION.old.md · OSCHINA-MIRROR/zackratos-UltimateBarX

0.7.0 и более ранние версии:

В файле build.gradle в корневом каталоге добавьте:

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

В файл build.gradle в дочернем каталоге добавьте:

dependencies {
    implementation 'com.gitee.zackratos:UltimateBarX:0.6.1'
}

В классе Activity или Fragment:

val background = BarBackground.newInstance() // создание объекта background
    .color(Color.TRANSPARENT) // цвет (значение цвета) для строки состояния/панели навигации
    .colorRes(R.color.deepSkyBlue) // цвет (идентификатор ресурса) для строки состояния/панели навигации
    .drawableRes(R.drawable.bg_common) // drawable для строки состояния/панели навигации. Можно выбрать один из трёх методов.

val config = BarConfig.newInstance() // создание конфигурационного объекта
    .fitWindow(true) // не вторгаться в строку состояния (true — не вторгаться, false — вторгаться)
    .background(background) // установка объекта background
    .light(false) // режим light. Для шрифта строки состояния: true — серый, false — белый (Android 6.0+)
                                // Для кнопок панели навигации: true — серые, false — белые (Android 8.0+)

UltimateBarX.with(this) // применение к текущему Activity или Fragment
    .config(config) // использование конфигурации
    .applyStatusBar() // применение к строке состояния

UltimateBarX.with(this) // применение к текущему Activity или Fragment
    .config(config) // использование конфигурации
    .applyNavigationBar() // применение к панели навигации

Для старых версий режим light не работает. Можно создать новый объект background для настройки фона строки состояния или панели навигации для старых версий:

val lvLightBackground = BarBackground.newInstance()
    .color(Color.GRAY)
    .colorRes(R.color.alphaBlack)
    .drawableRes(R.drawable.bg_gradient)

val config = BarConfig.newInstance()
    .fitWindow(true)
    .background(background)
    .light(false)
    .lvLightBackground(lvLightBackground)

UltimateBarX.with(this)
    .config(config)
    .applyStatusBar()

Также можно вызвать методы последовательно:

UltimateBarX.with(this)
    .fitWindow(true)  
    .color(Color.TRANSPARENT)
    .colorRes(R.color.deepSkyBlue)
    .drawableRes(R.drawable.bg_gradient)
    .light(false)
    .lvLightColor(Color.GRAY)
    .lvLightColorRes(R.color.alphaBlack)
    .lvLightDrawableRes(R.drawable.bg_yellow_alpha_black)
    .applyStatusBar()

Чтобы быстро установить прозрачный эффект, используйте метод transparent():

UltimateBarX.with(this)
    .transparent()
    .applyStatusBar()

Эффект будет таким же, как при использовании следующего кода:

UltimateBarX.with(this)
    .fitWindow(false)
    .color(Color.TRANSLUCENT)
    .applyStatusBar()

Метод get() позволяет изменять предыдущий результат. Например, сначала установите красный цвет строки состояния, не вторгайтесь в неё и отключите режим light:

UltimateBarX.with(this)
    .color(Color.RED)
    .fitWindow(true)
    .light(false)
    .applyStatusBar()

Затем включите режим light, оставив остальные параметры без изменений:

UltimateBarX.get(this)
    .light(true)
    .applyStatusBar()

Если нужно добавить высоту строки состояния или панели навигации к определённому View, когда строка состояния или панель навигации могут вторгаться в макет, используйте следующие методы:

UltimateBarX.addStatusBarTopPadding(targetView)
UltimateBarX.addNavigationBarBottomPadding(targetView)

// Если используется Kotlin, можно использовать методы расширения напрямую:
targetView.addStatusBarTopPadding()
targetView.addNavigationBarBottomPadding()

OSCHINA-MIRROR/zackratos-UltimateBarX

Опубликовать ( 0 )

Введение

Обновления (2)

Участники

Недавние действия