调用三方库教程：以 `lv-markdown-in`为例

调用三方库教程：以 lv-markdown-in为例

简介

本教程旨在指导如何在HarmonyOS系统中集成并使用第三方库 lv-markdown-in，这是一款专为鸿蒙系统设计的Markdown解析预览库。lv-markdown-in支持纯文本、资源文件及沙箱文件三种内容加载模式，并兼容API 9（1.x.x版本）及API 10及以上（2.x.x版本）的HarmonyOS环境。

安装与引入三方库

1. 安装 lv-markdown-in

在项目根目录下，通过以下命令安装 lv-markdown-in库：

bash复制代码ohpm install @luvi/lv-markdown-in

2. 引入插件

在需要使用Markdown解析预览功能的JavaScript文件中，引入 lv-markdown-in：

javascript复制代码import { lvMarkdownIn } from '@luvi/lv-markdown-in';

3. 使用库函数

利用 lvMarkdownIn函数解析Markdown文本内容：

javascript复制代码const content = "这里是你的Markdown文本内容";lvMarkdownIn({ text: content.toString() });

内容加载模式详解

1. 纯文本模式

默认模式，无需额外指定 loadMode。可通过 text字段传递Markdown文本内容。

javascript复制代码lvMarkdownIn({    text: content.toString(),    loadCallBack: {        success(r) {            console.log("Markdown解析成功: " + r.message);        },        fail(r) {            console.error("Markdown解析失败: " + r.message);        }    }});

2. 资源文件模式

设置 loadMode为 rawfile，并指定 rawfilePath为模块中 rawfile目录的文件路径。需传递应用上下文 context。

3. 沙箱文件模式

设置 loadMode为 sandbox，适用于从沙箱文件系统加载Markdown文件。

样式自定义

超链接样式（lvLink）

javascript复制代码import { lvLink } from '@luvi/lv-markdown-in';lvLink.setTextSize(20);            // 设置字体大小为20lvLink.setTextColor("red");        // 设置文本颜色为红色lvLink.setTextUnderline(true);     // 启用文本下划线

图片样式（lvImage）

javascript复制代码import { lvImage } from '@luvi/lv-markdown-in';lvImage.setImgWidth("70%");        // 设置图片宽度为容器宽度的70%lvImage.setImgHeight(null);        // 不限制图片高度lvImage.setConfGlobal(true);       // 强制应用全局宽高设置

代码块样式（lvCode）

javascript复制代码import { lvCode } from '@luvi/lv-markdown-in';lvCode.setTheme("dark");           // 设置代码块主题为暗色lvCode.setIndexState(true);        // 显示代码块行号

遵循以上步骤，你将能够成功在HarmonyOS项目中集成 lv-markdown-in库，实现Markdown内容的解析与预览功能。