Android 增強版百分比佈局庫 為了適配而擴充套件

鴻洋_發表於2015-07-06

轉載請標明出處:
http://blog.csdn.net/lmj623565791/article/details/46767825
本文出自:【張鴻洋的部落格】

一 概述

上週一我們釋出了Android 百分比佈局庫(percent-support-lib) 解析與擴充套件中對percent-support這個庫進行了解析和新增了PercentLinearLayout的支援。

那麼為什麼本篇部落格的存在的意義是什麼呢?

首先我們回顧下百分比佈局庫的用法,提供了PercentRelativeLayoutPercentFrameLayout供大家在編寫的時候,對於以下屬性:

layout_widthPercentlayout_heightPercent
layout_marginPercentlayout_marginLeftPercent
layout_marginTopPercentlayout_marginRightPercent
layout_marginBottomPercentlayout_marginStartPercentlayout_marginEndPercent

可以使用百分比進行設定寬、高、邊距,的確給我們在適配上提供了極大的便利,但是在使用過程中,覺得存在一些場景無法得到滿足。什麼場景呢?下面我舉幾個例子。

  1. 當使用圖片時,無法設定寬高的比例

    比如我們的圖片寬高是200*100的,我們在使用過程中我們設定寬高為20%、10%,這樣會造成圖片的比例失調。為什麼呢?因為20%參考的是螢幕的寬度,而10%參考的是螢幕的高度。

  2. 很難使用百分比定義一個正方形的控制元件

    比如,我現在介面的右下角有一個FloatingActionButton,我希望其寬度和高度都為螢幕寬度的10%,很難做到。

  3. 一個控制元件的margin四個方向值一致

    有些時候,我設定margin,我希望四邊的邊距一致的,但是如果目前設定5%,會造成,上下為高度的5%,左右邊距為寬度的5%。

綜合上述這些問題,可以發現目前的percent-support-lib並不能完全滿足我們的需求,所以我們考慮對其進行擴充套件。說白了,我們就希望在佈局的時候可以自己設定參考看度還是高度,比如上述2,我們對於寬高可以寫成10%w,10%w。也就是在不改變原庫的用法的前提下,新增一些額外的支援。


二 擴充套件的功能

目前我初步對該庫進行了改寫,github地址:android-percent-support-extend,對於官方庫,做了如下的改變:

  1. 不改變原有庫的用法
  2. 新增了PercentLinearLayout
  3. 支援百分比指定特定的參考值,比如寬度或者高度。

    例如:app:layout_heightPercent="50%w", app:layout_marginPercent="15%w",
    app:layout_marginBottomPercent="20%h".

  4. 支援通過app:layout_textSizePercent設定textView的textSize
  5. 對於外層套ScrollView的問題,目前可以在PercentLinearLayout的外層使用ScrollView,不過對於寬度的百分比參考的就是android.R.id.content的高度(因為,無法參考父控制元件的高度,父控制元件的高度理論上依賴於子View高度,且模式為UNSPECIFIED)。

對於如何匯入,也是相當的簡單,android studio的使用者,直接:

dependencies {
    //...
    compile 'com.zhy:percent-support-extends:1.0.1'
}

不需要匯入官方的percent-support-lib了。

對於的三個類分別為:

com.zhy.android.percent.support.PercentLinearLayout
com.zhy.android.percent.support.PercentRelativeLayout
com.zhy.android.percent.support.PercentFrameLayout

對於eclipse的使用者:github上自行下載原始碼,就幾個類和一個attrs.xml,也可以在bintray.com/percent-support-extends 下載相關檔案。

下面看幾個具體的示例。


三 具體的示例

Demo 1

Android 增強版百分比佈局庫  為了適配而擴充套件

xml:

<?xml version="1.0" encoding="utf-8"?>


