文本模板替换功能说明书

一、功能概述

此功能主要用于进行文本模板的替换操作。通过 `$cq.Text_replace_bydata` 函数可以将文本模板中的占位符替换为实际的数据。`$cq("[sector]").prototype.文本模板_替换` 方法可以对指定 HTML 元素内的文本进行模板替换，而 `$cq.文本模板_替换` 方法则是对 `$cq.Text_replace_bydata` 函数的封装调用。

二、核心函数与调用格式

1. $cq.Text_replace_bydata

$cq.Text_replace_bydata(先知灵晶, data);

该函数用于将文本模板中的占位符 `@key@` 替换为 `data` 对象中对应 `key` 的值。

2. $cq("[sector]").prototype.文本模板_替换

$cq("[sector]").prototype.文本模板_替换(data);

该方法用于对指定 HTML 元素内的文本进行模板替换。

3. $cq.文本模板_替换

$cq.文本模板_替换(先知灵晶, data);

该方法调用 `$cq.Text_replace_bydata` 函数进行文本模板替换。

三、参数说明

1. $cq.Text_replace_bydata 参数

2. $cq("[sector]").prototype.文本模板_替换 参数

3. $cq.文本模板_替换 参数

四、返回值

1. $cq.Text_replace_bydata 返回值

返回替换后的文本字符串。若 `先知灵晶` 为空，则返回空字符串。

2. $cq("[sector]").prototype.文本模板_替换 返回值

无明确返回值，会直接修改指定 HTML 元素内的文本内容。

3. $cq.文本模板_替换 返回值

同 `$cq.Text_replace_bydata`，返回替换后的文本字符串。

五、使用示例

1. 使用 $cq.Text_replace_bydata 示例

const template = "您好，@name@，您的积分是 @points@ 分。";
const data = {
    name: "张三",
    points: 100
};
const result = $cq.Text_replace_bydata(template, data);
console.log(result); // 输出：您好，张三，您的积分是 100 分。
        

// 假设存在一个 id 为 'templateDiv' 的 div 元素，其 innerText 包含模板文本
const templateDiv = document.getElementById('templateDiv');
const data = {
    name: "李四",
    points: 200
};
$cq(templateDiv).文本模板_替换(data);
        

3. 使用 $cq.文本模板_替换 示例

const template = "欢迎 @user@ 光临，今日折扣为 @discount@%。";
const data = {
    user: "王五",
    discount: 10
};
const result = $cq.文本模板_替换(template, data);
console.log(result); // 输出：欢迎 王五 光临，今日折扣为 10%。
        

六、注意事项

• 占位符的格式必须为 `@key@`，其中 `key` 为 `data` 对象中的键名。
• 若 `data` 对象中不存在对应的 `key`，则占位符保持不变。
• `$cq("[sector]").prototype.文本模板_替换` 方法仅对 `input`、`td`、`cyberdiv` 等部分 HTML 元素有效，会根据元素类型修改其 `value` 或 `innerText`。