mdReader

来自于:官方立即使用

open setPath show hide close

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。

概述

mdReader 封装了一个简单的 markdown 阅读器,可将 markdown 格式的文件读取显示出来,开发者可自定义显示区域及显示区域的背景。本模块暂仅支持读取纯 markdown 文本,不能识别混合 html 标签的 markdown 文本

open

打开一个 markdown 格式的文档

open({params})

params

rect:

  • 类型:JSON 对象
  • 描述:(可选项)模块的位置及尺寸
  • 内部字段:
  1. {
  2. x: 0, //(可选项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:0
  3. y: 0, //(可选项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0
  4. w: 320, //(可选项)数字类型;模块的宽度;默认:所属的 Window 或 Frame 的宽度
  5. h: 300 //(可选项)数字类型;模块的高度;默认:所属的 Window 或 Frame 的高度
  6. }

styles:

  • 类型:JSON 对象
  • 描述:(可选项)模块的样式
  • 内部字段:
  1. {
  2. bg: 'rgba(0,0,0,0)' //(可选项)字符串类型;日历整体背景,支持 rgb、rgba、#、图片路径,要求本地路径(fs://、widget://);默认:'rgba(0,0,0,0)'
  3. }

path:

  • 类型:字符串
  • 描述:文档的路径,要求本地路径(fs://、widget://)

fixedOn:

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

fixed:

  • 类型:布尔
  • 描述:(可选项)模块是否随所属 window 或 frame 滚动
  • 默认值:true(不随之滚动)

示例代码

  1. var mdReader = api.require('mdReader');
  2. mdReader.open({
  3. path: 'widget://res/test.md',
  4. rect: {
  5. x: 0,
  6. y: 0,
  7. w: api.winWidth,
  8. h: api.frameHeight
  9. },
  10. styles: {
  11. bg: '#eee'
  12. },
  13. fixedOn: api.frameName,
  14. fixed: false
  15. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setPath

设置阅读器的文件路径

setPath({params})

params

path:

  • 类型:字符串
  • 描述:文档的路径,要求本地路径(fs://、widget://)

示例代码

  1. var mdReader = api.require('mdReader');
  2. mdReader.setPath({
  3. path: 'widget://md.md'
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示阅读器

show()

示例代码

  1. var mdReader = api.require('mdReader');
  2. mdReader.show();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏阅读器

hide()

示例代码

  1. var mdReader = api.require('mdReader');
  2. mdReader.hide();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭阅读器

close()

示例代码

  1. var mdReader = api.require('mdReader');
  2. mdReader.close();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。