<com.zhy.android.percent.support.PercentFrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.zhy.android.percent.support.PercentFrameLayout
        android:layout_width="0dp"
        android:layout_height="0dp"
        android:layout_gravity="center"
        android:background="#ff44aacc"
        app:layout_heightPercent="50%w"
        app:layout_widthPercent="50%w">

        <com.zhy.android.percent.support.PercentFrameLayout
            android:layout_width="0dp"
            android:layout_height="0dp"
            android:layout_gravity="center"
            android:background="#ffcc5ec7"
            app:layout_heightPercent="50%w"
            app:layout_widthPercent="50%w">

            <TextView
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:layout_gravity="center"
                android:background="#ff7ecc16"
                android:gravity="center"
                android:text="margin 15% of w"
                app:layout_marginPercent="15%w"
                />

        </com.zhy.android.percent.support.PercentFrameLayout>

    </com.zhy.android.percent.support.PercentFrameLayout>

    <TextView android:layout_width="0dp"
              android:layout_height="0dp"
              android:layout_gravity="bottom|right"
              android:background="#44ff0000"
              android:gravity="center"
              android:text="15%w,15%w"
              app:layout_heightPercent="15%w"
              app:layout_marginPercent="5%w"
              app:layout_widthPercent="15%w"/>


</com.zhy.android.percent.support.PercentFrameLayout>

Demo 2

Android 增強版百分比佈局庫  為了適配而擴充套件

xml:

<?xml version="1.0" encoding="utf-8"?>
<com.zhy.android.percent.support.PercentRelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:clickable="true">

    <TextView
        android:id="@+id/row_one_item_one"
        android:layout_width="0dp"
        android:layout_height="0dp"
        android:layout_alignParentTop="true"
        android:background="#7700ff00"
        android:text="w:70%,h:20%"
        android:gravity="center"
        app:layout_heightPercent="20%"
        app:layout_widthPercent="70%"/>

    <TextView
        android:id="@+id/row_one_item_two"
        android:layout_width="0dp"
        android:layout_height="0dp"
        android:layout_toRightOf="@+id/row_one_item_one"
        android:background="#396190"
        android:text="w:30%,h:20%"
        app:layout_heightPercent="20%"
        android:gravity="center"
        app:layout_widthPercent="30%"/>


    <ImageView
        android:id="@+id/row_two_item_one"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:src="@drawable/tangyan"
        android:scaleType="centerCrop"
        android:layout_below="@+id/row_one_item_one"
        android:background="#d89695"
        app:layout_heightPercent="70%"/>

    <TextView
        android:layout_width="0dp"
        android:layout_height="0dp"
        android:layout_below="@id/row_two_item_one"
        android:background="#770000ff"
        android:gravity="center"
        android:text="width:100%,height:10%"
        app:layout_heightPercent="10%"
        app:layout_widthPercent="100%"/>


</com.zhy.android.percent.support.PercentRelativeLayout>

ok,例子都比較簡單,主要就一個佈局檔案,可以看出上述我們可以給寬度、高度,邊距等指定參考值為寬度或者高度。這樣的話,在保證圖片寬、高比例、控制元件設定為正方形等需求就沒問題了。


接下來還有個例子,功能主要是設定TextView對於textSize的百分比設定;以及對於ScrollView的支援。當然了,對於ScrollView的支援,這個理論上是不支援的,因為大家都清楚,如果PercentLinearLayout在ScrollView中,那麼高度的模式肯定是UNSPECIFIED,那麼理論上來說高度是無限制的,也就是依賴於子View的高度,而百分比佈局的高度是依賴於父View的高度的,所有是互斥的。而我們支援是:考慮到編寫程式碼的時候,大多參考的是螢幕高度(android.R.id.content)的高度,所以如果在ScrollView中,編寫10%h,這個百分比是依賴於螢幕高度的(不包括ActionBar的高度)。

Demo 3

Android 增強版百分比佈局庫  為了適配而擴充套件

xml:

<?xml version="1.0" encoding="utf-8"?>

