Skip to content

Latest commit

 

History

History
134 lines (106 loc) · 4.42 KB

README.md

File metadata and controls

134 lines (106 loc) · 4.42 KB

IntensifyGridView

预览

功能如下：

  • 省略布局（如QQ空间图片大于9张时最后一张的图片显示样式特殊），形式类型TextView的省略样式，可以指定省略位置(前，后，无)
  • 额外布局（如设置最大长度为9，额外布局为1，那么在长度小于等于9时会出现额外布局，大于等于9时额外布局消失）
  • 自动布局（根据设置的Block的尺寸进行自动布局，类似于GridView的auto_fit）
  • 设置间隙的宽度，以及多余间隙的位置(前留白，后留白，均分)
  • 设置间隙的drawable
  • 最大行数，或者最大长度
  • 指定Block的形状(长方形和正方形)

Demo

安装 apk 文件预览效果，或者通过下面二维码去下载安装：

Demo 二维码

Usage

Use Gradle:

compile 'me.kareluo.intensify:gridview:1.0.0'

Or Maven:

<dependency>
  <groupId>me.kareluo.intensify</groupId>
  <artifactId>gridview</artifactId>
  <version>1.0.0</version>
  <type>pom</type>
</dependency>

Sample

当autoFit为true时spanCount便会无效，这时spanCount是由blockWidth决定的，当autoFit为false时，需要设置spanCount来确定列数。布局文件中的使用格式如下，除divider和orientation使用android命名空间外，其他一些属性都使用自定义命名空间，如下：

<me.kareluo.intensify.gridview.IntensifyGridView
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:divider="[color|drawable]"
    app:autoFit="[boolean]"
    app:blockSize="[match_parent|wrap_content|dimension]"
    app:blockWidth="[match_parent|wrap_content|dimension]"
    app:blockHeight="[match_parent|wrap_content|dimension]"
    app:blockType="[square|rectangle]"
    app:ellipsize="[none|start|end]"
    app:horizontalSpacing="[dimension["
    app:verticalSpacing="[dimension]"
    app:maxLines="[integer]"
    app:maxLength="[integer]"
    app:spacingGravity="[share|start|end]"
    app:spanCount="[integer]"
    app:extraCount="[single|integer]"
    app:spacer="[color|drawable]"/>

Adapter使用继承自IntensifyGridAdapter，其增加了省略布局和额外布局的一些方法。需要注意一点，当设置了maxLength或者maxLines后不要使用mAdapter.notifyItemInserted(int position)来刷新数据，代码如下：

// Adapter 继承 IntensifyGridAdapter
private class TestAdapter extends IntensifyGridAdapter<DemoViewHolder> {

   public TestAdapter(@NonNull IntensifyGridView intensifyGridView) {
       super(intensifyGridView);
   }
   
   @Override
   protected void onBindCommonViewHolder(DemoViewHolder holder, int position) {
   	 // 绑定普通View
       holder.update(mResIds[position]);
   }
   
   @Override
   protected void onBindEllipsizeViewHolder(DemoViewHolder holder, int position) {
       // 绑定省略布局View
       holder.update(position, getEllipsizeCount());
   }
   
   @Override
   protected void onBindExtraViewHolder(DemoViewHolder holder, int position) {
       // 绑定额外布局View
       super.onBindExtraViewHolder(holder, position);
   }
	 
   @Override
   public DemoViewHolder onCreateCommonViewHolder(ViewGroup parent, int type) {
       // 创建普通Holder
       return new DemoViewHolder(new ImageItemView(getBaseContext()));
   }
   
   @Override
   public DemoViewHolder onCreateEllipsizeViewHolder(ViewGroup parent) {
       // 创建省略布局Holder
       return new DemoViewHolder(new ImageItemView(getBaseContext()));
   }
   
   @Override
   public DemoViewHolder onCreateExtraViewHolder(ViewGroup parent) {
       // 创建额外布局Holder
       return new DemoViewHolder(new ImageItemView(getBaseContext()));
   }

   @Override
   public int getCount() {
       return mResIds.length;
   }
}

License

Copyright 2015 kareluo.

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.