尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
HarmonyOS ArkTS 的新手练手样例:用 Toggle、Checkbox、Slider 和 AlertDialog 做一个设置页
开头设置页看起来简单但它包含很多基础交互开关、勾选、滑动调节、确认弹窗。把这些控件练熟后面做个人中心、偏好设置、隐私设置都会顺手。这一篇我们做一个“阅读设置页”开启深色模式、勾选自动保存、调节字号点击按钮弹出确认框。本篇目标会用Toggle表示开关状态。会用Checkbox表示是否选择。会用Slider调节数值。会用AlertDialog做确认弹窗。示例代码EntryComponentstruct ReaderSettingsPage{StatedarkMode:booleanfalse;StateautoSave:booleantrue;StatefontSize:number18;Statemessage:string当前设置还没有保存;privatesaveSettings(){AlertDialog.show({title:保存设置,message:深色模式${this.darkMode?开启:关闭}\n自动保存${this.autoSave?开启:关闭}\n字号${this.fontSize},primaryButton:{value:确定,action:(){this.message设置已保存;}},secondaryButton:{value:取消,action:(){this.message取消保存;}}});}build(){Column({space:18}){Text(阅读设置).fontSize(28).fontWeight(FontWeight.Bold).width(100%)Row(){Text(深色模式).fontSize(16).layoutWeight(1)Toggle({type:ToggleType.Switch,isOn:this.darkMode}).onChange((isOn:boolean){this.darkModeisOn;})}.width(100%).height(48)Row(){Text(自动保存草稿).fontSize(16).layoutWeight(1)Checkbox().select(this.autoSave).onChange((value:boolean){this.autoSavevalue;})}.width(100%).height(48)Column({space:8}){Row(){Text(文章字号).fontSize(16).layoutWeight(1)Text(${Math.round(this.fontSize)}).fontSize(16).fontColor(#666666)}.width(100%)Slider({value:this.fontSize,min:14,max:28,step:1}).onChange((value:number){this.fontSizevalue;})}.width(100%)Text(预览文字这是一段阅读效果预览。).fontSize(this.fontSize).fontColor(this.darkMode?#F5F5F5:#222222).backgroundColor(this.darkMode?#222222:#F7F7F7).borderRadius(8).padding(12).width(100%)Text(this.message).fontSize(14).fontColor(#666666).width(100%)Button(保存设置).width(100%).height(48).onClick((){this.saveSettings();})}.width(100%).height(100%).padding(20)}}小白看懂代码Toggle适合表示“开/关”。比如深色模式、消息通知、是否允许定位。Checkbox适合表示“选中/未选中”。如果页面里有多个独立选项用它很合适。Slider适合调节数值。字号、音量、亮度、进度都可以用类似方式实现。AlertDialog.show()会弹出对话框。这里点击“保存设置”后把当前状态拼成提示内容再由用户确认。选择控件怎么判断用哪个如果只有两个状态而且更像“功能开关”用Toggle。如果是表单中的勾选项用Checkbox。如果是多个选项中只能选一个可以继续学习Radio。如果是从一段范围里选数值用Slider。新手常见错误第一种错误控件显示值和状态没有绑定。比如开关写死Toggle({type:ToggleType.Switch,isOn:false})这样你后续不好根据状态控制界面。更好的方式是绑定状态Toggle({type:ToggleType.Switch,isOn:this.darkMode})第二种错误滑块返回的是数字但展示时不处理小数。如果你设置了step: 1一般展示时可以用Math.round(this.fontSize)第三种错误弹窗里写太多逻辑。弹窗更适合做确认真正复杂的保存逻辑应该放到单独方法里。本篇小结设置页是练习基础控件的好地方。Toggle管开关Checkbox管勾选Slider管范围数值AlertDialog管确认反馈。等这些交互熟悉后你就能做出很多真实应用页面。附录项目设置与构建问题记录一、项目设置本篇配套一个独立 ArkTS 示例 App用于运行页面和截图建议用 DevEco Studio 打开项目后运行entry模块。项目定位是截图练习 Demo不依赖后端服务也不需要额外权限。建议新建或检查工程时保持以下设置Project typeApplication。TemplateEmpty Ability。LanguageArkTS。ModelStage。DevicePhone可按需要兼容 Tablet、2in1。Runtime OSHarmonyOS。二、SDK 版本本文主题面向 HarmonyOS ArkTS API 24。本次示例工程根目录build-profile.json5使用如下配置{ compatibleSdkVersion: 6.1.1(24), targetSdkVersion: 6.1.1(24), runtimeOS: HarmonyOS }如果本机 DevEco Studio SDK Manager 中安装的版本不同请按本机实际 API 24 SDK 调整compatibleSdkVersion和targetSdkVersion。三、项目目录说明核心目录如下HarmonyOS_ArkTS_API24_ControlsScreenshotApp/ ├── AppScope/ │ ├── app.json5 │ └── resources/ ├── entry/ │ ├── src/main/ets/entryability/EntryAbility.ets │ ├── src/main/ets/pages/ │ ├── src/main/resources/base/profile/main_pages.json │ ├── build-profile.json5 │ └── oh-package.json5 ├── build-profile.json5 ├── hvigorfile.ts └── oh-package.json5页面文件都在entry/src/main/ets/pages/路由注册文件在entry/src/main/resources/base/profile/main_pages.json五、创建项目过程打开 DevEco Studio。点击 Create Project。选择 Application。模板选择 Empty Ability。开发语言选择 ArkTS。模型选择 Stage。设置项目名称例如ArkTSControlsDemo。选择保存路径建议路径只包含英文、数字、下划线或连字符。选择 API 24 对应 SDK。点击 Finish等待工程创建完成。打开entry/src/main/ets/pages/Index.ets。运行默认工程确认模拟器或真机能打开。再逐个添加本文中的页面代码并截图。六、本次编译安装遇到的问题与解决办法1. 中文路径导致 Hvigor 拒绝构建问题现象Invalid project path. Current path does not match: D:\私人资料\CSDN\HarmonyOS_ArkTS_API24_ControlsScreenshotApp原因Hvigor 对工程路径有限制路径只能包含英文字母、数字、连字符、下划线、英文句点、英文括号、空格或。处理办法把项目复制到 ASCII 路径后构建D:\\HarmonyOS_ArkTS_API24_ControlsScreenshotApp2.DEVECO_SDK_HOME环境变量无效问题现象Invalid value of DEVECO_SDK_HOME in the system environment path.处理办法在当前命令会话中临时指定 DevEco SDK 根目录$env:DEVECO_SDK_HOMED:\Program Files\Huawei\DevEco Studio Beta\sdk3.hvigor-config.json5缺少dependencies问题现象Schema validate failed ... missingProperty: dependencies处理办法补齐hvigor/hvigor-config.json5{ modelVersion: 5.0.0, dependencies: { } }4. 打包阶段找不到 Java问题现象spawn java ENOENT处理办法使用 DevEco Studio 自带 JBR并停止旧的 Hvigor daemon 后重新构建$env:JAVA_HOMED:\Program Files\Huawei\DevEco Studio Beta\jbr$env:PathD:\Program Files\Huawei\DevEco Studio Beta\jbr\bin;$env:Pathhvigorw--stop-daemon5. 构建成功但有弃用警告构建时出现过router.pushUrl、router.back、AlertDialog.show的弃用警告但不影响本次截图 Demo 编译和安装。正式项目建议后续按当前 API 推荐方式替换。七、本次安装启动记录构建命令hvigorw--mode module-p moduleentrydefault-p productdefault assembleHap安装命令hdc install entry-default-unsigned.hap启动命令hdc shell aastart-a EntryAbility-b com.csdn.arkts.controls.screenshot验证结果HAP 构建成功。模拟器目标127.0.0.1:5555。安装结果install bundle successfully。启动结果start ability successfully。
RELATED

相关推荐

Minecraft废弃服务器探索:技术分析、数据挖掘与合规实践

Minecraft废弃服务器探索:技术分析、数据挖掘与合规实践

这次我们来深入探讨一个在Minecraft社区中颇具神秘色彩的话题——如何探索那些被遗弃的"死寂"Minecraft服务器,并从中寻找隐藏的真相。这类服务器往往承载着独特的历史痕迹、未解之谜,甚至是开发者留下的彩蛋,对于喜欢探索和技术分…

📅 2026/11/15 10:54:43
Flutter + AI 的融合实践:7月最成功的 5 个技术交叉点复盘

Flutter + AI 的融合实践:7月最成功的 5 个技术交叉点复盘

Flutter AI 的融合实践:7月最成功的 5 个技术交叉点复盘 一、引子:Flutter 和 AI 是天然的好搭档 美院学雕塑时有一道工序叫"翻模"——先用泥塑做出原型,再用硅胶翻成模具,最后用模具浇筑出成品。Flutter 和 AI 的关…

📅 2026/11/16 10:20:59
无障碍设计的月度共读:WCAG 2.2 全部标准的逐一解读与实践

无障碍设计的月度共读:WCAG 2.2 全部标准的逐一解读与实践

无障碍设计的月度共读:WCAG 2.2 全部标准的逐一解读与实践 一、引子:WCAG 2.2 有 86 条标准,但日常能用到的就 20 条 美院第一年有一门基础课叫"色彩构成",教材厚达 300 页,但老师第一节课就说&#xff1a…

📅 2026/11/16 20:27:33
MORE NEWS

更多资讯

📰

弱电电工证学习资料通过率揭秘:怎么避免被中介坑?

弱电电工证学习资料通过率揭秘:怎么避免被中介坑? 不知道去哪报名怕被中介坑,是不是你现在的烦恼?弱电电工证学习资料虽然在网上一搜一大堆,但真正能帮你拿到证、考过的,少之又少。特别是在济源房建工程这一块,很多从业者对这个证书的认知还停留在“只…

📰

瓮安县电焊特种工证多久拿证?学历不高也能轻松考过

瓮安县电焊特种工证多久拿证?学历不高也能轻松考过 你是不是也担心学历不高报不了瓮安县电焊特种工证?其实别担心,只要符合报名条件,学历不是问题。而且很多人拿到证的时间并不长,一般 20天左右…

📰

电工证看板模板全流程办理指南:考前押题怎么用才有效

电工证看板模板全流程办理指南:考前押题怎么用才有效 你还在为找不到电工证看板模板发愁?急需特种作业证才能上岗找工作,别再拖了,今天就教你用好考前押题,一步到位搞定电工证!…

📰

厂里监工需要电工证吗 在哪考这些细节你必须知道

厂里监工需要电工证吗 在哪考这些细节你必须知道 学历不高怕报不上名?厂里监工到底需不需要电工证?你是不是也经常看到工地上有人拿着电工证在指挥施工,心里想着自己能不能也考一个?别急,今天咱们就来聊聊【厂里监工需要电工证吗】这个话题,顺便告诉你…

📰

麻涌电工证培训学校在哪考怕考不过白交培训费?看这里全搞定

麻涌电工证培训学校在哪考怕考不过白交培训费?看这里全搞定 怕考不过白交培训费?这是很多准备报考麻涌电工证培训学校的朋友心里最怕的事。其实,只要方法对, 考过不是问题 ,关键是你得知道 在哪考…

📰

杭州萧山低压电工证培训机构怎么选?避开郑州报考避坑指南

杭州萧山低压电工证培训机构怎么选?避开郑州报考避坑指南 你是不是正盯着招聘启事,发现“持有低压电工证”成了硬门槛?别急,这事儿不是没辙。现在不少人在杭州萧山想考低压电工证,但不知道怎么下手,培训机构五花八门,报了还可能被坑。今天我就从一个干…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