安全控件通用属性 (系统接口)

模块简介

安全控件的基础属性系统接口，用于在测试和调试场景中为安全控件设置唯一标识，以便精确定位和验证安全控件的属性设置与交互行为。

该模块主要用于以下场景：

• 在测试或调试场景中，为安全控件设置额外唯一标识，便于按标识精确定位目标控件实例。
• 通过唯一标识追踪和验证安全控件的属性设置与交互行为，快速定位问题。

说明：

该组件从API version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

当前页面仅包含本模块的系统接口，其他公开接口参见安全控件通用属性。

关键Class/Interface介绍

核心接口类型

• SecurityComponentMethod<T>： 安全控件通用属性方法集合，用于承载公开属性之外的系统扩展属性。

核心函数类型

• key： 设置组件唯一标识，仅用于测试场景中验证安全控件属性设置和交互行为。

key

key(value: string): T

设置组件的唯一标识，唯一性由开发者保证。调用成功后，组件将被赋予指定的唯一标识字符串，可在测试场景中精确定位该组件实例。与id同时使用时，后设置的标识值会覆盖先设置的标识值，建议仅设置id。

此接口仅用于应用测试场景，验证安全控件的属性设置和交互行为。生产环境请使用公开接口id。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	string	是	组件的唯一标识，唯一性由开发者保证。适用于测试场景中按标识精确定位安全控件实例。

返回值：

类型	说明
T	返回安全控件的属性。