<ScrollView
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <com.zhy.android.percent.support.PercentLinearLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical">

        <TextView
            android:layout_width="0dp"
            android:layout_height="0dp"
            android:background="#ff44aacc"
            android:gravity="center"
            android:text="width:60%,height:5%,ts:3%"
            android:textColor="#ffffff"
            app:layout_heightPercent="5%"
            app:layout_marginBottomPercent="5%"
            app:layout_textSizePercent="3%"
            app:layout_widthPercent="60%"/>

        <TextView
            android:layout_width="0dp"
            android:layout_height="0dp"
            android:background="#ff4400cc"
            android:gravity="center"
            android:text="width:70%,height:10%"
            android:textColor="#ffffff"
            app:layout_heightPercent="10%"
            app:layout_marginBottomPercent="5%"
            app:layout_widthPercent="70%"/>
        <TextView
            android:layout_width="0dp"
            android:layout_height="0dp"
            android:background="#ff44aacc"
            android:gravity="center"
            android:text="w:80%,h:15%,textSize:5%"
            android:textColor="#ffffff"
            app:layout_heightPercent="15%"
            app:layout_marginBottomPercent="5%"
            app:layout_textSizePercent="5%"
            app:layout_widthPercent="80%"/>
        <TextView
            android:layout_width="0dp"
            android:layout_height="0dp"
            android:background="#ff4400cc"
            android:gravity="center"
            android:text="width:90%,height:5%"
            android:textColor="#ffffff"
            app:layout_heightPercent="20%"
            app:layout_marginBottomPercent="5%"
            app:layout_widthPercent="90%"/>

        <TextView
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:background="#ff44aacc"
            android:gravity="center"
            android:text="width:100%,height:25%"
            android:textColor="#ffffff"
            app:layout_heightPercent="25%"
            app:layout_marginBottomPercent="5%"
            />

        <TextView
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:background="#ff44aacc"
            android:gravity="center"
            android:text="width:100%,height:30%"
            android:textColor="#ffffff"
            app:layout_heightPercent="30%"
            app:layout_marginBottomPercent="5%"
            />


    </com.zhy.android.percent.support.PercentLinearLayout>
</ScrollView>

上面的第三個TextView的字型設定的就是5%(預設參考容器高度)。整個PercentLinearLayout在ScrollView中。ok~ 姑且這樣,由於原始碼比較簡單,大家可以根據自己的實際需求去修改,前提儘可能不要改變原有的功能。


四 擴充套件的相關原始碼

(一) 關於attrs.xml

原庫中所有的屬性的format為fraction,但是由於我期望的寫法有10%w,10%h,10%,沒有找到合適的format,就直接定義為string了~string我可以自己去解析~

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="PercentLayout_Layout">
        <attr name="layout_widthPercent" format="string"/>
        <attr name="layout_heightPercent" format="string"/>
        <attr name="layout_marginPercent" format="string"/>
        <attr name="layout_marginLeftPercent" format="string"/>
        <attr name="layout_marginTopPercent" format="string"/>
        <attr name="layout_marginRightPercent" format="string"/>
        <attr name="layout_marginBottomPercent" format="string"/>
        <attr name="layout_marginStartPercent" format="string"/>
        <attr name="layout_marginEndPercent" format="string"/>
        <attr name="layout_textSizePercent" format="string"/>
    </declare-styleable>
</resources>

(二) 獲取自定義屬性的值及使用

