saleAttent——关注方法API

一、方法简介及使用说明

• 简介：在活动装修平台和店铺装修平台中，都会用到关注活动、关注店铺、关注商品及关注品牌的功能，为此统一封装了这个公共方法；
• 使用说明：参照下方的方法示例，在html结构中加上合适的结构即可；

二、使用限制

• 限制平台：活动装修PC版、店铺装修PC版

三、接口、接口人、接口文档等

• 关注活动、店铺、商品接口：//follow-soa.jd.com/rpc/
• 关注品牌接口：//follow-soa.jd.com/rest/
• 接口人：品牌：王晓聪（wangxiaocong@jd.com 18612072174）、其他：吴劲平（wujinping1@jd.com 18600202812）
• 接口文档：//cf.jd.com/pages/viewpage.action?pageId=54169396

四、方法实现

• 此方法封装了目前京东在用的4种关注类型（关注活动、店铺、商品、品牌），根据不同参数区分；
• 此方法封装了3种展示效果：1、所有关注状态；2、关注和取消关注；3、默默关注，
• 第一种“所有关注状态”，有关注成功、已经关注、关注失败等等所有状态效果；
• 第二种“关注和取消关注”会获取用户关注初始化状态，如果用户已经关注，则会给节点增加一个样式“current”，方便用户开发显示效果，并且文案也会替换为“已经关注”；
• 第三种“默默关注”，不会有任何效果，相当于隐藏了第一种的所有提示弹出框；
• 示例效果：//sale.jd.com/act/qiUJPNHTvfb.html

五、参数说明

• attentType : ‘activity’, //关注的ID类型：activity（活动）、vender（店铺）、product（商品）、brand（品牌）
• activityType : 1, //当关注的ID类型是活动时，必须传此值；0采销，1店铺活动，活动关注参数srcType
• node : ‘.e-attention’, //关注点击元素
• dataId : ‘data-id’,//（节点伪属性，将活动ID保存在此）
• dataState : ‘data-state’, //临时状态data-state ：0未关注；1关注成功；2已经关注；3关注数量达到上限；4关注失败
• dataType : ‘data-type’,//获取点击元素上的功能类型 0：所有状态+弹出层；1：关注和取消关注+修改按钮文案+关注成功弹出层；2：默默关注
• current : ‘current’, //已经关注样式名，初始化关注状态时，如果已经关注过的，则默认加上此样式

三、方法使用示例

1、关注活动

• 1）所有关注状态（常用）
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'activity',activityType:0}"> <a href="javascript:;" class="e-attention" data-id="375518" data-state="0" data-type="0" >关注活动dataType0</a></div>

• 2）关注和取消关注（常用）
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'activity',activityType:0}"> <a href="javascript:;" class="e-attention" data-id="347583" data-state="0" data-type="1" >关注活动dataType1</a></div>

• 3）默默关注
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'activity',activityType:0}"> <a href="javascript:;" class="e-attention" data-id="361490" data-state="0" data-type="2" >关注活动dataType2</a> </div>

• 4）调用多个关注
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'activity',activityType:0}"> <a href="javascript:;" class="e-attention" data-id="375518" data-state="0" data-type="0" >关注活动dataType0</a> <a href="javascript:;" class="e-attention" data-id="347583" data-state="0" data-type="1" >关注活动dataType1</a> <a href="javascript:;" class="e-attention" data-id="361490" data-state="0" data-type="2" >关注活动dataType2</a> </div>

2、关注店铺

• 1）所有关注状态（常用）
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'vender'}"> <a href="javascript:;" class="e-attention" data-id="15706" data-state="0" data-type="0">关注店铺dataType0</a></div>

• 2）关注和取消关注（常用）
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'vender'}"> <a href="javascript:;" class="e-attention" data-id="1000001952" data-state="0" data-type="1">关注店铺dataType1</a></div>

• 3）默默关注
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'vender'> <a href="javascript:;" class="e-attention" data-id="1000003243" data-state="0" data-type="2">关注店铺dataType2</a></div>

• 4）调用多个关注
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'vender'}"> <a href="javascript:;" class="e-attention" data-id="15706" data-state="0" data-type="0">关注店铺dataType0</a> <a href="javascript:;" class="e-attention" data-id="1000001952" data-state="0" data-type="1">关注店铺dataType1</a> <a href="javascript:;" class="e-attention" data-id="1000003243" data-state="0" data-type="2">关注店铺dataType2</a></div>

3、关注商品

• 1）所有关注状态（常用）
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'product'}"> <a href="javascript:;" class="e-attention" data-id="1178714" data-state="0" data-type="0">关注商品dataType0</a></div>

• 2）关注和取消关注（常用）
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'product'}"> <a href="javascript:;" class="e-attention" data-id="1627151532" data-state="0" data-type="1">关注商品dataType1</a></div>

• 3）默默关注
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'product'> <a href="javascript:;" class="e-attention" data-id="1797751" data-state="0" data-type="2">关注商品dataType2</a> </div>

• 4）调用多个关注
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'product'}"> <a href="javascript:;" class="e-attention" data-id="1178714" data-state="0" data-type="0">关注商品dataType0</a> <a href="javascript:;" class="e-attention" data-id="1627151532" data-state="0" data-type="1">关注商品dataType1</a> <a href="javascript:;" class="e-attention" data-id="1797751" data-state="0" data-type="2">关注商品dataType2</a> </div>

4、关注品牌（主品牌和子品牌）20160505 add

• 1）所有关注状态（常用）
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'brand'}"> <a href="javascript:;" class="e-attention" data-id="9452" data-state="0" data-type="0" >关注主品牌dataType0</a></div>

• 2）关注和取消关注（限主品牌，因为批量查询用户关注子品牌状态接口缺失）
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'brand'}"> <a href="javascript:;" class="e-attention" data-id="78" data-state="0" data-type="1" >关注主品牌dataType1</a></div>

• 3）默默关注
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'brand'> <a href="javascript:;" class="e-attention" data-id="65" data-state="0" data-type="2" >关注主品牌dataType2</a> </div>

• 4）调用多个关注
  <div class="j-module" module-function="saleAttent" module-param="{attentType:'brand'}"> <a href="javascript:;" class="e-attention" data-id="9452" data-state="0" data-type="0" >关注主品牌dataType0</a> <a href="javascript:;" class="e-attention" data-id="78" data-state="0" data-type="1" >关注主品牌dataType1</a> <a href="javascript:;" class="e-attention" data-id="65" data-state="0" data-type="2" >关注主品牌dataType2</a> </div></div>