pantoken / packages/core/src / applyModify

函式: applyModify() ​

applyModify(value, modify): string | undefined

Beta（測試）

將 Tokens Studio 的 TokenModify 套用到具體的十六進位顏色。

參數 ​

value ​

string

modify ​

TokenModify

回傳 ​

string | undefined

修改後的顏色，或在 value 不是十六進位顏色時回傳 undefined（因此呼叫方可以退回為將修改器作為描述性資料保留）。

範例 ​

使變暗、變亮，以及加入透明度

ts
import { applyModify } from "@pantoken/core";

applyModify("#808080", { type: "darken", value: 0.5 });  // → "#404040"
applyModify("#808080", { type: "lighten", value: 0.5 }); // → "#c0c0c0"
applyModify("#ffffff", { type: "alpha", value: 0.5 });   // → "#ffffff80"

非十六進位輸入與混合會回傳 undefined（作為描述性資料保留）

ts
import { applyModify } from "@pantoken/core";

applyModify("var(--x)", { type: "darken", value: 0.1 });        // → undefined
applyModify("#fff", { type: "mix", value: 0.5, color: "#000" }); // → undefined