如果看了上篇博文的話,應該清楚,對於自定義屬性的值是在PercentLayoutHelper.getPercentLayoutInfo(c, attrs)中獲取的。
簡單看下修改後的程式碼:


    public static PercentLayoutInfo getPercentLayoutInfo(Context context,                                                    AttributeSet attrs)
    {
        PercentLayoutInfo info = null;
        TypedArray array = context.obtainStyledAttributes(attrs, R.styleable.PercentLayout_Layout);

        String sizeStr = array.getString(R.styleable.PercentLayout_Layout_layout_widthPercent);
        PercentLayoutInfo.PercentVal percentVal = getPercentVal(sizeStr, true);
        if (percentVal != null)
        {
            if (Log.isLoggable(TAG, Log.VERBOSE))
            {
                Log.v(TAG, "percent width: " + percentVal.percent);
            }
            info = info != null ? info : new PercentLayoutInfo();
            info.widthPercent = percentVal;
        } 

        //省略了獲取其他的類似屬性
        array.recycle();
        return info;
    }


    private static final String REGEX_PERCENT = "^(([0-9]+)([.]([0-9]+))?|([.]([0-9]+))?)%([wh]?)$";

    /**
     * widthStr to PercentVal
     * <br/>
     * eg: 35%w => new PercentVal(35, true)
     *
     * @param percentStr
     * @param isOnWidth
     * @return
     */
    private static PercentLayoutInfo.PercentVal getPercentVal(String percentStr, boolean isOnWidth)
    {
        //valid param
        if (percentStr == null)
        {
            return null;
        }
        Pattern p = Pattern.compile(REGEX_PERCENT);
        Matcher matcher = p.matcher(percentStr);
        if (!matcher.matches())
        {
            throw new RuntimeException("the value of layout_xxxPercent invalid! ==>" + percentStr);
        }
        int len = percentStr.length();
        //extract the float value
        String floatVal = matcher.group(1);
        String lastAlpha = percentStr.substring(len - 1);

        float percent = Float.parseFloat(floatVal) / 100f;
        boolean isBasedWidth = (isOnWidth && !lastAlpha.equals("h")) || lastAlpha.equals("w");

        return new PercentLayoutInfo.PercentVal(percent, isBasedWidth);
    }

首先我們獲取自定義屬性的填寫的值,通過getPercentVal方法,在該方法內部通過正則校驗其合法性,如果合法,則將其拆解封裝成PercentVal物件,該物件中記錄百分比值,已經知否參考寬度的布林值(如果參考寬度則為true,否則為false)。對於沒有字尾w|h的,和原庫的解析方式相同。

PercentVal物件如下:

public static class PercentVal
{

     public float percent = -1;
     public boolean isBaseWidth;

     public PercentVal(float percent, boolean isBaseWidth)
     {
          this.percent = percent;
          this.isBaseWidth = isBaseWidth;
     }
}       

對於定義的自定義屬性獲取完成之後,剩下的無非是測量時候對於原本的LayoutParams中的寬度和高度的賦值做簡單的修改。參考上一篇的原始碼,我們直接看 PercentLayoutInfo.fillLayoutParams(params, widthHint, heightHint);方法:


 public void fillLayoutParams(ViewGroup.LayoutParams params, int widthHint,
                                     int heightHint)
        {
            // Preserve the original layout params, so we can restore them after the measure step.
            mPreservedParams.width = params.width;
            mPreservedParams.height = params.height;
            /*
            if (widthPercent >= 0) {
                params.width = (int) (widthHint * widthPercent);
            }
            if (heightPercent >= 0) {
                params.height = (int) (heightHint * heightPercent);
            }*/
            if (widthPercent != null)
            {
                int base = widthPercent.isBaseWidth ? widthHint : heightHint;
                params.width = (int) (base * widthPercent.percent);
            }
            if (heightPercent != null)
            {
                int base = heightPercent.isBaseWidth ? widthHint : heightHint;
                params.height = (int) (base * heightPercent.percent);
            }

            if (Log.isLoggable(TAG, Log.DEBUG))
            {
                Log.d(TAG, "after fillLayoutParams: (" + params.width + ", " + params.height + ")");
            }
        }

原本的原始碼比較簡單,只需要將widthHint/heightHint乘以百分比即可(見上程式碼註釋),而我們修改的也比較容易,首先判斷參考寬度還是高度,然後乘以百分比(根據我們的物件PercentVal的屬性)。

ok,大概的原始碼修改就是上述的內容,有興趣的可以直接檢視原始碼。

當然了,上述庫中肯定還存在或多或少的問題,大家可以fork完善下,或者直接留言提意見都可以。


github地址:android-percent-support-extend ,用法參考上文,或者README。歡迎star and fork 。

~~have a nice day ~~

ok~

群號:463081660,歡迎入群

新浪微博

微信公眾號:hongyangAndroid
(歡迎關注,第一時間推送博文資訊)
Android 增強版百分比佈局庫  為了適配而擴充套件

相關文章