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

2.4 KiB

汉字选择页面 (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

技术实现

汉字校验

isChineseText(text: string): boolean {
    const chineseRegex = /^[\u4e00-\u9fff]+$/;
    return chineseRegex.test(text);
}

文本分割

splitToSingleChars(text: string): string[] {
    const chineseRegex = /[\u4e00-\u9fff]/g;
    const matches = text.match(chineseRegex);
    return matches || [];
}

文件结构

  • index.ts: 页面逻辑文件
  • index.wxml: 页面模板文件
  • index.less: 页面样式文件
  • index.json: 页面配置文件