SwitchViewProject

KO | EN

gitlite — search

#javascript #python #typescript #llm #go #android #machine-learning #java #awesome #cli #awesome-list #openai #ios #open-source

SwitchViewProject

(★ 11)

可高度自定义的switchview-具体用法见readme

SwitchViewProject Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SwitchViewProject
## 对应的文章
[关于SwitchView简单解读的文章](http://blog.csdn.net/qiang_xi/article/details/74942386)
### 效果图：
##### 默认效果
![默认效果](https://github.com/qiangxi/SwitchViewProject/blob/master/image/%E9%BB%98%E8%AE%A4.gif?raw=true)
##### 自定义文本及字体颜色、大小
![效果1](https://github.com/qiangxi/SwitchViewProject/blob/master/image/%E6%95%88%E6%9E%9C3.png?raw=true)
##### 自定义插值器，锁定位置（锁定位置为2），滑动时不展示文本 
![效果2](https://github.com/qiangxi/SwitchViewProject/blob/master/image/%E6%95%88%E6%9E%9C2.gif?raw=true)

### 更新日志
#### 2017-07-11 
发布第一个稳定版本V1.0.0。
 
### 集成方式
#### gradle：
```grooxy
compile 'com.qiangxi.switchview:switchview:1.0.0'
```
#### maven：
```maven
<dependency>
  <groupId>com.qiangxi.switchview</groupId>
  <artifactId>switchview</artifactId>
  <version>1.0.0</version>
  <type>pom</type>
</dependency>
```
### API说明
API | API调用时机 | 对应的xml属性|作用
---|---|---|---
setOnItemSelectedListener(OnItemSelectedListener listener) | view初始化后的任意时刻|无|设置item选中监听，当item被选中时触发回调
setScrollEnable(boolean scrollEnable)|view初始化后的任意时刻|app:scrollEnable="boolean"|设置是否禁用滑动手势【true:不禁用；false：禁用；默认为true】
smoothScrollTo(int position)|需要动态滑动时调用|无|平滑移动到指定位置【注意与setDefaultSelectedPosition(int position)方法区分开来。】
setShowTextWhenScrolling(boolean isShowText)|view初始化后的任意时刻|app:showTextWhenScrolling="boolean"|滑块在滑动时是否在滑块上显示文本【true：显示；false：不显示；默认为true】
setInterpolator(TimeInterpolator interpolator)|view初始化后的任意时刻|无|设置滑动插值器
setLockPosition(int position)|view初始化后的任意时刻|app:lockedPosition="interger"|指定锁定位置【位置被锁定后，该位置不可点击，且滑块滑动到该位置松开后，会自动滑动到原位置；只能指定一个位置为锁定位置】
unlockPosition()|view初始化后的任意时刻|无|解锁被锁定的位置【解锁后，所有位置都自由了】
getLockPosition()|view初始化后的任意时刻|无|获取被锁定的位置【未设置锁定位置时返回-1】
getTotalItemCount()|view初始化后的任意时刻|无|获取item总数量
setNormalTextColor(int normalTextColor)|view初始化后的任意时刻|app:normalTextColor="color"|设置默认文本颜色【未设置则使用默认】
setNormalTextSize(float normalTextSize)|view初始化后的任意时刻|app:normalTextSize="dimension"|设置默认文本字体大小【未设置则使用默认】
setSelectedTextColor(int selectedTextColor)|view初始化后的任意时刻|app:selectedTextColor="color"|设置选中文本颜色【未设置则使用默认】
setSelectedTextSize(float selectedTextSize)|view初始化后的任意时刻|app:selectedTextSize="dimension"|设置选中文本字体大小【未设置则使用默认】
setSelectedDrawableResId(@DrawableRes int selectedDrawableResId)|view初始化后的任意时刻|app:selectedDrawableResId="integer"|设置选中的item的背景drawable【未设置则使用默认】
setSelectedBgMarginArray(int[] selectedBgMarginArray) |view初始化时调用|无|设置滑块距离四周的margin值【整型数组,位置对应关系：[left,top,right,bottom]，数组长度必须为4】
setDefaultSelectedPosition(int position)|view初始化时调用|app:defaultSelectedPosition="integer"|设置滑块初始位置【未设置则使用默认值，即0位置】
setTextArray(String[] textArray)|view初始化时调用|app:textArray="reference"|设置文本内容【使用xml属性时，按照如下方式使用：app:textArray="@array/customTextArray"】
getSlideView()|view初始化后的任意时刻|无|获取滑块view【目前是TextView，将来可能会继承TextView自定义一个SlideView】
setEnable(boolean enable)|view初始化后的任意时刻|无|是否禁用所有手势【true:不禁用；false:禁用；禁用之后，不在响应任何手势，包括点击和滑动】
isEnable()|view初始化后的任意时刻|无|是否已经禁用所有手势
 
### 基本使用方式
```java
public class MainActivity extends AppCompatActivity {
    private String[] textArray = {"文本一", "文本二", "文本三", "文本四", "文本五"};
    private SwitchView mSwitchView;

private int[] marginArray = {20, 20, 20, 20};
    private boolean isRequestSuccess;

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mSwitchView = (SwitchView) findViewById(switchView);
//        mSwitchView.setTextArray(textArray);
//        mSwitchView.setNormalTextColor(Color.GREEN);
//        mSwitchView.setNormalTextSize(15);
//        mSwitchView.setSelectedDrawableResId(R.mipmap.ic_launcher);
//        mSwitchView.setSelectedTextColor(Color.BLUE);
//        mSwitchView.setSelectedTextSize(18);

//        mSwitchView.setLockPosition(2);
//        mSwitchView.setSelectedBgMarginArray(marginArray);
//        mSwitchView.setDefaultSelectedPosition(0);
//        mSwitchView.setInterpolator(new OvershootInterpolator());
//        mSwitchView.setShowTextWhenScrolling(false);
        mSwitchView.setOnItemSelectedListener(new OnItemSelectedListener() {
            @Override
            public void onItemSelected(int currentSelectedPosition, final int lastSelectedPosition) {
                //模拟网络请求
                new Handler().postDelayed(new TimerTask() {
                    @Override
                    public void run() {
                        if (isRequestSuccess) {
                            //若请求成功，do nothing
                        } else {
                            //若请求失败，调用如下方法移动到上一个位置
                            mSwitchView.smoothScrollTo(lastSelectedPosition);
                        }
                    }
                }, 2000);
//                Toast.makeText(MainActivity.this, "currentSelectedPosition=" + currentSelectedPosition + "，lastSelectedPosition=" + lastSelectedPosition, Toast.LENGTH_SHORT).show();
            }
        });
    }

public void click(View view) {

//        mSwitchView.setScrollEnable(false);
//        mSwitchView.setNormalTextColor(Color.GREEN);
//        mSwitchView.setNormalTextSize(25);
//        mSwitchView.setSelectedDrawableResId(R.mipmap.ic_launcher);
//        mSwitchView.setSelectedTextColor(Color.BLUE);
//        mSwitchView.setSelectedTextSize(50);

//        mSwitchView.unlockPosition();//有效

}
}
```
### 最后
如果该项目对你有帮助，还请不吝赏赐star或fork。也欢迎提出issue或pr，一起维护这个项目。

SwitchViewProject

SwitchViewProject Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

SwitchViewProject

SwitchViewProject Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README