開發一款商業級Banner控件

本文已授權微信公眾號:鴻洋(hongyangAndroid)原創首發。

商業級控件最重要的特性:高內聚、低耦合!

1、分析需求

我們想要實現什么功能、達到什么效果?
站在用戶在這里就是我們的程序員的角度上來看,我們在使用的時候是希望以最少的代碼實現更多的功能,且能有足夠地自由去自定義該功能。功能需求如下:

用戶需求用例圖

我們想要實現的效果 :


2、理清技術點

在開發之前,大致評估一下技術可行性,結合技術點的特性才能更好的去劃分層次和搭建框架,首先梳理幾個功能點 以及它們相對應的技術點;

  1. ViewPeger作為view的載體(為什么不用recyclerView,懶,使用recyclerVIew會多出很多代碼,比如自己寫滑動監聽,換頁換頁監聽,換頁動畫等等比較麻煩的代碼,以及各種計算)
  2. 如何無限循環,如圖所示; 首尾各增加一項item; 且當滑動至 第0項 時無縫切換至 倒數第二項(真實數據最后一項下標),當滑動到最后一項時無縫切換至第二項(真實數據第一項);
   2.0.0 版本采用的思路是:
        getCount()  6百倍實際長度;
        將開始下標置為300倍;  做一個假的無限循環;
        在下標不在 200~400倍時; 重新定位在300倍位置;
  1. 翻頁動畫,有一個ViewPager有個接口PageTransformer;賊好用,在滑動過程中 會計算各個itemVIew的左坐標與滑動距離差 與 總寬度的比例;
    protected void onPageScrolled(int position, float offset, int offsetPixels) {
        ...    
           if (mPageTransformer != null) {
            final int scrollX = getScrollX();
            final int childCount = getChildCount();
            for (int i = 0; i < childCount; i++) {
                final View child = getChildAt(i);
               ....
                final float transformPos = (float) (child.getLeft() - scrollX) / getClientWidth();
                mPageTransformer.transformPage(child, transformPos);
            }
        ...
  1. 默認指示器,一個自定義View, 動態添加指示點。根據狀態切換指示點圖標。
  2. 如何一頁顯示多屏(如下效果),其中用到了 clipChildren屬性
    ,在ViewGroup中該屬性是這樣注釋的
    // When set, ViewGroup invalidates only the child's rectangle
    // Set by default
    static final int FLAG_CLIP_CHILDREN = 0x1;
    /**
     * By default, children are clipped to their bounds before drawing. This
     * allows view groups to override this behavior for animations, etc.
     *
     * @param clipChildren true to clip children to their bounds,
     *        false otherwise
     * @attr ref android.R.styleable#ViewGroup_clipChildren
     */
    public void setClipChildren(boolean clipChildren) {
    ...

通過設置根布局 android:clipChildren="false" 這樣我們就能實現一屏顯示多view的效果了。

多屏

3、面向對象設計

我們需要根據業務的細分對象,每個對象要實現什么功能;各個對象之間如何關聯起來貫穿整個業務流程; 設計框架與高層抽象;

3.1、 細分對象

我們都知道面向對象設計思想呢 有一種原則叫 單一職責原則! 所以我們第一步就是劃分這個對象。每個對象該做什么事情。 且遵循單一職責原則的優點在于:我的任一單一的對象都可以拿出來單獨使用,這樣就能極大程度保證我們的代碼的可擴展性。

ok,那我們一個一個來分析:

  1. wenldBanner
    也是我們最外層一個對象,它包含了viewPager 對象與我們的指示器對象;負責協調我們VIewPager與指示器之間的關聯關系與位置擺放,同時能夠對各個對象的屬性進行相對應的設置。
  2. AutoTurnViewPager :
    負責自動翻頁相關功能;
  3. LoopViewPager
    負責自動翻頁設置; 重寫滑動監聽事件(addOnPageChangeListener,removeOnPageChangeListener);重寫真實選中事件(setCurrentItem,getCurrentItem)等等;
  4. WenldPagerAdapter :
    展示真實的View;提供適配器下標與真實數據下標相互轉換算法; 并實現對View的復用;
  5. Holder:
    適配器View,Holder
  6. DefaultPageIndicator
    默認指示器
  7. PageIndicatorListener
    指示器監聽接口。

3.2 簡單UML

大概事件有這么多,如下圖:


根據以上搭建類圖:

4 拆分代碼編程

根據uml流程用例圖以及類圖 搭建好框架后 定義出接口并寫出偽代碼;依次實現細節代碼。
具體可以進入源碼 WenldBanner查看。

5 總結

5.1 遇到的坑

5.1.1、 notifyDataSetChanged "不刷新問題"

這個坑還算是比較輕松就能填充的: 首先是數據源改變后 調用notifyDataSetChanged 界面不刷新
例如:數據從{"一","二","三" }變為{"四","五","六" } 時的效果展現失敗,如下圖所示

數據變換前

數據變換后

slove:

1、進入notifyDataSetChanged 源碼查看 ,通過幾步找到了ViewPager的 dataSetChanged() 方法

   void dataSetChanged() {
        ...
        for (int i = 0; i < mItems.size(); i++) {
            final ItemInfo ii = mItems.get(i);
          //調用adapter的 getItemPosition方法  ,然而 該方法返回值 一直為:POSITION_UNCHANGED
            final int newPos = mAdapter.getItemPosition(ii.object);

            if (newPos == PagerAdapter.POSITION_UNCHANGED) {
                continue;
            }
          //如果返回的是 PagerAdapter.POSITION_NONE 那么移除所有view 重新填充
            if (newPos == PagerAdapter.POSITION_NONE) {
            //移除
                mItems.remove(i);
                ...
          //移除
                mAdapter.destroyItem(this, ii.position, ii.object);
          ...
           //在該方法內  如果 mItems 為空 該方法內最終會調用 到 adapter.instantiateItem 方法 填充新的view
            setCurrentItemInternal(newCurrItem, false, true);
            requestLayout();
        }
    }

可以看到 如果 mAdapter.getItemPosition()方法 返回的是 PagerAdapter.POSITION_NONE,那么我們就會將舊items清除掉;經過方法判斷items為空, 最終會重新填充新的view;

2、所以我們就可以在 adapter的 getItemPosition方法內下手:
在調用notifyDataSetChanged時保證 getItemPosition返回的是POSITION_NONE

WenldPagerAdapter.class 

    @Override
    public void notifyDataSetChanged() {
        myNotify=true;
        super.notifyDataSetChanged();
        myNotify=false;
    }

    @Override
    public int getItemPosition(Object object) {
        if (!myNotify) {
            return super.getItemPosition(object);
        } else {
            return POSITION_NONE;
        }
    }

5.1.2、 設置切換動畫后 notifyDataSetChanged 錯亂

1、這個坑算是比較大的:如果我們設置了切換動畫,調用notifyDataSetChanged 以后效果會錯亂, 如下圖所示


2、還是進入源碼來分析解決問題,不過分析比較多,請查看ViewPager源碼解析PageAdapter刷新問題

5.2 收獲

一款商業級Banner控件

既然敢說商業級,那么就支持足夠的自定義與擴展性! 實現思路請看這 開發一款商業級Banner控件

效果圖:


可以做到以下效果

  • 設置自定義指示器效果
  • 設置指示器位置
  • 設置是否循環
  • 是否可以跳轉
  • 頁面切換間隔
  • 頁面切換持續時間
  • 是否支持手動滑動
  • 是否反向切換頁面(切換方向)

use

1、引用:

版本號:[圖片上傳失敗...(image-e7ddb3-1511330475991)]

// root build.gradle
repositories {
    jcenter()
    maven { url "https://www.jitpack.io" }
}
// yout project build.gradle
dependencies {
        compile 'com.github.LidongWen:WenldBanner:2.0.0'
}

具體查看代碼:Github地址


希望我的文章不會誤導在觀看的你,如果有異議的地方歡迎討論和指正。
如果能給觀看的你帶來收獲,那就是最好不過了。

人生得意須盡歡, 桃花塢里桃花庵
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,527評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,687評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,640評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,957評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,682評論 6 413
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,011評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,009評論 3 449
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,183評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,714評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,435評論 3 359
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,665評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,148評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,838評論 3 350
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,251評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,588評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,379評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,627評論 2 380

推薦閱讀更多精彩內容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,765評論 25 708
  • 內容抽屜菜單ListViewWebViewSwitchButton按鈕點贊按鈕進度條TabLayout圖標下拉刷新...
    皇小弟閱讀 46,868評論 22 665
  • (一) 不知不覺中秋季已經悄然到來,正如她曾經悄然的走時一樣。行走在飄滿落葉的行道上,行走在略顯涼意的秋風中,總會...
    寒揚閱讀 418評論 0 37