# xwidget

**Repository Path**: pichs/xwidget

## Basic Information

- **Project Name**: xwidget
- **Description**: 非常好用基础组件库。致力于解决基础控件快速开发问题，致力于快速开发基础控件，省去大量写xml文件的时间。
- **Primary Language**: Android
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/pichs/xwidget
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2021-03-18
- **Last Updated**: 2025-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: android基础View库, 最强基础控件, 圆角, 渐变, 非常快乐

## README

# 专业的Android基础组件库

**用心创造快乐！**

### 为何要做基础组件库！

- 还在为写布局太慢而困扰？还在为写的圆角而心烦？还在为各种渐变头疼？
- 当你用了这个库，**直接起飞**
- 圆角，阴影，按压效果，渐变色，属性一键实现，更有丰富属性和组件。
- 致力于快速开发基础控件，省去大量写xml文件的时间。效果实时可预览。
- Android开发最大的痛点，就是什么支持，但是又刚好不到位。难不难受。


### 引入控件

### 最新版本:[![](https://img.shields.io/maven-central/v/com.gitee.pichs/xwidget)](https://img.shields.io/maven-central/v/com.gitee.pichs/xwidget)

      implementation 'com.gitee.pichs:xwidget:5.7.0'

<br/>


---

### 详细使用文档：每个组件具体使用样例请点击这里：[详细文档.md](%E8%AF%A6%E7%BB%86%E6%96%87%E6%A1%A3.md)

---

<br/>

## 二、先看效果（最新版本）

- 首页底部导航时XLinearRadioGroup+XRadioCardLinearLayout+XRadioImageView+XRadioCardButton实现。
- <img src='imgs/home.jpg' width='300px'>

<br/>

- 按钮，渐变，方向，边框，圆角，阴影，按压效果，checked效果，activated效果。
- <img src='imgs/button.jpg' width='300px'>

<br/>

- 单选组，XCardLinearRadioGroup+XRadioCardLinearLayout+XRadioCardButton实现。
- <img src='imgs/radio_group.jpg' width='300px'>

<br/>

- 文字，字体自定义-热切换
- <img src='imgs/text_font.jpg' width='300px'>

<br/>

- 卡片，阴影，圆角。
- <img src='imgs/xcard.jpg' width='300px'>

<br/>

- 占位控件 XSpace, XStatusBarSpace, XStatusBarView
- <img src='imgs/xspace.jpg' width='300px'>

<br/>

## 非常好用基础组件库，超简单，快速。

- 特色杜绝属性冲突，系统属性尽量复用，属性前缀 ‘xp_’ ,简短快速。

- 圆角，外阴影，圆头跟随高度宽度，渐变色背景->双色渐变：top->bottom，left->right,TL->BR, BL->TR

- 按压效果，仍然支持渐变，圆角等。 支持按压透明变化，disabled透明变化。

- checked效果，activated效果，支持属性状态预览。

- 致力于快速开发基础控件，省去大量写xml文件的时间。效果实时可预览。

- 更多功能可查看demo，或者体验Apk

## Demo.apk下载体验

