本文共 566 字，大约阅读时间需要 1 分钟。

在Confluence编辑器中，通过配置宏参数属性，您可以精确控制宏占位符显示的内容，从而为编辑者提供更清晰的信息。默认情况下，宏占位符会尽可能显示所有有定义的参数值，这有助于用户快速了解宏的使用情况。

为了让宏占位符显示最有用的信息，您可以设置参数属性来控制显示的内容。例如，在一个包含两个参数（title和icon）的经过宏中，您可以选择只显示title参数的值。这样不仅简化了占位符的显示，也让编辑者更容易理解宏的使用方式。

假设您创建了一个警告宏，并为其设置了title参数。例如，您将标题设置为"The title of the warning"。在编辑器中，宏占位符将显示相应的标题信息，而不是完整的参数名称和值。

要实现这一点，您需要在宏模板中添加@param属性，并配置相关参数属性。例如，在title参数中，您可以设置以下属性：

• showNameInPlaceholder：控制参数名称在占位符中的显示。
• showValueInPlaceholder：控制参数值在占位符中的显示。

如果某个参数没有设置上述属性，占位符将默认显示完整的参数名称和值。只有当至少一个参数设置了属性时，其他不设置属性的参数才会隐藏显示。

通过合理配置参数属性，您可以根据具体需求调整宏占位符的显示内容，从而为编辑者提供更直观的信息支持。

转载地址：http://gnmd.baihongyu.com/