个人主页杨利杰YJlio❄️个人专栏《Windows 疑难杂症与工单复盘案例库》 《Sysinternals实战教程》《WINDOWS教程》 《Windows PowerShell 实战》 《IOS插件分析测试》《超简单用Python让Excel飞起来》让复杂的事情更简单让重复的工作自动化HarmonyOS 7.0学习笔记83IT工单搜索输入与结果过滤文章目录HarmonyOS 7.0学习笔记83IT工单搜索输入与结果过滤一、先把搜索行为定义清楚二、列表数据从哪里来三、区分原始数组和当前显示列表四、让输入变化驱动筛选结果五、空关键词与无匹配项是两种状态六、避免搜索状态与数据状态互相覆盖七、列出验证场景不把测试计划写成测试结果八、遇到问题时保留可复现信息九、总结参考资料大家好我是杨利杰 YJlio。工单列表一多靠滚动逐条查找就很费时间。搜索功能看起来只需要一个输入框实际要先想清楚几件事关键词匹配哪些文本、空输入时展示什么、没有匹配项时怎么提示以及过滤结果是否会影响原始数据。这篇笔记按“准备数据—绑定列表—处理输入—核对结果”的顺序拆解搜索功能。图中界面均为概念示意示例代码需要结合当前工程与 SDK 核对这里没有提供真实设备运行结果。一、先把搜索行为定义清楚实现之前先写出输入、动作和期望结果。对最小练习来说可以先约定搜索工单文本中的关键词关键词为空或只有空格时显示完整列表输入非空关键词时展示匹配项无匹配时显示空状态和清除入口。这些是本文采用的交互约定实际业务还要确认匹配字段、大小写规则、是否支持模糊搜索等要求。把规则提前写明后续才能判断问题出在输入事件、过滤逻辑还是界面状态。先定义空输入、匹配规则和无结果行为再开始写界面逻辑。二、列表数据从哪里来原始学习笔记用字符串数组演示工单标题Statetickets:string[][网络无法连接,打印机驱动安装];它适合讲清楚列表展示和文本匹配的基本关系。真实项目里工单通常还会有编号、分类、优先级或状态字段但这些字段没有出现在本篇原始示例中因此先不把它们写成现有模型。搜索条件也应单独保存。不要为了显示搜索结果而删改tickets本身否则清除关键词时可能无法恢复完整数据。三、区分原始数组和当前显示列表一个容易忽略的问题是搜索结果只是当前展示范围不等于原始数据发生了删除。可以把完整列表作为数据来源再根据关键词计算visibleTickets一类的展示结果。functionfilterTickets(tickets:string[],keyword:string):string[]{constquerykeyword.trim()if(query.length0){returntickets}returntickets.filter((ticket:string)ticket.includes(query))}这段代码是框架无关的算法示意用于表达“空关键词返回完整列表、非空关键词进行子串匹配”的规则它不是完整 ArkUI 页面也未在 DevEco Studio 中编译。includes的大小写和匹配边界要按产品需求确认若要不区分大小写还需要统一处理待匹配文本和关键词。过滤展示数据时保留原始数据清空搜索条件才有可靠的恢复来源。四、让输入变化驱动筛选结果界面逻辑可以拆成四步准备列表数据、按当前模板绑定列表、读取搜索输入、将筛选后的结果交给展示区域。输入一变化就根据明确的规则重新计算结果不要同时维护多份内容相同、却可能不同步的数组。原稿中的ForEach片段仅展示字符串列表的基础呈现。输入框、状态装饰器、事件回调及绑定方式可能随工程模板和 SDK 版本不同发布前要依据自己的工程补齐并验证不能从伪代码推断具体组件签名。五、空关键词与无匹配项是两种状态空关键词表示用户尚未限定搜索范围通常应显示未筛选列表无匹配项则表示已经输入条件但当前数据里没有符合规则的文本。把两者都画成空白页面会让用户分不清是没有数据、还没搜索还是搜索条件过窄。可以为无匹配项提供简洁说明和清除关键词的入口。清除动作应修改搜索条件再依据同一套过滤逻辑更新展示而不是直接重建或删除原始数组。六、避免搜索状态与数据状态互相覆盖每次输入改变时只更新搜索条件或派生展示结果。原始数组仍由数据层或页面状态持有筛选结果用于当前渲染。若用户清空输入应能从完整数据源重新得到列表。实际代码中还要明确搜索何时触发逐字输入、点击搜索按钮或输入结束后提交。不同策略会影响事件处理、性能和用户预期。当前原稿没有规定触发方式建议先选定一种并记录再按工程模板实现。七、列出验证场景不把测试计划写成测试结果可先准备一份最小检查清单逐项实际操作并记录观察结果。下面的图是待执行测试场景不表示这些场景已经通过。场景输入观察点空关键词清空输入或只输入空格是否展示完整列表空格规则是否符合约定匹配关键词输入可在工单文本中找到的片段展示项是否符合约定的匹配规则无匹配关键词输入当前数据中没有的文本是否显示明确的无结果提示和恢复入口连续修改连续替换、删减关键词展示结果是否跟随当前输入不残留旧条件八、遇到问题时保留可复现信息如果编译提示类型或 API 不存在先核对当前工程的 SDK 版本、模块依赖和导入路径若输入后界面没有变化再检查事件是否触发、绑定状态是否被 UI 读取、更新是否落在正确的页面生命周期内。每次排查至少记录工程版本、设备或模拟器信息、窗口尺寸、复现输入和完整错误文本。没有这些信息时单独一张结果截图很难说明差异来自代码、版本还是设备环境。计划中的检查项不是实测证据只有在实际工程运行后才能补写运行结果。九、总结工单搜索可以从一条简单的数据流开始保存原始列表记录关键词按已约定的匹配规则计算展示结果再分别处理空输入与无匹配状态。这样既能保持逻辑清楚也能避免搜索操作意外改写数据来源。本篇示例仍是学习材料。发布前应补充真实 DevEco Studio 版本、工程 SDK、运行设备、实际截图和遇到的问题如果示例与当前工程不一致应以编译诊断和对应版本资料为准不把概念示意写成已验证结论。参考资料原始学习笔记083_20261212_HarmonyOS学习笔记_IT工单搜索输入与结果过滤.mdHarmonyOS 开发者文档请按当前工程 SDK 版本核对 ArkTS / ArkUI 组件与状态管理相关文档。声明本文为个人学习记录模板示例代码和概念图片需结合实际工程核验环境信息、编译结果及设备表现以作者实际记录为准。返回顶部
个人主页杨利杰YJlio❄️个人专栏《Windows 疑难杂症与工单复盘案例库》 《Sysinternals实战教程》《WINDOWS教程》 《Windows PowerShell 实战》 《IOS插件分析测试》《超简单用Python让Excel飞起来》让复杂的事情更简单让重复的工作自动化HarmonyOS 7.0学习笔记83IT工单搜索输入与结果过滤文章目录HarmonyOS 7.0学习笔记83IT工单搜索输入与结果过滤一、先把搜索行为定义清楚二、列表数据从哪里来三、区分原始数组和当前显示列表四、让输入变化驱动筛选结果五、空关键词与无匹配项是两种状态六、避免搜索状态与数据状态互相覆盖七、列出验证场景不把测试计划写成测试结果八、遇到问题时保留可复现信息九、总结参考资料大家好我是杨利杰 YJlio。工单列表一多靠滚动逐条查找就很费时间。搜索功能看起来只需要一个输入框实际要先想清楚几件事关键词匹配哪些文本、空输入时展示什么、没有匹配项时怎么提示以及过滤结果是否会影响原始数据。这篇笔记按“准备数据—绑定列表—处理输入—核对结果”的顺序拆解搜索功能。图中界面均为概念示意示例代码需要结合当前工程与 SDK 核对这里没有提供真实设备运行结果。一、先把搜索行为定义清楚实现之前先写出输入、动作和期望结果。对最小练习来说可以先约定搜索工单文本中的关键词关键词为空或只有空格时显示完整列表输入非空关键词时展示匹配项无匹配时显示空状态和清除入口。这些是本文采用的交互约定实际业务还要确认匹配字段、大小写规则、是否支持模糊搜索等要求。把规则提前写明后续才能判断问题出在输入事件、过滤逻辑还是界面状态。先定义空输入、匹配规则和无结果行为再开始写界面逻辑。二、列表数据从哪里来原始学习笔记用字符串数组演示工单标题Statetickets:string[][网络无法连接,打印机驱动安装];它适合讲清楚列表展示和文本匹配的基本关系。真实项目里工单通常还会有编号、分类、优先级或状态字段但这些字段没有出现在本篇原始示例中因此先不把它们写成现有模型。搜索条件也应单独保存。不要为了显示搜索结果而删改tickets本身否则清除关键词时可能无法恢复完整数据。三、区分原始数组和当前显示列表一个容易忽略的问题是搜索结果只是当前展示范围不等于原始数据发生了删除。可以把完整列表作为数据来源再根据关键词计算visibleTickets一类的展示结果。functionfilterTickets(tickets:string[],keyword:string):string[]{constquerykeyword.trim()if(query.length0){returntickets}returntickets.filter((ticket:string)ticket.includes(query))}这段代码是框架无关的算法示意用于表达“空关键词返回完整列表、非空关键词进行子串匹配”的规则它不是完整 ArkUI 页面也未在 DevEco Studio 中编译。includes的大小写和匹配边界要按产品需求确认若要不区分大小写还需要统一处理待匹配文本和关键词。过滤展示数据时保留原始数据清空搜索条件才有可靠的恢复来源。四、让输入变化驱动筛选结果界面逻辑可以拆成四步准备列表数据、按当前模板绑定列表、读取搜索输入、将筛选后的结果交给展示区域。输入一变化就根据明确的规则重新计算结果不要同时维护多份内容相同、却可能不同步的数组。原稿中的ForEach片段仅展示字符串列表的基础呈现。输入框、状态装饰器、事件回调及绑定方式可能随工程模板和 SDK 版本不同发布前要依据自己的工程补齐并验证不能从伪代码推断具体组件签名。五、空关键词与无匹配项是两种状态空关键词表示用户尚未限定搜索范围通常应显示未筛选列表无匹配项则表示已经输入条件但当前数据里没有符合规则的文本。把两者都画成空白页面会让用户分不清是没有数据、还没搜索还是搜索条件过窄。可以为无匹配项提供简洁说明和清除关键词的入口。清除动作应修改搜索条件再依据同一套过滤逻辑更新展示而不是直接重建或删除原始数组。六、避免搜索状态与数据状态互相覆盖每次输入改变时只更新搜索条件或派生展示结果。原始数组仍由数据层或页面状态持有筛选结果用于当前渲染。若用户清空输入应能从完整数据源重新得到列表。实际代码中还要明确搜索何时触发逐字输入、点击搜索按钮或输入结束后提交。不同策略会影响事件处理、性能和用户预期。当前原稿没有规定触发方式建议先选定一种并记录再按工程模板实现。七、列出验证场景不把测试计划写成测试结果可先准备一份最小检查清单逐项实际操作并记录观察结果。下面的图是待执行测试场景不表示这些场景已经通过。场景输入观察点空关键词清空输入或只输入空格是否展示完整列表空格规则是否符合约定匹配关键词输入可在工单文本中找到的片段展示项是否符合约定的匹配规则无匹配关键词输入当前数据中没有的文本是否显示明确的无结果提示和恢复入口连续修改连续替换、删减关键词展示结果是否跟随当前输入不残留旧条件八、遇到问题时保留可复现信息如果编译提示类型或 API 不存在先核对当前工程的 SDK 版本、模块依赖和导入路径若输入后界面没有变化再检查事件是否触发、绑定状态是否被 UI 读取、更新是否落在正确的页面生命周期内。每次排查至少记录工程版本、设备或模拟器信息、窗口尺寸、复现输入和完整错误文本。没有这些信息时单独一张结果截图很难说明差异来自代码、版本还是设备环境。计划中的检查项不是实测证据只有在实际工程运行后才能补写运行结果。九、总结工单搜索可以从一条简单的数据流开始保存原始列表记录关键词按已约定的匹配规则计算展示结果再分别处理空输入与无匹配状态。这样既能保持逻辑清楚也能避免搜索操作意外改写数据来源。本篇示例仍是学习材料。发布前应补充真实 DevEco Studio 版本、工程 SDK、运行设备、实际截图和遇到的问题如果示例与当前工程不一致应以编译诊断和对应版本资料为准不把概念示意写成已验证结论。参考资料原始学习笔记083_20261212_HarmonyOS学习笔记_IT工单搜索输入与结果过滤.mdHarmonyOS 开发者文档请按当前工程 SDK 版本核对 ArkTS / ArkUI 组件与状态管理相关文档。声明本文为个人学习记录模板示例代码和概念图片需结合实际工程核验环境信息、编译结果及设备表现以作者实际记录为准。返回顶部
