Meta 标签
在您的 <head> 标签内,<meta> 标签提供标题和发布者信息,并使我们能够接收用户输入。有六种用户可自定义的控件:数字滑块、色相滑块、布尔开关、颜色选择器、文本字段和下拉框。每个控件都需要四个核心属性,以及控件特定的属性。
| 核心属性 | 描述 | |
|---|---|---|
| property | 定义在代码中使用的变量名 | |
| label | 显示给用户的控件界面文本标签 | |
| type | 指定数据类型:number、hue、boolean 或 color | |
| default | 设置控件使用的初始值 | |
| tooltip* | (*可选)当用户悬停在控件上时显示简短描述 |
数字滑块使用户可以在特定范围内选择一个整数。它通常用于调整参数,例如动画运行速度、屏幕上出现的形状数量或效果触发频率。
<meta property="myNum" label="Number Control" type="number" default="5" min="0" max="10">实际效果如下:

数字滑块需要两个额外属性才能正常工作:
| 属性 | 描述 |
|---|---|
| min | 设置用户可以选择的最低值。 |
| max | 设置用户可以选择的最高值。 |
色相滑块让用户使用 HSL(色相、饱和度、亮度)颜色模型选择颜色色相。它通常用于基本颜色调整或为效果和元素选择基础颜色。
<meta property="myHuePicker" label="Hue Picker Control" type="hue" default="120" min="0" max="360">视觉效果如下:

要正常运行,色相滑块需要两个额外属性:
| 属性 | 描述 |
|---|---|
| min | 定义用户可以选择的最低色相值。最小可能值为 0 |
| max | 定义可用的最高色相值。最大可能值为 360 |
布尔开关让用户在两种状态之间切换:“开”和”关”。其值仅限于 0(关)或 1(开)。与其他控件不同,布尔仅依赖默认属性,不需要任何额外配置。
<meta property="myBool" label="Boolean Control" type="boolean" default="0"/>它们通常用于启用或禁用特定功能、在模式之间切换(如垂直和水平)、控制界面中的可见性和行为切换,或触发效果重播。
以下是它显示的示例:

颜色选择器使用户能够通过在标准 HSL 颜色模型中调整色相、饱和度和亮度组件来选择颜色。它是用于选择颜色(无论是背景还是屏幕元素)的最常见和标准的工具。
<meta property="myColorpicker1" label="Colorpicker Control" type="color" default="#009bde" min="0" max="360"/>视觉效果如下:

颜色选择器的默认值必须以十六进制格式指定。此外,它需要两个额外属性:
| 属性 | 描述 |
|---|---|
| min | 最小可选值,最低可能值为 0。 |
| max | 最大可选值,最高可能值为 360。 |
文本字段(或文本输入框)允许用户输入字符字符串。每次在字段中添加或删除字符时,输入都会更新。
<meta property="myText" label="Text Field" type="textfield" default="yourText">效果如下:

| 属性 | 描述 |
|---|---|
| default | 可以不包含任何字符 |
列表让用户从预定义的值列表中选择一个选项。例如,用户可以在不同的角色选择或效果之间切换,以选择他们喜欢的选项。
<meta property="effectChoice" label="Effect Choice" type="list" values="Low Health,Option1,Option2,Option3" default="Low Health"/>实际效果如下:

values 属性定义所有可用选项,而 default 属性指定最初选择的选项。
| 属性 | 描述 |
|---|---|
| values | 以逗号分隔的可能字符串选项列表 |
| default | 设置默认选择的选项。如果此值未包含在 values 列表中,下拉框将不显示默认选择,可能会导致问题。 |
有关从应用程序收集原始数据的更多信息,请查阅我们的智能标签页面!