# BaseUI

**Repository Path**: mrfu/base-ui

## Basic Information

- **Project Name**: BaseUI
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-08
- **Last Updated**: 2026-02-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BaseUI

一个用于Android项目的UI组件库，包含常用的LoadingDialog和HintView组件，支持跨项目复用。

## 功能特性

### 1. LoadingDialog 加载对话框
- 可配置的加载提示对话框
- 支持自定义提示文本、进度条颜色等属性
- 单例模式管理，避免内存泄漏
- 线程安全，所有UI操作均在主线程执行

### 2. HintView 提示控件
- 轻量级提示控件，继承自View
- 黑灰色背景(#333333)、白色文字、16sp字体大小
- 圆角背景和中心缩放动画效果
- 非阻塞式消息提示，类似Toast但更灵活

## 使用方法

### 在项目中引入

```kotlin
// 在settings.gradle.kts中添加
include(":baseui")

// 在需要使用的模块的build.gradle.kts中添加依赖
implementation(project(":baseui"))
```

### LoadingDialog 使用示例

```kotlin
// 基本使用
context.showLoadingDialog("正在加载...")

// 高级配置
context.showLoadingDialog {
    setMessage("处理中...")
    setCancelable(true)
    setCancelOnTouchOutside(false)
    setProgressColor(ContextCompat.getColor(context, R.color.custom_color))
}

// 更新消息
context.updateLoadingMessage("请稍候...")

// 隐藏对话框
context.dismissLoadingDialog()
```

### HintView 使用示例

```kotlin
// 基本使用
context.showHintMessage("操作成功")

// 自定义时长
context.showHintMessage("提示信息", 3000L)

// 隐藏当前提示
context.dismissHintMessage()
```

## 自定义配置

### 颜色配置
可以通过覆盖资源文件来自定义颜色：

```xml
<!-- colors.xml -->
<color name="loading_progress_color">#FF6200EE</color>
<color name="hint_background">#333333</color>
<color name="hint_text_color">#FFFFFF</color>
```

### 尺寸配置
```xml
<!-- dimens.xml -->
<dimen name="hint_text_size">16sp</dimen>
<dimen name="hint_corner_radius">8dp</dimen>
<dimen name="hint_padding_horizontal">24dp</dimen>
<dimen name="hint_padding_vertical">12dp</dimen>
<dimen name="hint_elevation">4dp</dimen>
```

## 技术特点

- **纯Kotlin实现**：遵循现代Android开发规范
- **线程安全**：所有UI操作自动切换到主线程
- **内存优化**：单例模式管理，避免重复创建
- **高度可配置**：支持丰富的自定义选项
- **易于集成**：通过扩展函数提供便捷API

## 依赖说明

```kotlin
implementation(libs.core.ktx)
implementation(libs.appcompat)
implementation(libs.material)
```

## 许可证

MIT License