react-native-screens 5.0.0-alpha.1 → 5.0.0-alpha.3

package/android/src/main/java/com/swmansion/rnscreens/stack/header/appbar/StackHeaderAppBarLayout.kt

@@ -0,0 +1,240 @@
+package com.swmansion.rnscreens.stack.header.appbar
+
+import android.annotation.SuppressLint
+import android.content.Context
+import android.graphics.Color
+import android.graphics.drawable.PaintDrawable
+import android.view.LayoutInflater
+import android.view.ViewGroup.LayoutParams.MATCH_PARENT
+import android.view.ViewGroup.LayoutParams.WRAP_CONTENT
+import android.view.WindowInsets
+import android.widget.TextView
+import androidx.coordinatorlayout.widget.CoordinatorLayout
+import androidx.core.view.WindowInsetsCompat
+import androidx.core.view.children
+import com.google.android.material.appbar.AppBarLayout
+import com.google.android.material.appbar.CollapsingToolbarLayout
+import com.google.android.material.appbar.MaterialToolbar
+import com.swmansion.rnscreens.stack.header.config.StackHeaderCollapsedTitleGravityMode
+import com.swmansion.rnscreens.stack.header.config.StackHeaderType
+import com.swmansion.rnscreens.utils.resolveDimensionAttr
+
+internal sealed class StackHeaderAppBarLayout(
+    context: Context,
+) : AppBarLayout(context) {
+    abstract val toolbar: MaterialToolbar
+
+    internal abstract val defaultContentInsetStart: Int
+    internal abstract val defaultContentInsetEnd: Int
+
+    init {
+        layoutParams =
+            CoordinatorLayout.LayoutParams(MATCH_PARENT, WRAP_CONTENT).apply {
+                behavior = StackHeaderAppBarLayoutBehavior()
+            }
+
+        // TODO: this won't work with nested header but there were some problems with lift on scroll
+        //       without it when I was researching this.
+        fitsSystemWindows = true
+    }
+
+    internal class Small(
+        context: Context,
+    ) : StackHeaderAppBarLayout(context) {
+        override val toolbar =
+            MaterialToolbar(context).apply {
+                elevation = 0f
+                layoutParams = LayoutParams(MATCH_PARENT, WRAP_CONTENT)
+            }
+
+        override val defaultContentInsetStart: Int = toolbar.contentInsetStart
+        override val defaultContentInsetEnd: Int = toolbar.contentInsetEnd
+
+        // Setting text size and typeface separately (Toolbar exposes only a whole text appearance)
+        // needs the title/subtitle TextViews, and Toolbar has no getter for them. Material locates
+        // them by matching the current text (internal ToolbarUtils.getTitleTextView); we attempt
+        // the same, but since we don't have current text, we use distinct placeholders - they force
+        // both views into existence and tell them apart — and clear the text only after capturing
+        // the references. Toolbar keeps both instances for its lifetime (empty text only detaches
+        // them), so the references stay valid.
+        internal val titleTextView: TextView
+        internal val subtitleTextView: TextView
+
+        // Keeps the status bar strip in sync with the bar's effective color through
+        // the lift animation (same per-frame mixed color Material applies to the
+        // background). Detached when an explicit statusBarScrimColor is set.
+        private var statusBarScrimSyncEnabled = false
+        private val statusBarScrimSync =
+            object : LiftOnScrollProgressListener() {
+                override fun onUpdate(
+                    elevation: Float,
+                    backgroundColor: Int,
+                    progress: Float,
+                ) {
+                    statusBarForeground?.setTint(backgroundColor)
+                }
+            }
+
+        init {
+            addView(toolbar)
+
+            // PaintDrawable is not color-extractable, so AppBarLayout's built-in
+            // colorSurface-keyed strip tint sync can never activate and fight the
+            // listener above (or an explicit scrim color) — regardless of theme.
+            statusBarForeground = PaintDrawable().apply { setTint(Color.TRANSPARENT) }
+
+            toolbar.title = TITLE_PLACEHOLDER
+            toolbar.subtitle = SUBTITLE_PLACEHOLDER
+            titleTextView = toolbar.findTextViewWithText(TITLE_PLACEHOLDER)
+            subtitleTextView = toolbar.findTextViewWithText(SUBTITLE_PLACEHOLDER)
+            toolbar.title = ""
+            toolbar.subtitle = ""
+        }
+
+        internal fun setStatusBarScrimSyncEnabled(enabled: Boolean) {
+            if (statusBarScrimSyncEnabled == enabled) return
+            statusBarScrimSyncEnabled = enabled
+            if (enabled) {
+                addLiftOnScrollProgressListener(statusBarScrimSync)
+            } else {
+                removeLiftOnScrollProgressListener(statusBarScrimSync)
+            }
+        }
+
+        private fun MaterialToolbar.findTextViewWithText(text: String): TextView =
+            children.filterIsInstance<TextView>().first { it.text?.toString() == text }
+
+        private companion object {
+            private const val TITLE_PLACEHOLDER = "rns_title"
+            private const val SUBTITLE_PLACEHOLDER = "rns_subtitle"
+        }
+    }
+
+    @SuppressLint("ViewConstructor")
+    internal class Collapsing(
+        context: Context,
+        val type: StackHeaderType,
+        collapsedTitleGravityMode: StackHeaderCollapsedTitleGravityMode,
+    ) : StackHeaderAppBarLayout(context) {
+        override val toolbar =
+            MaterialToolbar(context).apply {
+                elevation = 0f
+                layoutParams =
+                    CollapsingToolbarLayout
+                        .LayoutParams(
+                            MATCH_PARENT,
+                            resolveDimensionAttr(context, android.R.attr.actionBarSize),
+                        ).apply {
+                            collapseMode = CollapsingToolbarLayout.LayoutParams.COLLAPSE_MODE_PIN
+                        }
+            }
+
+        override val defaultContentInsetStart: Int = toolbar.contentInsetStart
+        override val defaultContentInsetEnd: Int = toolbar.contentInsetEnd
+
+        // collapsedTitleGravityMode is a construction-time-only attr (no public setter), so both
+        // gravity modes are inflated from XML — differing only in that attribute — to stay 1:1.
+        internal val collapsingToolbarLayout: CollapsingToolbarLayout =
+            (
+                LayoutInflater
+                    .from(context)
+                    .inflate(layoutResFor(type, collapsedTitleGravityMode), this, false)
+                    as CollapsingToolbarLayout
+            ).apply { addView(toolbar) }
+
+        private var trackedTopInset = 0
+        private var currentVerticalOffset = 0
+
+        init {
+            require(
+                type == StackHeaderType.MEDIUM ||
+                    type == StackHeaderType.LARGE,
+            ) {
+                "[RNScreens] Collapsing StackHeaderAppBarLayout must be MEDIUM or LARGE type."
+            }
+            addView(collapsingToolbarLayout)
+
+            addOnOffsetChangedListener { _, verticalOffset ->
+                currentVerticalOffset = verticalOffset
+                updateContentScrimExclusion()
+            }
+        }
+
+        // Observed here because both AppBarLayout and CollapsingToolbarLayout
+        // install their own OnApplyWindowInsetsListener in their constructors —
+        // setting ours would silently replace Material's. Reads the same inset
+        // CTL uses for its status bar scrim bounds.
+        override fun dispatchApplyWindowInsets(insets: WindowInsets): WindowInsets {
+            @Suppress("DEPRECATION")
+            trackedTopInset =
+                if (fitsSystemWindows) {
+                    WindowInsetsCompat.toWindowInsetsCompat(insets, this).systemWindowInsetTop
+                } else {
+                    0
+                }
+            updateContentScrimExclusion()
+            return super.dispatchApplyWindowInsets(insets)
+        }
+
+        /**
+         * While a status bar scrim is installed, the content scrim skips the
+         * status-bar strip that the status bar scrim paints alone. Otherwise,
+         * the two scrims stack there while fading (they share the same partial
+         * alpha), showing a darker band during the transition. The strip spans
+         * `[-verticalOffset, -verticalOffset + topInset]` in CTL coordinates,
+         * matching the status bar scrim bounds set in
+         * `CollapsingToolbarLayout.draw`.
+         */
+        internal fun updateContentScrimExclusion() {
+            val contentScrim =
+                collapsingToolbarLayout.contentScrim
+            check(contentScrim is StackHeaderContentScrimDrawable) {
+                "[RNScreens] Unexpected contentScrim class."
+            }
+
+            contentScrim.exclusionBottom =
+                if (collapsingToolbarLayout.statusBarScrim != null && trackedTopInset > 0) {
+                    trackedTopInset - currentVerticalOffset
+                } else {
+                    0
+                }
+        }
+
+        private companion object {
+            fun layoutResFor(
+                type: StackHeaderType,
+                mode: StackHeaderCollapsedTitleGravityMode,
+            ): Int =
+                when (type) {
+                    StackHeaderType.MEDIUM ->
+                        when (mode) {
+                            StackHeaderCollapsedTitleGravityMode.ENTIRE_SPACE ->
+                                com.swmansion.rnscreens.R.layout.rns_collapsing_toolbar_medium_entire_space
+                            StackHeaderCollapsedTitleGravityMode.AVAILABLE_SPACE ->
+                                com.swmansion.rnscreens.R.layout.rns_collapsing_toolbar_medium_available_space
+                        }
+                    StackHeaderType.LARGE ->
+                        when (mode) {
+                            StackHeaderCollapsedTitleGravityMode.ENTIRE_SPACE ->
+                                com.swmansion.rnscreens.R.layout.rns_collapsing_toolbar_large_entire_space
+                            StackHeaderCollapsedTitleGravityMode.AVAILABLE_SPACE ->
+                                com.swmansion.rnscreens.R.layout.rns_collapsing_toolbar_large_available_space
+                        }
+                    else -> error("[RNScreens] Invalid header mode.")
+                }
+        }
+    }
+
+    companion object {
+        fun create(
+            context: Context,
+            type: StackHeaderType,
+            collapsedTitleGravityMode: StackHeaderCollapsedTitleGravityMode,
+        ): StackHeaderAppBarLayout =
+            when (type) {
+                StackHeaderType.SMALL -> Small(context)
+                StackHeaderType.MEDIUM, StackHeaderType.LARGE ->
+                    Collapsing(context, type, collapsedTitleGravityMode)
+            }
+    }
+}

