我们都知道用 title
可以给脚本定一个完整的官方名称,但有时候,这个名字太长了,放在图表上会显得很拥挤,特别是当你同时加载好几个指标的时候。
为了解决这个问题,Pine Script提供了一个很贴心的参数:shorttitle
。它允许我们为指标或策略设置一个更简短、更清爽的“小名”或“缩写”,专门用于图表显示。
基础用法
给脚本设置短名称很简单,只需要在 indicator()
或 strategy()
函数里,添加 shorttitle
参数,并赋给它一个用双引号括起来的文本就行。
对于指标,可以这样写:
//@version=6
indicator(title="我的指标脚本", shorttitle="MIS")
对于策略,也是同理:
//@version=6
strategy(title="我的策略脚本", shorttitle="MSS")
和 title
一样,shorttitle=
这个关键字本身也可以省略,只要你保证参数的顺序是正确的(第一个是 title
,第二个是 shorttitle
),代码依然有效:
//@version=6
indicator("我的指标脚本", "MIS")
不过,从代码的可读性和长期维护的角度出发,我还是强烈建议你把 title=
和 shorttitle=
这两个关键字都明确地写出来。这样,任何人(包括未来的你)都能一眼看懂每个参数的用途。
shorttitle
的特性和注意事项
必须是固定字符串:它的值必须是写死的文本,不能用变量来动态生成。
可选参数:shorttitle
不是必需的。如果你不设置它,脚本就会默认使用 title
作为显示名称。一旦设置了,它就会在图表的大多数地方取代 title
。
设为空字符串会怎样?如果你把 shorttitle
设置为空字符串(""
),Pine Script会很智能地忽略它,并自动退回使用 title
的完整名称来显示。
长度限制:shorttitle
本身没有严格的长度限制,但它的“老大哥” title
有128个字符的上限。从实践角度出发,既然是“短标题”,就应该让它足够短小精悍,通常几个字母的缩写就足够了。
一个替代思路:如果你觉得脚本的 title
太长,除了用 shorttitle
之外,也可以直接从源头上把 title
本身就取得简洁一些。这样可以避免维护两个不同的名字。
只能通过代码设置:和 title
一样,短名称也只能在脚本代码里进行设置。
shorttitle
会出现在什么地方
设置好 shorttitle
后,这个简洁的名称会出现在用户界面的多个关键位置,取代完整的 title
:
- 图表左上角的图例中。
- 图表右侧的“数据窗口”。
- 脚本的“设置”窗口。
- “创建警报”窗口。
但有一个主要的例外:在策略的“策略测试器”窗口中,通常还是会显示策略原始的 title
全称,而不是 shorttitle
。
另外当你公开发布脚本时,shorttitle
会被用作发布作品的标题。
实战演示
下面的指标脚本计算的是价格动量。我们给它设置一个完整的 title
叫 “My Momentum Script”,同时用 shorttitle
给它一个简洁的缩写 “MOS”。
完整代码如下:
//@version=6
indicator(title="My Momentum Script", shorttitle="MOS")
plot(ta.mom(close, 8), color=color.purple, title="Momentum")
当我们把这个脚本加载到图表上,立刻就能看到清爽的短名称“MOS”:
这个缩写同样也显示在图表右侧的“数据窗口”中:
打开脚本的设置窗口,标题也是这个短名称:
在创建警报时,你选择的指标条件也是这个简洁的“MOS”:
通过这个小小的 shorttitle
参数,我们既保留了脚本信息的完整性(通过 title
),又极大地优化了图表的视觉整洁度,让交易界面更加专业和高效。