MaterialToolbar

Features


Min SDK : 15
Price : Free
Language : Java

 

Download


Link : Github
Owner : Shyri
Source Code : Download

 

MaterialToolbar

MaterialToolbar makes it easy to build a Fragment navigation based application with fully customized toolbar views.

Alt text Alt text

Example

First thing you got to do is to set Theme.AppCompat.Light.NoActionBar in your AndroidManifest.xml file, and insert your MaterialToolbar instead of standard Toolbar in your activity xml layout. The layout also must to include a fragment container view such as this FrameLayout in which fragments will be placed

<LinearLayout xmlns:android=""
xmlns:tools=""
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context=".MainActivity">
<es.shyri.materialtoolbar.MaterialToolbar
android:id="@+id/main_toolbar"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:animateLayoutChanges="true"
android:background="?attr/colorPrimary"
android:minHeight="?attr/actionBarSize" />
<FrameLayout
android:id="@+id/fragmentContainer"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:animateLayoutChanges="true" />
</LinearLayout>

Note that I set the animateLayoutChanges flag in order to have smooth toolbar transitions.

After that you can override the onCreate method of the activity and attach the activity instance to the presenter. You have to provide also the layout id of the MaterialToolbar and the fragment container.

    @Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
presenter = MaterialPresenter.getInstance();                // get the instance of our presenter
// ATTACH the activity to the presenter telling it the id of the MaterialToolbar and the view holding the Fragments
presenter.attachActivity(this, R.id.main_toolbar, R.id.fragmentContainer);  
// Only if the fragment container has no fragment, we tell the MaterialPresenter to navigate to a new Fragment instance
// This will assure the right behaviour during screen rotation and other configuration changes
if (getFragmentManager().findFragmentById(R.id.fragmentContainer) == null) {
presenter.navigateTo(new MyAwesomeFragment());
}
}

Also for roation, other configuration changes and to avoid view leaks it is necessary to detach the activity from the presenter overriding the onDestroy() method

    @Override
protected void onDestroy() {
super.onDestroy();
presenter.detachActivity();
}

Finally we want to override the onBackPressed method to let the presenter handle the fragment backstack poping

    @Override
public void onBackPressed(){
if(!presenter.onBackPressed()) super.onBackPressed();
}

You have to implement MaterialToolbarSupplier only in the fragments that will provide custom Toolbar layout.
In the onCreateView method you must inflate the MaterialToolbarContent providing a layout. Note you can have different layouts, for example one for portrait and other for landscape. Here you can also instantiate views of your MaterialToolbarContent

public class MyAwesomeFragment extends Fragment implements MaterialToolbarSupplier {
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
// [...] infalte your fragment view
// This is your time to create your MaterialToolbarContent and instantiate the views.
toolbarContent = new MaterialToolbarContent(getActivity(), R.layout.my_awesome_toolbar);
// Tell the presenter to set the MaterialToolbarContent of this Fragment.
presenter.getToolbar().setContent(toolbarContent);
// Instantiate all views
Button myAwesomeButton = toolbarContent.findViewById(R.id.myAwesomeButton);
myAwesomeButton.findViewById(R.id.myAwesomeButton).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
presenter.navigateTo(new OtherFragment());  // We can use the presenter this Fragment to navigate to others.
}
});
// [...]
return view;
}
}

And also override the other MaterialToolbarSupplier methods, just one to get the presenter and other to return the MaterialToolbar to the presenter

    @Override
public void setPresenter(MaterialPresenter presenter) {
// get the presenter instance, you can use it later for navigate to children Fragments.
this.presenter = presenter;
}
@Override
public MaterialToolbarContent getToolbarContent() {
// This will allow the presenter to set the MaterialToolbarContent when user navigates back to 
// this Fragment or during configuration changes
return toolbarContent;
}

Download

MaterialToolbar is available through jcenter()

dependencies {
compile 'es.shyri:materialtoolbar:0.1.1'
}

License

Copyright 2015 Shyri Villar
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.