FireLayout

Additional

Language
Java
Version
N/A
Created
Jan 23, 2017
Updated
Feb 4, 2017 (Retired)
Owner
Francesco Stranieri (FStranieri)
Contributor
Francesco Stranieri (FStranieri)
1
Activity
Badge
Generate
Download
Source code

Advertisement

FireLayout (Android)

Description

FireLayout is a CoordinatorLayout linked to its refence on your Firebase Real-Time Database. You can generate your own layout through firebase console.

Importing with Gradle

compile 'com.fs.firelayout:firelayout:0.2.5'

Importing with Maven

<dependency>
  <groupId>com.fs.firelayout</groupId>
  <artifactId>firelayout</artifactId>
  <version>0.2.5</version>
  <type>pom</type>
</dependency>

Setup

Configure your project with Firebase in order to use Firebase-Database with the auto-generated json file. Use the firebase plugin built in Android Studio.

How to

Create an instance of FireLayout in your layout file or by java code.

Example:

<com.fs.firelayout.FireLayout
        android:id="@+id/fire1"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />     

Note: 'android:id' is mandatory! It's the reference in your firebase database.

Now you have to instantiate the FireLayout:

...
FirebaseDatabase database = FirebaseDatabase.getInstance();
FireLayout fireLayout = (FireLayout) findViewById(R.id.fire1);

//if you want to listen events
fireLayout.setEventsListener(new FireLayout.EventsListener() {
            @Override
            public void onFireLayoutChildClicked(View view) {
                //if you add a tag in your view, you can do some logic to identify the view
            }

            @Override
            public void onFireLayoutChildLongClicked(View view) {
                //if you add a tag in your view, you can do some logic to identify the view
            }
        });

fireLayout.init(database);
...

Now you're ready to build your own layout!

Example (in sample app folder 'firelayoutSampleConf.json'):

{
  "fire1": {
    "relativelayout": {
      "layout_width": "match_parent",
      "layout_height": "match_parent",
      "padding": 5,
      "children": {
        "linearlayout": {
          "layout_width": "match_parent",
          "layout_height": "wrap_content",
          "orientation": "vertical",
          "center_in_parent": true,
          "gravity": "center",
          "children": {
            "imageview": {
              "tag": "img1",
              "layout_width": "wrap_content",
              "layout_height": "wrap_content",
              "srcUrl": "https://cdn4.iconfinder.com/data/icons/google-i-o-2016/512/google_firebase-512.png",
              "srcError": "ic_action_name",
              "onClick": true
            },
            "textview": {
              "layout_width": "match_parent",
              "layout_height": "wrap_content",
              "text": "Hi, FireLayout!",
              "textColor": "#FFFFFF",
              "textSize": 20,
              "background": "#404040",
              "gravity": "center",
              "padding": 5,
              "onClick": true
            },
            "button": {
              "tag": "bt1",
              "layout_width": "wrap_content",
              "layout_height": "wrap_content",
              "text": "OK",
              "textColor": "#404040",
              "background": "#FFFFFF",
              "gravity": "center",
              "padding": 5,
              "margin_top": 10,
              "onClick": true,
              "onLongClick": true
            }
          }
        }
      }
    }
  }
}

Import your json in your Firebase database and you're done!

Views

This library is in development and I'm adding new attributes and views. I'll update the following list each update:

Views :

  • All

tag = "tag" (use it as identifier)

layout_width = integer / "wrap_content" / "match_parent"

layout_height = integer / "wrap_content" / "match_parent"

background = "exadecimal_code", see example

enable = true/false, default true

visibility = "gone" / "invisible", default visible

padding = integer (if exists, other padding values won't be effective)

padding_top = integer

padding_left = integer

padding_right = integer

padding_bottom = integer

margin = integer (if exists, other margin values won't be effective)

margin_top = integer

margin_left = integer

margin_right = integer

margin_bottom = integer

onClick = true/false, default false

onLongClick = true/false, default false

ViewGroups:

  • All:

    children = {"childviewname" : {}}

  • linearlayout (LinearLayout)

    orientation = "vertical" / "horizontal"

    gravity = "center" / "center_horizontal" / "center_vertical" / "bottom" / "top" / "left" / "right"

  • relativelayout (RelativeLayout)

    gravity = "center" / "center_horizontal" / "center_vertical" / "bottom" / "top" / "left" / "right"

    RelativeLayout has optional rules for its children, so in your child object you can add following (see json sample):

    align_parent_left = true / false, default false

    align_parent_top = true / false, default false

    align_parent_right = true / false, default false

    align_parent_bottom = true / false, default false

    align_parent_start = true / false, default false

    align_parent_end = true / false, default false

    center_in_parent = true / false, default false

    center_horizontal = true / false, default false

    center_vertical = true / false, default false

Children Views :

  • textview (TextView)

    text = "text"

    textColor = "exadecimal_code", see example

    textSize = integer / double

    gravity = "center" / "center_horizontal" / "center_vertical" / "bottom" / "top" / "left" / "right"

  • edittext (EditText)

    text = "text"

    hint = "hint"

    textColor = "exadecimal_code", see example

    textSize = integer / double

    gravity = "center" / "center_horizontal" / "center_vertical" / "bottom" / "top" / "left" / "right"

  • button (Button)

    text = "text"

    textColor = "exadecimal_code", see example

    textSize = integer / double

    gravity = "center" / "center_horizontal" / "center_vertical" / "bottom" / "top" / "left" / "right"

  • imageview (ImageView)

    src = "name of drawable, in drawable folders"

    srcUrl = "url to image", not effective if src is set

    srcError = "name of drawable, in drawable folders", this is your image when srcUrl fails and It's not effective if src is set

    adjustViewBounds = boolean, default false

    scaleType = "scaletype", accepted values : "CENTER", "CENTER_CROP", "CENTER_INSIDE", "FIT_CENTER", "FIT_END", "FIT_START", "FIT_XY", "MATRIX". Default is CENTER_INSIDE.

    colorFilter = "exadecimal_code", see example

    maxHeight = number

    maxWidth = number

LICENSE

Copyright 2016 Francesco Stranieri

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.