# MathView

**Repository Path**: chinasoft4_ohos/MathView

## Basic Information

- **Project Name**: MathView
- **Description**: 使用Webview展示数学公式
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2021-08-11
- **Last Updated**: 2021-09-28

## Categories & Tags

**Categories**: charting-components

**Tags**: None

## README

# MathView

#### 项目介绍
- 项目名称：MathView
- 所属系列：openharmony的第三方组件适配移植
- 功能：使用Webview展示数学公式
- 项目移植状态：主功能完成
- 调用差异：无
- 开发版本：sdk6，DevEco Studio 2.2 Beta1
- 基线版本：master分支

#### 效果演示
<img src="gif/show.gif"></img>

#### 安装教程
                                
1.在项目根目录下的build.gradle文件中，
 ```gradle
	allprojects {
	    repositories {
	        maven {
	            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
	        }
	    }
	}
 ```
2.在entry模块的build.gradle文件中，
 ```gradle
	dependencies {
	   implementation('com.gitee.chinasoft_ohos:MathView_library:1.0.0')
	   ......  
	}
 ```

在sdk6，DevEco Studio 2.2 Beta1下项目可直接运行
如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件，
并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

#### 使用说明
1. MathView在布局文件中定义:
	```java
        <Text
            ohos:width="match_parent"
            ohos:height="match_content"
            ohos:text="Formula one: from xml with MathJax"
            ohos:text_weight="700"
            ohos:text_color="#999999"
            ohos:text_size="14fp"
            ohos:left_margin="16vp"
            ohos:right_margin="16vp"/>

        <io.github.kexanie.library.MathView
            ohos:id="$+id:formula_one"
            ohos:width="match_parent"
            ohos:left_margin="16vp"
            ohos:right_margin="16vp"
            ohos:height="120vp"
            ohos:top_margin="5vp"
            app:text="When \(a \ne 0\), there are two solutions to \(ax^2 + bx + c = 0\)
                and they are $$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$"
            app:engine="MathJax">

        </io.github.kexanie.library.MathView>
	```

2. 在Ability中获取实例中获取:
	```java
	    String tex = "This come from string. You can insert inline formula:"
                + " \\(ax^2 + bx + c = 0\\) "
                + "or displayed formula: $$\\sum_{i=0}^n i^2 = \\frac{(n^2+n)(2n+1)}{6}$$";
        formulaTwo = (MathView) findComponentById(ResourceTable.Id_formula_two);
        formulaTwo.setText(tex);
	```

3. 注意事项
    原库采用的是webview加载html字符串的方式展示数学公式，因openHarmony不支持html字符串里访问本地js文件，故实现方式改为混合开发模式，即java代码中调用js代码，动态改变本地html的内容，展示本地html

#### 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异

#### 版本迭代

- 1.0.0

#### 版权和许可信息

Apache License 2.0