--- title: "状态颜色指示器单元测试" slug: "status-color-indicator" updated: 2026-10-22T17:23:37Z published: 2026-10-22T17:23:37Z canonical: "support.tulip.co/status-color-indicator" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # 状态颜色指示器单元测试 :::(Info)To download, visit: [Library](https://library.tulip.co/apps/status-color-indicator-widget). ::: 本应用说明了如何设置和使用“状态颜色指示器”自定义小部件。 ## 目的 “状态颜色指示器”单元测试的目的是让用户学习并了解如何在其 Tulip 应用程序中设置和使用“状态颜色指示器”自定义小部件。 自定义小部件是构建在 Tulip 平台之上的编码小部件,用于提供当前主平台中尚未包含的附加功能。此特定自定义小部件会根据输入以及预先定义的键值对,在应用程序中显示一个彩色对象。 ## 设置 自定义控件插件通过属性(props)和事件与您的应用程序交互。属性是应用程序与控件之间共享的数据,而事件是控件可以发送给应用程序的信号。在应用程序编辑器中,您可以基于这些事件构建触发器。事件还可以被设置为向您的应用程序发送数据。 “状态颜色指示器”自定义控件使用以下属性与事件: - STATUSES:这是一个包含特定键值对的对象列表(例如:机器状态及其对应的颜色) - STATUS:在此处输入键(key),以显示与其关联的颜色(value)。 - OBJECT LIST EMPTY:当 STATUSES 对象列表为空时,此事件会被触发。小部件将显示白色背景。 - 状态未定义:当您输入的状态在 STATUSES 列表中未定义时,将触发此事件。小部件将显示黑色背景。 ## 工作原理 在“状态颜色指示器”自定义控件中,用户可以在 STATUSES 属性中定义一组状态-颜色对,然后将 STATUS 属性绑定到静态值、变量、表记录等。 当该字段有值时,控件会检查您输入的文本是否存在于预定义列表中;如果存在,则显示该状态对应的颜色;如果不存在,则触发事件并将背景设置为黑色。 作为最佳实践,建议在这些触发器中同时显示具有说明性的错误信息。 ## 参与其中 加入 [Tulip Community](https://community.tulip.co/) ,提出问题、分享解决方案,并向其他开发者学习。