Files
doodle-mini/miniprogram/pages/wordDemo/README.md
T
2025-09-12 16:56:00 +08:00

90 lines
2.4 KiB
Markdown

# 汉字选择页面 (wordDemo)
## 功能描述
这是一个汉字输入和选择的页面,主要包含以下功能:
### 上部区域 - 汉字输入
- 输入框:可以输入任意汉字(最多10个字符)
- 生成按钮:点击后将输入的汉字添加到已选择列表中
- **汉字校验**:自动校验输入内容是否为汉字,非汉字会提示错误
- **智能分割**:支持输入多个汉字,自动分割为单个汉字存储
### 中部区域 - 已选择的汉字
- 显示所有已选择的汉字
- 每个汉字都有删除按钮(×)
- 清空按钮:一键清空所有已选择的汉字
- 显示已选择汉字的数量
### 下部区域 - 可选汉字
-`demo/grade3.json` 文件中提取前30个汉字
- 以6列网格形式展示
- 已选择的汉字会显示为禁用状态
- 点击未选择的汉字可以添加到列表中
## 核心特性
### 🔍 **汉字校验**
- 使用Unicode范围 `\u4e00-\u9fff` 校验汉字
- 非汉字输入会显示Toast提示"请输入汉字"
- 确保 `wordList` 中只存储纯汉字
### ✂️ **智能分割**
- 支持输入多个汉字(如:"你好世界")
- 自动分割为单个汉字:["你", "好", "世", "界"]
- 过滤重复汉字,避免重复添加
- 显示实际添加的汉字数量
### 💾 **数据管理**
- `wordList` 中每个元素都是单个汉字
- 自动去重,避免重复存储
- 支持批量添加和单个删除
## 数据结构
- `inputWord`: 输入框中的汉字
- `wordList`: 已选择的汉字列表(string[]类型,每个元素为单个汉字)
- `availableWords`: 从grade3.json中提取的前30个汉字
## 使用方法
1. 在输入框中输入汉字(支持多个汉字)
2. 点击"生成"按钮,系统自动校验和分割
3. 点击下方网格中的汉字进行选择
4. 已选择的汉字会显示在上方,可以单独删除或一键清空
5. 所有选择的汉字都存储在 `this.data.wordList`
## 技术实现
### 汉字校验
```typescript
isChineseText(text: string): boolean {
const chineseRegex = /^[\u4e00-\u9fff]+$/;
return chineseRegex.test(text);
}
```
### 文本分割
```typescript
splitToSingleChars(text: string): string[] {
const chineseRegex = /[\u4e00-\u9fff]/g;
const matches = text.match(chineseRegex);
return matches || [];
}
```
## 文件结构
- `index.ts`: 页面逻辑文件
- `index.wxml`: 页面模板文件
- `index.less`: 页面样式文件
- `index.json`: 页面配置文件