开始使用

在需要调用 JS SDK 的页面<head>标签引入如下 JS 文件：

{{ 'jssdk-x.x.x.min.js' | global_asset_url | js_tag }}  // 请自行替换 x.x.x 为最新版本

JS SDK 正确加载后，会在 window 对象下加入一个全局对象 yhsd

可以使用如下脚本验证是否正确引用：

<script>
    yhsd.version();  // 返回版本号即为加载成功
</script>

<script>
    yhsd.ready(function(jssdk){
        jssdk.account.current(function(){
            // 检查当前登录账号
        });
    });
</script>

全局对象yhsd下包含以下几类接口：

实用工具 - 常用方法的集合，包括设置获取 Cookie，设置获取 URL 参数等方法等；查看详情
数据接口 - 基于店铺 AJAX API 封装的接口，用于前端获取数据（如：查看购物车，商品列表，轻博客内容）和提交数据（如：用户注册，收货人信息维护，修改购物车等）；查看详情
注：JS SDK 中，与 Liquid 模板输出数据一致的对象，其文档将会跳转至主题开发 -> 语法与对象章节，方便对照查看并确保数据一致；
事件接口 - 基于订阅 / 发布模式封装的接口，用于开发者自定义流程，或者修改、重写原有接口（上一点提到的数据接口）逻辑。查看详情

请在引用 JS SDK 前，声明全局变量yhsdDebug打开事件调试信息，如：

<script>
    window.yhsdDebug = true;  // 调试信息开关
</script>
{{ 'jssdk-x.x.x.min.js' | global_asset_url | js_tag }}  // 请自行替换 x.x.x 为最新版本

主题开发