Skip to content
This repository has been archived by the owner on Nov 3, 2020. It is now read-only.
/ Michelangelo Public archive

Layout inflation library for Android based on annotations

Notifications You must be signed in to change notification settings

romainpiel/Michelangelo

Repository files navigation

Michelangelo

Layout inflation library for Android which uses annotation processing to write the code you don't want to write and simplify your compound views.

How to use

An example of use:

@InflateLayout(R.layout.custom_view)
public class MyCustomView extends FrameLayout {

    public MyCustomView(Context context) {
        super(context);
    }

    @AfterInflate
    public void updateTextView() {
        ((TextView) findViewById(R.id.my_text_view)).setText("hey!");
    }
}

R.layout.custom_view:

<merge xmlns:android="http://schemas.android.com/apk/res/android">

    <TextView
            android:id="@+id/my_text_view"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"/>

</merge>

Inflating that View is pretty straightforward:

MyCustomView view = Michelangelo.build(this, MyCustomView.class);

Post inflate methods

Use the annotation @AfterInflate on your compound view's methods you want to run straight after the layout is inflated with Michelangelo.

Michelangelo and ButterKnife

Michelangelo plays very well with Jake Wharton's library ButterKnife. Just add the annotation @InjectViews to your ViewGroup and Michelangelo will do the rest.

Example using ButterKnife:

@InflateLayout(R.layout.item_painting)
@InjectViews
public class PaintingItemView extends LinearLayout {

    @InjectView(R.id.image) ImageView image;
    @InjectView(R.id.title) TextView title;

    public PaintingItemView(Context context) {
        super(context);
        setOrientation(HORIZONTAL);
    }

    public void bind(Painting painting) {
        image.setImageResource(painting.getDrawableResId());
        title.setText(painting.getTitle());
    }
}

Order of events

When you call Michelangelo.build():

  1. The view gets inflated
  2. If specified, the injector is applied (ButterKnife.inject(view))
  3. If exist, methods annotated with @AfterInflate are run.

Sample

See the sample for a common use of this library with ListView adapters.

License

Copyright 2014 Romain Piel

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.

About

Layout inflation library for Android based on annotations

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published