Дополнительная документация к фреймворку

Структура, идеи дизайна и документация

Выпадающий многоязычный список ShipLang

Список многоязычных файлов хранится в переменной с именем [$qx_lang] в корневом каталоге [index.php].

В [English|1] |1 означает отображение языка, а |0 означает, что язык существует, но не отображается.

Многоязычные выпадающие списки загружаются автоматически; подробные параметры дизайна доступны в общих подсказках.

Дополнительные подсказки

I. Стандарты написания кода на JavaScript

Отключите jQuery, сокращения стрелочных функций и самоисполняющиеся функции.

II. Многоязычный перевод

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>
⚠️ Примечание:Используйте JavaScript только в тех случаях, когда это абсолютно необходимо для динамического отображения данных; применяйте JavaScript как можно реже, когда в этом нет необходимости.

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

III. Оплата и вход в систему

Вход в систему и оплата — необязательные функции; их следует интегрировать только по явному запросу пользователя. Пользователи должны указать условия, при которых должны отображаться данные для входа в систему и оплаты, а также факторы, запускающие эти процессы. Если описание неполное, пользователи могут отказаться от добавления этих функций на данном этапе.

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

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

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

IV. Рекомендации по визуальному дизайну