Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SimonVT/MessageBar
An Android Toast replacement, similar to the one seen in the GMail app.
https://github.com/SimonVT/MessageBar
Last synced: about 1 month ago
JSON representation
An Android Toast replacement, similar to the one seen in the GMail app.
- Host: GitHub
- URL: https://github.com/SimonVT/MessageBar
- Owner: SimonVT
- License: apache-2.0
- Created: 2013-03-24T21:07:44.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2013-08-07T15:10:58.000Z (over 11 years ago)
- Last Synced: 2024-08-02T02:11:31.458Z (4 months ago)
- Language: Java
- Homepage: http://simonvt.github.com/MessageBar/
- Size: 754 KB
- Stars: 551
- Watchers: 40
- Forks: 114
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-person - MessageBar
- awesome-android-ui - https://github.com/SimonVT/MessageBar
- awesome-android-ui - https://github.com/SimonVT/MessageBar
- awesome - MessageBar - An Android Toast replacement, similar to the one seen in the GMail app. (etc)
- awesome - MessageBar - An Android Toast replacement, similar to the one seen in the GMail app. (etc)
README
MessageBar
==========
An Android Toast replacement, similar to the one seen in the GMail app.
Multiple messages can be posted in succession, and each message will be
shown for 5 seconds.
Usage
=====
There's two ways to use the MessageBar. It can either be attached directly
to an activity, or a View can be passed.
Attaching to an activity
------------------------
This approach requires adding the following attributes to the Activity's theme.
```xml
@style/MessageBar.Container
@style/MessageBar.Message
@style/MessageBar.Button
```
Attaching the MessageBar is then done by passing the Activity to the
MessageBar constructor.
```java
mMessageBar = new MessageBar(this);
```
This will automatically add a MessageBar layout to the content view.
Attaching to a View
-------------------
This can be used e.g. when attaching to a Fragment, or if custom views
are to be used for showing the message.
When using this approach, child views with the following id's must be added
to the passed View.
* `mbContainer`: The container that holds the message and the button views.
* `mbMessage`: A TextView that displays the message.
* `mbButton`: A TextView that displays the button text.
As an example, this is the default layout that's used when attaching to an Activity.
```xml
```
The MessageBar is then attached by passing a parent view to the constructor.
Showing a message
-----------------
A message is shown simple by calling `MessageBar#show(...)`. A few methods are
available here. It can either simply show a message or show a message and a
button. When a button is shown, a Parcelable has to be passed that's then returned
via `MessageBar$OnMessageClickListener` if the button is clicked.
Example:
```java
mMessageBar.show("This is a message");
```
Credits
=======
* Roman Nurik for creating the [example][1] this library is based on.
License
=======
Copyright 2012 Simon Vig Therkildsen
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]: https://code.google.com/p/romannurik-code/source/browse/#git%2Fmisc%2Fundobar