鸿蒙NEXT开发案例：数字转中文大小写
【引言】
本应用的主要功能是将用户输入的数字转换为中文的小写、大写及大写金额形式。用户可以在输入框中输入任意数字，点击“示例”按钮可以快速填充预设的数字，点击“清空”按钮则会清除当前输入。转换结果显示在下方的结果区域，每个结果旁边都有一个“复制”按钮，方便用户将结果复制到剪贴板。
【环境准备】
• 操作系统：Windows 10
• 开发工具：DevEco Studio NEXT Beta1 Build Version: 5.0.3.806
• 目标设备：华为Mate60 Pro
• 开发语言：ArkTS
• 框架：ArkUI
• API版本：API 12
• 三方库：chinese-number-format（数字转中文）、chinese-finance-number（将数字转换成财务用的中文大写数字）
ohpm install @nutpi/chinese-finance-number ohpm install @nutpi/chinese-number-format
【功能实现】
• 输入监听：通过 @Watch 装饰器监听输入框的变化，一旦输入发生变化，即调用 inputChanged 方法更新转换结果。
• 转换逻辑：利用 @nutpi/chinese-number-format 和 @nutpi/chinese-finance-number 库提供的方法完成数字到中文的各种转换。
• 复制功能：使用 pasteboard 模块将结果显示的中文文本复制到剪贴板，通过 promptAction.showToast 提示用户复制成功。
【完整代码】
// 导入必要的模块
import { promptAction } from '@kit.ArkUI'; // 用于显示提示信息
import { pasteboard } from '@kit.BasicServicesKit'; // 用于处理剪贴板操作
import { toChineseNumber } from '@nutpi/chinese-finance-number'; // 将数字转换为中文大写金额
import {
toChineseWithUnits, // 将数字转换为带单位的中文
toUpperCase, // 将中文小写转换为大写
} from '@nutpi/chinese-number-format';
@Entry // 标记此组件为入口点
@Component // 定义一个组件
struct NumberToChineseConverter {
@State private exampleNumber: number = 88.8; // 示例数字
@State private textColor: string = "#2e2e2e"; // 文本颜色
@State private lineColor: string = "#d5d5d5"; // 分割线颜色
@State private basePadding: number = 30; // 基础内边距
@State private chineseLowercase: string = ""; // 转换后的小写中文
@State private chineseUppercase: string = ""; // 转换后的中文大写
@State private chineseUppercaseAmount: string = ""; // 转换后的中文大写金额
@State @Watch('inputChanged') private inputText: string = ""; // 监听输入文本变化
// 当输入文本改变时触发的方法
inputChanged() {
this.chineseLowercase = toChineseWithUnits(Number(this.inputText), 'zh-CN'); // 转换为小写中文并带上单位
this.chineseUppercase = toUpperCase(this.chineseLowercase, 'zh-CN'); // 将小写中文转换为大写
this.chineseUppercaseAmount = toChineseNumber(Number(this.inputText)); // 转换为大写金额
}
// 复制文本到剪贴板的方法
private copyToClipboard(text: string): void {
const pasteboardData = pasteboard.createData(pasteboard.MIMETYPE_TEXT_PLAIN, text); // 创建剪贴板数据
const systemPasteboard = pasteboard.getSystemPasteboard(); // 获取系统剪贴板
systemPasteboard.setData(pasteboardData); // 设置剪贴板数据
promptAction.showToast({ message: '已复制' }); // 显示复制成功的提示
}
// 构建用户界面的方法
build() {
Column() { // 主列容器
// 页面标题
Text('数字转中文大小写')
.fontColor(this.textColor) // 设置字体颜色
.fontSize(18) // 设置字体大小
.width('100%') // 设置宽度
.height(50) // 设置高度
.textAlign(TextAlign.Center) // 文本居中对齐
.backgroundColor(Color.White) // 设置背景颜色
.shadow({ // 添加阴影效果
radius: 2, // 阴影半径
color: this.lineColor, // 阴影颜色
offsetX: 0, // X轴偏移量
offsetY: 5 // Y轴偏移量
});
Scroll() { // 滚动视图
Column() { // 内部列容器
// 工具介绍部分
Column() {
Text('工具介绍').fontSize(20).fontWeight(600).fontColor(this.textColor); // 设置介绍文字样式
Text('将数字转换为中文格式，适用于票据填写、合同文书、财务报表等多种场景。支持从最小单位“分”到最大单位“千兆”的数字转换。')
.textAlign(TextAlign.JUSTIFY)
.fontSize(18).fontColor(this.textColor).margin({ top: `${this.basePadding / 2}lpx` }); // 设置介绍详情文字样式
}
.alignItems(HorizontalAlign.Start) // 对齐方式
.width('650lpx') // 设置宽度
.padding(`${this.basePadding}lpx`) // 设置内边距
.margin({ top: `${this.basePadding}lpx` }) // 设置外边距
.borderRadius(10) // 设置圆角
.backgroundColor(Color.White) // 设置背景颜色
.shadow({ // 添加阴影效果
radius: 10, // 阴影半径
color: this.lineColor, // 阴影颜色
offsetX: 0, // X轴偏移量
offsetY: 0 // Y轴偏移量
});
// 输入区
Column() {
Row() { // 行容器
Text('示例')
.fontColor("#5871ce") // 设置字体颜色
.fontSize(18) // 设置字体大小
.padding(`${this.basePadding / 2}lpx`) // 设置内边距
.backgroundColor("#f2f1fd") // 设置背景颜色
.borderRadius(5) // 设置圆角
.clickEffect({ level: ClickEffectLevel.LIGHT, scale: 0.8 }) // 设置点击效果
.onClick(() => { // 点击事件
this.inputText = `${this.exampleNumber}`; // 设置输入框文本为示例数字
});
Blank(); // 占位符
Text('清空')
.fontColor("#e48742") // 设置字体颜色
.fontSize(18) // 设置字体大小
.padding(`${this.basePadding / 2}lpx`) // 设置内边距
.clickEffect({ level: ClickEffectLevel.LIGHT, scale: 0.8 }) // 设置点击效果
.backgroundColor("#ffefe6") // 设置背景颜色
.borderRadius(5) // 设置圆角
.onClick(() => { // 点击事件
this.inputText = ""; // 清空输入框
});
}.height(45) // 设置高度
.justifyContent(FlexAlign.SpaceBetween) // 子元素水平分布方式
.width('100%'); // 设置宽度
Divider().margin({ top: 5, bottom: 5 }); // 分割线
TextInput({ text: $$this.inputText, placeholder: `请输入数字，例如：${this.exampleNumber}` }) // 输入框
.width('100%') // 设置宽度
.fontSize(18) // 设置字体大小
.caretColor(this.textColor) // 设置光标颜色
.fontColor(this.textColor) // 设置字体颜色
.margin({ top: `${this.basePadding}lpx` }) // 设置外边距
.padding(0) // 设置内边距
.backgroundColor(Color.Transparent) // 设置背景颜色
.borderRadius(0) // 设置圆角
.type(InputType.NUMBER_DECIMAL); // 设置输入类型为数字
}
.alignItems(HorizontalAlign.Start) // 对齐方式
.width('650lpx') // 设置宽度
.padding(`${this.basePadding}lpx`) // 设置内边距
.margin({ top: `${this.basePadding}lpx` }) // 设置外边距
.borderRadius(10) // 设置圆角
.backgroundColor(Color.White) // 设置背景颜色
.shadow({ // 添加阴影效果
radius: 10, // 阴影半径
color: this.lineColor, // 阴影颜色
offsetX: 0, // X轴偏移量
offsetY: 0 // Y轴偏移量
});
// 结果区
Column() {
Row() {
Text(`小写：${this.chineseLowercase}`).fontColor(this.textColor).fontSize(18).layoutWeight(1); // 显示小写结果
Text('复制')
.fontColor(Color.White) // 设置字体颜色
.fontSize(18) // 设置字体大小
.padding(`${this.basePadding / 2}lpx`) // 设置内边距
.backgroundColor("#0052d9") // 设置背景颜色
.borderRadius(5) // 设置圆角
.clickEffect({ level: ClickEffectLevel.LIGHT, scale: 0.8 }) // 设置点击效果
.onClick(() => { // 点击事件
this.copyToClipboard(this.chineseLowercase); // 复制小写结果到剪贴板
});
}.constraintSize({ minHeight: 45 }) // 最小高度
.justifyContent(FlexAlign.SpaceBetween) // 子元素水平分布方式
.width('100%'); // 设置宽度
Divider().margin({ top: 5, bottom: 5 }); // 分割线
Row() {
Text(`大写：${this.chineseUppercase}`).fontColor(this.textColor).fontSize(18).layoutWeight(1); // 显示大写结果
Text('复制')
.fontColor(Color.White) // 设置字体颜色
.fontSize(18) // 设置字体大小
.padding(`${this.basePadding / 2}lpx`) // 设置内边距
.backgroundColor("#0052d9") // 设置背景颜色
.borderRadius(5) // 设置圆角
.clickEffect({ level: ClickEffectLevel.LIGHT, scale: 0.8 }) // 设置点击效果
.onClick(() => { // 点击事件
this.copyToClipboard(this.chineseUppercase); // 复制大写结果到剪贴板
});
}.constraintSize({ minHeight: 45 }) // 最小高度
.justifyContent(FlexAlign.SpaceBetween) // 子元素水平分布方式
.width('100%'); // 设置宽度
Divider().margin({ top: 5, bottom: 5 }); // 分割线
Row() {
Text(`大写金额：${this.chineseUppercaseAmount}`).fontColor(this.textColor).fontSize(18).layoutWeight(1); // 显示大写金额结果
Text('复制')
.fontColor(Color.White) // 设置字体颜色
.fontSize(18) // 设置字体大小
.padding(`${this.basePadding / 2}lpx`) // 设置内边距
.backgroundColor("#0052d9") // 设置背景颜色
.borderRadius(5) // 设置圆角
.clickEffect({ level: ClickEffectLevel.LIGHT, scale: 0.8 }) // 设置点击效果
.onClick(() => { // 点击事件
this.copyToClipboard(this.chineseUppercaseAmount); // 复制大写金额结果到剪贴板
});
}.constraintSize({ minHeight: 45 }) // 最小高度
.justifyContent(FlexAlign.SpaceBetween) // 子元素水平分布方式
.width('100%'); // 设置宽度
}
.alignItems(HorizontalAlign.Start) // 对齐方式
.width('650lpx') // 设置宽度
.padding(`${this.basePadding}lpx`) // 设置内边距
.margin({ top: `${this.basePadding}lpx` }) // 设置外边距
.borderRadius(10) // 设置圆角
.backgroundColor(Color.White) // 设置背景颜色
.shadow({ // 添加阴影效果
radius: 10, // 阴影半径
color: this.lineColor, // 阴影颜色
offsetX: 0, // X轴偏移量
offsetY: 0 // Y轴偏移量
});
}
}.scrollBar(BarState.Off).clip(false); // 关闭滚动条，不允许裁剪
}
.height('100%') // 设置高度
.width('100%') // 设置宽度
.backgroundColor("#f4f8fb"); // 设置页面背景颜色
}
}
