# RandomColor

**Repository Path**: miosas/random-color

## Basic Information

- **Project Name**: RandomColor
- **Description**: 一个生成随机颜色的开源项目，适用于UI设计、前端开发和创意编程，提供多种颜色模型和便捷的API接口。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RandomColor Library

一个基于HarmonyOS的随机颜色生成库，提供简单易用的API来生成各种格式的随机颜色。

## 功能特性

- 支持生成十六进制格式的随机颜色
- 支持生成RGB格式的随机颜色
- 支持生成RGBA格式的随机颜色
- 可控制颜色亮度（自动、亮色、暗色）
- 可控制透明度（自动、高透明度、低透明度、自定义值）

## 项目结构

```
RandomColor/
├── entry/            # 示例应用
│   └── src/main/ets/pages/Index.ets  # 示例代码
├── randomColorLibrary/  # 核心库
│   └── src/main/ets/utils/RandomColor.ets  # 核心实现
└── README.md        # 项目文档
```

## 安装使用

### 1. 在HarmonyOS项目中添加依赖

将`randomColorLibrary`模块添加到您的项目中。

### 2. 导入并使用

```typescript
import RandomColor from 'random-color-library';

// 生成十六进制颜色
const hexColor = RandomColor.hex();

// 生成指定亮度的RGB颜色
const rgbColor = RandomColor.rgb('light');

// 生成指定亮度和透明度的RGBA颜色
const rgbaColor = RandomColor.rgba('dark', 'high');
```

## API文档

### RandomColor.hex(brightness)

生成随机的十六进制颜色字符串。

- **参数**：
  - `brightness`：可选，颜色亮度，可选值：'auto'（默认）、'light'、'dark'
- **返回值**：十六进制颜色字符串，如 `#FF5733`

### RandomColor.rgb(brightness)

生成随机的RGB颜色字符串。

- **参数**：
  - `brightness`：可选，颜色亮度，可选值：'auto'（默认）、'light'、'dark'
- **返回值**：RGB颜色字符串，如 `rgb(255, 87, 51)`

### RandomColor.rgba(brightness, alpha)

生成随机的RGBA颜色字符串。

- **参数**：
  - `brightness`：可选，颜色亮度，可选值：'auto'（默认）、'light'、'dark'
  - `alpha`：可选，透明度，可选值：'auto'（默认）、'high'、'low'、0-1之间的数字
- **返回值**：RGBA颜色字符串，如 `rgba(255, 87, 51, 0.8)`

## 示例应用

项目包含一个示例应用，展示了如何使用RandomColor库：

```typescript
import RandomColor from 'random-color-library';

@Entry
@Component
struct Index {
  @State message: string = RandomColor.hex();
  @State message1: string = RandomColor.rgba('dark')

  build() {
    RelativeContainer() {
      Text(this.message)
        .id('HelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontColor(this.message)
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(() => {
          this.message = 'Welcome';
        })
      Text(this.message1)
        .fontColor(this.message1)
    }
    .height('100%')
    .width('100%')
  }
}
```

## 贡献指南

欢迎提交Issue和Pull Request来帮助改进这个库。

## 许可证

本项目采用Apache License 2.0，详情请查看LICENSE文件。