跳转到主要内容
Element 用来描述笔记文件(以及文档标注场景)中所有“可见元素”的共同信息:例如普通笔画、标题、链接、文本框、几何图形、图片等。 同一个 Element 会通过 type 来区分具体类别,并在对应类别下提供更细分的数据结构(例如 stroketitlelinktextBoxgeometrypicture)。
如果你只关心“元素是什么类型”,读取 type 即可;如果你要操作具体内容,再根据 type 去读取 stroke/title/link/textBox/geometry 等细分字段。

类型常量

元素类型常量(ElementType)用于标识 Element.type 的取值范围。

ElementType

下表中“常量”列省略了 ElementType. 前缀;在代码里使用时请补全为 ElementType.XXX
类型常量说明细分字段
笔画TYPE_STROKE0手写笔划:既能插入到主图层,也能插入到自定义图层,后续操作也都支持这两种层stroke
标题TYPE_TITLE100标题元素:只能在主图层插入和操作,其他层不允许title
图片TYPE_PICTURE200图片元素:既能插入到主图层,也能插入到自定义图层,后续操作也都支持这两种层picture
文本框TYPE_TEXT500普通文本框:既能插入到主图层,也能插入到自定义图层,后续操作也都支持这两种层textBox
摘录引用文本框TYPE_TEXT_DIGEST_QUOTE501引用摘录:只能在主图层插入和操作,其他层不允许textBox
摘录创建文本框TYPE_TEXT_DIGEST_CREATE502创建类摘录文本框:只能在主图层插入和操作,其他层不允许textBox
链接TYPE_LINK600文本链接/笔画链接:只能在主图层插入和操作,其他层不允许link
几何图形TYPE_GEO700几何图形:既能插入到主图层,也能插入到自定义图层,后续操作也都支持这两种层geometry
五角星TYPE_FIVE_STAR800五角星:只能在主图层插入和操作,其他层不允许fiveStar

字段

字段类型说明
uuidstring通用唯一识别码(元素唯一 ID)
typenumber元素类型,见 ElementType
pageNumnumber页码
layerNumnumber图层号(笔记中常见范围为 0..3
thicknessnumber笔划粗细(部分元素可能无意义)
recognizeResultRecogResultData识别结果数据
maxXnumberEMR坐标系中X轴的最大值,EMR坐标系详见坐标系这章
maxYnumberEMR坐标系中X轴的最大值,EMR坐标系详见坐标系这章
userDatastring用于存储用户数据
anglesElementDataAccessor<Point>角度点,数据量太大,RN端持有的是索引,原始数据存在Android端
statusnumber元素状态值
numInPagenumber元素在页内的序号(从 0 开始)
contoursSrcElementDataAccessor<Point[]>轮廓点(像素坐标),数据量太大,RN端持有的是索引,原始数据存在Android端
strokeStroke | null笔画数据(仅 type === 0 时存在)
titleTitle | null标题数据(仅 type === 100 时存在)
textBoxTextBox | null文本框数据(仅文本框相关类型时存在)
geometryGeometry | null几何图形数据(仅 type === 700 时存在)
linkLink | null链接数据(仅 type === 600 时存在)
fiveStarFiveStar | null五角星数据(仅 type === 800 时存在;见下方“FiveStar”)
picturePicture | null图片数据(仅 type === 200 时存在)
anglescontoursSrc 是访问器对象,不是完整数组。需要通过 size()/get()/getRange() 等方法异步取数,避免一次性把大规模点集传到 RN 端导致内存问题。

FiveStar(五角星)

type === 800 时,fiveStar 字段提供五角星点集。
字段类型说明
pointsPoint[]五角星点坐标(EMR 坐标)

方法

方法返回说明
recycle()Promise<void>回收该元素对应的原生缓存数据,并清理访问器缓存