shareAction

来自于:官方立即使用

概述

shareAction 是一个调用系统分享功能的模块,通过该模块能够分享一些最常见的文本,图片信息等

share

打开分享对话框

share({params})

params

text:

  • 类型:字符串
  • 描述:(可选项)要分享的文本信息

type:

  • 类型:字符串
  • 描述:(可选项)分享文件的类型(iOS系统微信不支持纯文字的分享)
  • 默认值:text
  • 取值范围:
    • text //纯文本
    • image //图片
    • audio //音频文件
    • file //普通文件
    • url //网络连接

path:

  • 类型:字符串
  • 描述:(可选项)要分享的路径,若是‘file’或‘audio’类型,要求本地路径(fs://、widget://),若是url类型,需要有效的网址。若 images 不为空则模块忽略本参数。Android 平台不支持 widget:// 路径

images:

  • 类型:数组
  • 描述:(可选项)分享的图片路径组成的数组,仅当 type 为 image 时有效;要求本地路径(fs://、widget://)。若本参数不为空则模块忽略 path 参数。仅支持 iOS 平台

thumbnail:

  • 类型:字符串
  • 描述:(可选项)分享时的缩略图;要求本地路径(fs://、widget://)。若不传则不显示。仅支持 iOS 平台

arrowRect:

  • 类型:JSON 对象
  • 描述:(可选项)iPad中显示时,箭头指向的位置,只iPad有效
  • 内部字段:
{
    x:0,                  //左上角x坐标,数字类型
    y:0,                  //左上角y坐标,数字类型
    w:0,                  //宽度,数字类型
    h:0,                  //高度,数字类型
}

arrowDirection:

  • 类型:字符串
  • 描述:(可选项)iPad中显示时,箭头指向的方向,只iPad有效
  • 默认值:any
  • 取值范围
    • left // 指向左边
    • right // 指向右边
    • up // 指向上边
    • down // 指向下边
    • any // 系统根据页面情况选择合适的方向

contentSize:

  • 类型:JSON 对象
  • 描述:(可选项)iPad中显示时,对话框大小,只iPad有效
  • 内部字段:
{
    w:0,                  //宽度,数字类型
    h:0                   //高度,数字类型
}

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

示例代码

var sharedModule = api.require('shareAction');
sharedModule.share({
    text: '纯文本信息',
    type: 'text'
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本