package/android/src/main/java/com/swmansion/rnscreens/stack/header/{StackHeaderAppBarLayoutBehavior.kt → appbar/StackHeaderAppBarLayoutBehavior.kt}

@@ -1,4 +1,4 @@
-package com.swmansion.rnscreens.stack.header
+package com.swmansion.rnscreens.stack.header.appbar
 
 import android.view.View
 import androidx.coordinatorlayout.widget.CoordinatorLayout

package/android/src/main/java/com/swmansion/rnscreens/stack/header/appbar/StackHeaderContentScrimDrawable.kt

@@ -0,0 +1,36 @@
+package com.swmansion.rnscreens.stack.header.appbar
+
+import android.graphics.Canvas
+import android.graphics.drawable.ColorDrawable
+import androidx.core.graphics.withClip
+
+/**
+ * Content scrim that can skip the status-bar strip painted by the
+ * CollapsingToolbarLayout status bar scrim. Both scrims share the same alpha
+ * while fading, so wherever they overlap the strip composites darker than the
+ * rest of the scrim during the transition.
+ */
+internal class StackHeaderContentScrimDrawable(
+    color: Int,
+) : ColorDrawable(color) {
+    // Bottom of the skipped band in CollapsingToolbarLayout coordinates; the
+    // visible top edge of the scrim always aligns with the strip top. Values
+    // <= bounds.top disable the exclusion.
+    internal var exclusionBottom: Int = 0
+        set(value) {
+            if (field != value) {
+                field = value
+                invalidateSelf()
+            }
+        }
+
+    override fun draw(canvas: Canvas) {
+        if (exclusionBottom <= bounds.top) {
+            super.draw(canvas)
+            return
+        }
+        canvas.withClip(bounds.left, exclusionBottom, bounds.right, bounds.bottom) {
+            super.draw(canvas)
+        }
+    }
+}

package/android/src/main/java/com/swmansion/rnscreens/stack/header/{StackHeaderScrollingViewBehavior.kt → appbar/StackHeaderScrollingViewBehavior.kt}

@@ -1,4 +1,4 @@
-package com.swmansion.rnscreens.stack.header
+package com.swmansion.rnscreens.stack.header.appbar
 
 import android.view.View
 import androidx.coordinatorlayout.widget.CoordinatorLayout

package/android/src/main/java/com/swmansion/rnscreens/stack/header/config/StackHeaderCollapsedTitleGravityMode.kt

@@ -0,0 +1,6 @@
+package com.swmansion.rnscreens.stack.header.config
+
+internal enum class StackHeaderCollapsedTitleGravityMode {
+    ENTIRE_SPACE,
+    AVAILABLE_SPACE,
+}