框架补充文档

框架与设计思路与文档

ShipLang 多语言下拉框

多语言列表储存在,根目录[index.php]名为[$qx_lang]变量中

其中[English|1],|1代表显示该语言,|0代表存在该语言但不显示

多语言下拉框会自动载入,其详细设计细节在通用提示词中

提示词补充部分

一、JS 编写规范

禁用jQuery、箭头函数简写、自执行函数。

二、多语言翻译

2.3 动态文本翻译标记(谨慎使用)

<span id="g">测试</span>
<div style="display:none"><!-- 隐藏翻译字典 -->
  <span data-i18n="哈喽">hello</span>
  <span data-i18n="不错">good</span>
</div>
<script>
  // JS里写中文,系统自动查字典翻译
  alert('哈喽'); // 自动读取翻译为 hello
  document.getElementById('g').textContent = '不错'; // 自动替换成 good
</script>
⚠️ 注意:只在必须用JS 动态显示时才这样做,非必要尽可能少使用JS。

2.4 多语言页面跳转(需保持当前语言)

<!-- HTML 跳转,系统自动处理,直接写相对路径即可 -->
<a href="/home" data-i18n="h">首页</a>
<!-- 当前中文页 → /zh/home -->
<!-- 当前英文页 → /en/home -->
// JS 跳转,需手动拼接语言代码
window.location.href = '/' + document.documentElement.lang + '/about';
// 当前中文页 → /zh/about
// 当前英文页 → /en/about

三、支付与登录

登录与支付为非必须功能,只有用户明确要求时才接入。需用户说明在什么情况下显示登录和支付、触发条件是什么。如果描述不够完整,可以选择暂不加入。

window.Login_ShipLang();   // 拉起登录

window.OpenPay_ShipLang(); // 拉起支付

if (window.IsPay_ShipLang()) {
    // 是会员
} else {
    // 非会员
}

四、视觉设计规范