Skip to content

erickok/mimicry

Repository files navigation

mimicry

Mimicry is a tiny Android library -- actually just one class -- to format items in a ListAdapter to display as a grid. Why not just use a GridView? Because a MimicryAdapter can be used with other ListAdapters!

Screen shot of the mimicry-sample app

Usage

Import the library from Maven Central using Gradle:

compile 'nl.2312:mimicry:0.2'

You can also add the mimicry project as Android Library project or, if you prefer, just copy the sole nl.nl2312.mimicry.library.MimicryAdapter class to your project.

ListAdapter wrappedAdapter = new ArrayAdapter<String>(this, ..., ...);
ListAdapter mimicryAdapter = new MimicryAdapter(this, 3, wrappedAdapter);
listView.setAdapter(mimicryAdapter);

Since every row represented by the MimicryAdapter actually contains multiple items, the normal OnItemClickListener you use with a ListView is not sufficient. Instead, attach a OnMimicryItemClickedListener to catch item click events.

mimicryAdapter.setOnMimicryItemClicked(new OnMimicryItemClickedListener() {
    @Override
    public void onItemClicked(Object item) {
        // item is the object that teh wrapped adapter returned on getItem(Object)
    }
});

View recycling is supported as per the 0.2 release, but note that this requires the wrapped adapter to only use one view type (which is probably what you want anyway). A RuntimeException is thrown if multiple view types are explicitly reported by the wrapped adapter.

Contributing

Feel free to improve the code and send me pull requests! Perhaps the internal layout code could be improved, as the layout params of the contained views is overriden at the moment.

License

Designed and developed by Eric Kok of 2312 development.

Copyright 2014 Eric Kok

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.