hendraanggrian / Collapsingtoolbarlayout Subtitle
Programming Languages
Projects that are alternatives of or similar to Collapsingtoolbarlayout Subtitle
SubtitleCollapsingToolbarLayout
Standard CollapsingToolbarLayout with subtitle support.
- Just like the title, subtitle text will have to be 1 line.
- When collapsed, a subtitle would still appear as Toolbar's.
- Separate configuration for title and subtitle: text color, gravity, etc.
Caveats
Since it uses a lot of CollapsingToolbarLayout resources and API, there are a few:
- Only safe to use with the same version of material components.
- Deceptive package name.
Also...
It is detabable if we even need this library. If the material guidelines says it's ok to have a multiline text in toolbar layout, then they surely would've already implemented such feature. If it doesn't say anything about subtitle (which is odds because Toolbar has it), then we probably shouldn't use it out of respect to the guidelines.
Download
This library follows AndroidX's revisions.
repositories {
google()
jcenter()
}
dependencies {
implementation "com.google.android.material:material:$version"
implementation "com.hendraanggrian.material:collapsingtoolbarlayout-subtitle:$version"
}
For older support library, use legacy artifacts.
implementation "com.android.support:design:$version"
implementation "com.hendraanggrian:collapsingtoolbarlayout-subtitle:$version"
Usage
Treat SubtitleCollapsingToolbarLayout
just like a regular CollapsingToolbarLayout
.
<androidx.coordinatorlayout.widget.CoordinatorLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent">
<com.google.android.material.appbar.AppBarLayout
android:layout_width="match_parent"
android:layout_height="wrap_content">
<com.google.android.material.appbar.SubtitleCollapsingToolbarLayout
android:id="@+id/subtitlecollapsingtoolbarlayout"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:contentScrim="?colorPrimary"
app:layout_scrollFlags="scroll|exitUntilCollapsed"
app:subtitle="Papua, Indonesia"
app:title="Raja Ampat">
<!-- collapsing toolbar content goes here -->
<androidx.appcompat.widget.Toolbar
android:layout_width="match_parent"
android:layout_height="?actionBarSize"
app:layout_collapseMode="pin"/>
</android.support.design.widget.SubtitleCollapsingToolbarLayout>
</com.google.android.material.appbar.AppBarLayout>
<!-- content goes here -->
</androidx.coordinatorlayout.widget.CoordinatorLayout>
Attributes
SubtitleCollapsingToolbarLayout
has all the attributes of CollapsingToolbarLayout
,
and a few extras.
Attribute | Description | Default value/behavior |
---|---|---|
subtitle |
subtitle text | disabled |
collapsedSubtitleTextAppearance |
text appearance of subtitle when collapsed | TextAppearance.AppCompat.Widget.ActionBar.Subtitle |
expandedSubtitleTextAppearance |
text appearance of subtitle when expanded | TextAppearance.AppCompat.Headline |