https://github.com/JakeWharton/HanselAndGretel

Android library providing bread crumbs to the support library fragments.
https://github.com/JakeWharton/HanselAndGretel

Last synced: about 6 hours ago
JSON representation

Android library providing bread crumbs to the support library fragments.

• Host: GitHub
• URL: https://github.com/JakeWharton/HanselAndGretel
• Owner: JakeWharton
• License: apache-2.0
• Archived: true
• Created: 2011-12-24T07:45:02.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2012-10-06T07:11:30.000Z (about 12 years ago)
• Last Synced: 2024-05-09T09:12:14.780Z (7 months ago)
• Language: Java
• Homepage:
• Size: 1.19 MB
• Stars: 160
• Watchers: 15
• Forks: 55
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-android-ui - https://github.com/JakeWharton/HanselAndGretel

README

        
Hansel And Gretel

=================

Android library providing bread crumbs for compatibility fragments.

Usage

=====

*For a working implementation of this project see the `sample/` folder.*

 1. Include the widget in your view. This should usually be placed directly

    above the container in which the associated fragments will be displayed.

    

        

    

 2. In your `onCreate` method, bind the widget to the activity.

    

        FragmentBreadCrumbs crumbs = (FragmentBreadCrumbs)findViewById(R.id.breadcrumbs);

        crumbs.setActivity(this);

    

 3. Add the required style attributes to your theme.

    

        @drawable/hag__divider_dark

        @drawable/hag__background_dark

    

    or

    

        @drawable/hag__divider_dark

        @drawable/hag__background_dark

    

    or specify your own drawables for the divider and background.

    

 4. *(Optional)* Set the title of the initial view. This can be useful when the

    initial activity view has a default fragment.

    

        //continued from above

        crumbs.setTitle("Settings", null);

Including In Your Project

-------------------------

The HanselAndGretel library is presented as an Android library project. A

standalone JAR is not possible due to the theming capabilities offered by the

widget.

You can include this project by [referencing it as a library project[1] in

Eclipse or ant.

If you are a Maven user you can easily include the library by specifying it as

a dependency:

    

      com.jakewharton

      hanselandgretel

      1.0.2

      apklib

    

This project depends on the `Fragment` classes which are available in the

[Android Support Library][2].

Developed By

============

* Jake Wharton - 

License

=======

    Copyright 2012 Jake Wharton

    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.

 [1]: http://developer.android.com/guide/developing/projects/projects-eclipse.html#ReferencingLibraryProject

 [2]: http://developer.android.com/sdk/compatibility-library.html