语法指南 | 发明者量化

kpi

指标卡：醒目显示一个数值，可带单位、涨跌幅和说明，适合权益、收益率、最新价。

示例

用指标卡显示最新价，以及它相对开盘价的涨跌幅。


    javascript
    
    
function main() {
    var ticker = exchange.GetTicker()
    if (!ticker) return
    var change = ticker.Open > 0 ? (ticker.Last / ticker.Open - 1) * 100 : 0
    LogStatus({type: "kpi", title: "最新价", value: ticker.Last,
        delta: change, hint: "相对开盘价"})
}


    python
    
    
def main():
    ticker = exchange.GetTicker()
    if not ticker:
        return
    change = (ticker["Last"] / ticker["Open"] - 1) * 100 if ticker["Open"] > 0 else 0
    LogStatus({"type": "kpi", "title": "最新价", "value": ticker["Last"],
               "delta": change, "hint": "相对开盘价"})


    rust
    
    
fn main() {
    let Ok(t) = exchange.GetTicker(None) else { return };
    let change = if t.Open > 0.0 { (t.Last / t.Open - 1.0) * 100.0 } else { 0.0 };
    LogStatus!(format!(
        r#"{{"type": "kpi", "title": "最新价", "value": {}, "delta": {}, "hint": "相对开盘价"}}"#,
        t.Last, change
    ));
}

属性

名称	类型	描述
type	string	必填，固定为 `kpi`。
value	number / string	必填。显示的数值：数字按 `format` 格式化，字符串原样显示。
unit	string	单位，显示在数值后面。
delta	number	变化量：正数显示涨色 ▲，负数显示跌色 ▼，保留 2 位小数。
deltaUnit	string	`delta` 的单位。默认 `%`。
format	object	数值格式 `{precision, compact, percent}`，见`状态栏组件`。
color	string	颜色：`up`、`down`、`primary`、`warning`、`muted`，见`状态栏组件`。
hint	string	数值下方的补充说明。
title	string	标题，显示在组件左上角。
id	string	稳定标识。组件的个数或顺序会变化时设置，状态栏刷新时组件不重建。
span	number	在所在`grid`中占几列。默认 `1`。

参考

LogStatus 状态栏组件 stat sparkline

备注

delta 写变化量本身，不是比例：涨 3.2% 写 3.2。value 用 format.percent 显示百分比时传比例（0.032）。