[下载体验](https://github.com/pichsy/xwidget/tree/github-xwidget/app/release/app-release.apk)

## 持续维护，已持续更新四年。持续增强更有用的功能，简单，稳定，强大。

- 用起来不爽，多提点bug，尽力满足你的需求。

### 使用示例去 demo中的xml中探索吧。

- [下载体验](https://github.com/pichsy/xwidget/tree/github-xwidget/app/release/app-release.apk)

### 注意：凡是继承自xwidget的基础类的textview都可以实现字体变更

1. 在Application中初始化

   ```
     // 初始化，自动缓存。
     public class App extends Application {
         @Override
         public void onCreate() {
             super.onCreate();
             XTypefaceHelper.init(this, true);
         }
     }
   
     XCardButton btn = findViewById(R.id.btn1);
     btn.setOnClickListener(v -> {
         XTypefaceHelper.setGlobalTypefaceFromAssets(getApplicationContext(), "leihong.ttf");
         XTypefaceHelper.setGlobalTypefaceStyle(getApplicationContext(), XTypefaceHelper.NONE);
     });
     XButton normalBtn = findViewById(R.id.normalBtn);
     normalBtn.setOnClickListener(v -> XTypefaceHelper.resetTypeface(MainActivity.this));
     XButton closeFont = findViewById(R.id.closeFont);
     XButton openFont = findViewById(R.id.openFont);
   
     closeFont.setOnClickListener(v -> XTypefaceHelper.closeTypeface(this));
     openFont.setOnClickListener(v -> XTypefaceHelper.openTypeface(this));
   
   ```

### 其他功能介绍，未完待续......

## 属性说明

**记住一个原则，系统有的属性，先去尝试用。找不到或无效，再使用 `xp_` 代码提示。**

- 大部分属性都会复用系统原有属性，并且作为控件的默认属性。
- android:background="#fff"
- android:color="#333"

<br/>
<br/>
## 代码混淆

    版本混淆规则
    -keep class com.pichs.xwidget.**{ *; }

<br/>
<br/>


---

### 一、 ∆!∆ 老版本升级指南 (点击下面链接)

- [老版本升级指南.md](./老版本升级指南.md)

---


## 升级日志
### 5.7.0
- 增加属性xp_backgroundStartColor, xp_backgroundEndColor, xp_backgroundOrientation,属性，可代替 xp_backgroundGradientStartColor, xp_backgroundGradientEndColor, xp_backgroundGradientOrientation属性，功能完全一致，建议使用新的属性。

### 5.6.3
- 优化XNavigationBarUtils 获取导航栏高度方法。

### 5.6.2
- 修改XDisplayHelper获取导航栏高度方法。（横条，和 三键）
- 增加XNavigationBarUtils 适配导航条。

### 5.6.1
 - XStatusBarHelper 适配 最新的Android版本。方便 沉浸式状态栏设置方法。设置状态栏字体 黑/白

### 5.6.0

- 优化 XRound系列设置 setRadius(10), setRadius(10,0,0,10). 两参和四参的 设置方式，谁最后设置谁生效。更符合动态设置代码习惯。
- 属性设置 xp_radius, 和 xp_radiusTopLeft... 四个角的设置方式，xp_radiusTopLeft四个角的属性设置 优先级高于 xp_radius。不建议混用。

### 5.5.0
- 修复一些不常用组件的bug，不一一列举了。


### 5.4.1

- 优化一些属性设置问题
- 去除log日志

### 5.3.0

- 修改XRoundImageView为XRound系列效果，原来原角ImageView建议使用XCardImageView

### 5.2.0

- 增加XOvalImageView 椭圆形图片控件
- 修改XRoundImageView 为圆形图片控件，四个角可任意设置大小。去除XRoundImageView的oval属性，拆分为单独的XOvalImageView控件

### 5.1.0

- 增加XRoundEditText 用法和XRound...系列相同
- 增加XCardEditText 用法和XCard...系列相同
- 修复XEditText background属性不设置 其他背景失效问题
- 修复XEditText 全系新增 游标样式设置 `xp_textCursorColor, xp_textCursorWidth, xp_textCursorRadius` 可以在xml中设置，已兼容低版本。
  <br/>

     ```xml
          <com.pichs.xwidget.view.XEditText
                    ....
                    app:xp_disableCopyAndPaste="true"
                    app:xp_textCursorColor="#F00"
                    app:xp_textCursorRadius="3dp"
                    app:xp_textCursorWidth="5dp" />    
      ```

### 5.0.0

- XView系列全系增加android:checked属性，和 xp_activated属性
- 属性新增 xp_activated, 可属性设置activatedXXX系列属性 默认状态。xml中可实时预览。
- 新增字体 可设置font目录中的全局字体，并保存，下次可生效。
- shine系列控件新增属性：xp_shine_flashing_colors 可自定义闪动的颜色数组，颜色值逗号分割。
- 修改XImageView系列继承自ImageView，而不是AppCompatImageView，修复XImageView的动态创建属性失效的问题。
- 优化XRadioGroup系列，更多实用方式。
- 新增XPressScaleFrameLayout,且新增XPressScaleLinearLayout,XPressScaleConstraintLayout
- 完善demo，体验更好，更好的借鉴api，demo中直接展示代码。
- XView系列，全系实现Checkable接口，xp_checke...系列属性全部生效
- 增加 X...RadioGroup系列,可作为单选组容器
- 增加 XRadio....系列，可作为单选组子控件
- 修改 XCheckBox的监听回调中的参数，第一个参数改为顶层View。
- 增加XRadio...子控件系列 属性 xp_ignore_radio_group ,添加此属性可以忽略父控件的单选组效果，即不参与单选组的单选效果。

- 使用手册：

1. X...RadioGroup系列 都是继承自'父View'控件属性方式完全一致，只是增加了单选组效果，其他属性完全一致。
2. XRadio...系列 都是继承自原'子View'控件属性方式完全一致，只是增加了单选组效果，其他属性完全一致。
3. XRadio...系列 可以单独使用，效果和继承的控件一致且效果一样
4. X...RadioGroup系列 可以单独使用，效果和继承的控件一致且效果一样
5. 只有X...RadioGroup系列 和 XRadio...系列 配合使用才能实现单选效果。
    - 使用示例：

    ```xml
              <com.pichs.xwidget.radiogroup.XCardLinearRadioGroup
                  android:layout_width="300dp"
                  android:layout_height="wrap_content"
                  android:background="#fff"
                  android:orientation="vertical"
                  android:padding="12dp"
                  app:xp_radius="30dp"
                  app:xp_shadowAlpha="1"
                  app:xp_shadowColor="#000"
                  app:xp_shadowElevation="5dp">
   
   
                  <com.pichs.xwidget.radiobutton.XRadioCardButton
                      android:layout_width="wrap_content"
                      android:layout_height="wrap_content"
                      android:background="#CBCBD3"
                      android:padding="12dp"
                      android:shadowColor="#3838EF"
                      android:text="XRadioCardButton"
                      android:textColor="#333"
                      android:textSize="15sp"
                      app:xp_checkedBackground="#563CF3"
                      app:xp_checkedTextColor="#fff"
                      app:xp_isRadiusAdjustBounds="true"
                      app:xp_shadowElevation="3dp" />
   
                  <com.pichs.xwidget.radiobutton.XRadioImageView
                      android:layout_width="40dp"
                      android:layout_height="40dp"
                      android:layout_marginTop="12dp"
                      android:src="@drawable/ic_agree_unckecked"
                      app:xp_checked_src="@drawable/ic_agree_checked" />
   
                  <com.pichs.xwidget.radiobutton.XRadioCardLinearLayout
                      android:layout_width="200dp"
                      android:layout_height="40dp"
                      android:background="#DADAEC"
                      android:gravity="center"
                      app:xp_checkedBackground="#BE0FD1"
                      app:xp_radius="20dp">
   
                      <androidx.appcompat.widget.AppCompatTextView
                          android:layout_width="wrap_content"
                          android:layout_height="wrap_content"
                          android:layout_gravity="center"
                          android:text="XRadioCardLinearLayout" />
   
                  </com.pichs.xwidget.radiobutton.XRadioCardLinearLayout>
              </com.pichs.xwidget.radiogroup.XCardLinearRadioGroup>
   
      ```

- 示例效果
- ![](./imgs/radio.gif)

## 更新计划

- 已全部完成

1. ~~优化 cube属性，使其更加全能，增加更多立体按钮效果，包括凹陷按钮效果~~ 💯✔️
2. ~~增加 X...RadioGroup, 直属子类可用XRadio...子控件，并且其他布局随意添加不参加单选，只做辅助显示。~~  💯✔️