框架补充文档
框架与设计思路与文档
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 {
// 非会员
}
四、视觉设计规范
- 色彩:文字,边框,背景
#333,边框#ddd,背景#fff - 间距:使用8 的倍数(8px、16px、24px)
- 字体:从Google Fonts 引入
- Logo:优雅手写风字体,22px
- 标题:衬线字体(易读、正式)
- 正文:易读衬线,16px,行高1.6
- 导航:15px,
#666
- 圆角:统一
6px - 原则:留白> 装饰,禁用emoji,少用图片,Logo 用文字不用图片