MNComment
MNComment是用于处理卡片评论的对象,提供评论类型识别、内容读取、媒体数据获取和链接管理等功能,访问和管理评论数据。
new MNComment(comment: NoteComment)构造一个新的MNComment实例。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
comment | NoteComment | 是 | 原生评论对象。 |
类成员(Class members)
Section titled “类成员(Class members)”无。
commentBelongsToType
Section titled “commentBelongsToType”static commentBelongsToType(comment: NoteComment,types: string[]): boolean判断评论是否属于给定类型集合,支持原始comment.type和标准化类型名两种匹配。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
comment | NoteComment | 是 | 原生评论对象。 |
types | string[] | 是 | 允许的类型列表,支持原始type和规范化type。 |
- 类型:
boolean - 语义:命中任一类型返回true,没有命中返回false。
getCommentType
Section titled “getCommentType”static getCommentType(comment: NoteComment): string|undefined根据评论内容和原始type返回标准化评论类型。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
comment | NoteComment | 是 | 待识别的评论对象。 |
- 类型:
string|undefined - 语义:返回规范化类型字符串,无法识别时返回undefined。
实例成员(Instance members)
Section titled “实例成员(Instance members)”imageId
Section titled “imageId”get imageId(): string|undefined返回图片评论对应的媒体hash。
- 类型:
string|undefined - 语义:图片型评论返回媒体hash,非图片型返回undefined。
imageData
Section titled “imageData”get imageData(): NSData|undefined返回图片评论对应的媒体二进制数据。
- 类型:
NSData|undefined - 语义:图片型评论返回图片二进制数据,其他类型返回undefined。
videoId
Section titled “videoId”get videoId(): string|undefined返回音视频评论对应的媒体hash。
- 类型:
string|undefined - 语义:audioComment返回hash,其他类型返回undefined。
audioId
Section titled “audioId”get audioId(): string|undefined返回音频评论对应的媒体hash。
- 类型:
string|undefined - 语义:audioComment返回hash,其他类型返回undefined。
audioData
Section titled “audioData”get audioData(): NSData|undefined返回音频评论对应的媒体二进制数据。
- 类型:
NSData|undefined - 语义:audioComment返回媒体数据,其他类型返回undefined。
videoData
Section titled “videoData”get videoData(): NSData|undefined返回音视频评论对应的媒体二进制数据。
- 类型:
NSData|undefined - 语义:audioComment返回媒体数据,其他类型返回undefined。
get text(): string返回当前评论的文本内容。
- 类型:
string - 语义:有文本时返回文本,没有可用文本时返回空字符串。
markdown
Section titled “markdown”get markdown(): boolean判断当前评论是否为Markdown评论。
- 类型:
boolean - 语义:类型为markdownComment时返回true,否则返回false。
markdown
Section titled “markdown”set markdown(markdown: boolean): void在普通文本评论和Markdown评论之间切换。
- 类型:
void - 语义:完成切换后立即返回。
set text(text: string): void更新当前评论文本,并同步写回原始卡片评论。
- 类型:
void - 语义:写入完成后立即返回。
get tags(): string[]|undefined返回标签评论中的标签列表。
- 类型:
string[]|undefined - 语义:tagComment返回以#开头的标签列表,其他类型返回undefined。
direction
Section titled “direction”get direction(): 'one-way'|'both'|undefined返回链接评论的链接方向。
- 类型:
'one-way'|'both'|undefined - 语义:linkComment返回方向值,其他类型返回undefined。
direction
Section titled “direction”set direction(direction: 'one-way'|'both'): void设置链接评论方向,并同步处理反向链接。
- 类型:
void - 语义:执行方向切换后返回。
get note(): MNNote|undefined返回链接或留白评论关联的目标卡片。
- 类型:
MNNote|undefined - 语义:可解析时返回MNNote实例,无法关联卡片时返回undefined。
refresh
Section titled “refresh”refresh(): void按originalNoteId和index重新读取评论内容并刷新类型。
无。
- 类型:
void - 语义:同步完成后返回。
copyImage
Section titled “copyImage”copyImage(): void复制当前评论对应的图片数据到剪贴板。
无。
- 类型:
void - 语义:复制动作触发后立即返回。
copyText
Section titled “copyText”copyText(): void复制当前评论文本到剪贴板。
无。
- 类型:
void - 语义:复制动作触发后立即返回。
copy(): void按评论类型自动复制文本或图片内容。
无。
- 类型:
void - 语义:复制动作触发后立即返回。
remove
Section titled “remove”remove(): void从原始卡片中删除当前评论。
无。
- 类型:
void - 语义:删除动作发起后返回。
replaceLink
Section titled “replaceLink”replaceLink(note: MNNote|MbBookNote|string): void将链接评论目标替换为指定卡片,并根据方向维护反向链接。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
note | MNNote|MbBookNote|string | 是 | 目标卡片。 |
- 类型:
void - 语义:替换完成后返回。
hasBackLink
Section titled “hasBackLink”hasBackLink(): boolean检查当前链接评论是否存在反向链接。
无。
- 类型:
boolean - 语义:存在反链返回true,不存在返回false。
removeBackLink
Section titled “removeBackLink”removeBackLink(): void移除当前链接评论对应的反向链接。
无。
- 类型:
void - 语义:反链删除完成后返回。
addBackLink
Section titled “addBackLink”addBackLink(force: boolean): void为当前链接评论补充反向链接。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
force | boolean | 否 | 为true时忽略当前direction,强制尝试补反链。 |
- 类型:
void - 语义:补反链动作完成后返回。
belongsToType
Section titled “belongsToType”belongsToType(types: string[]): boolean判断当前评论实例是否命中类型列表。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
types | string[] | 是 | 允许的类型列表。 |
- 类型:
boolean - 语义:实例类型命中列表返回true,否则返回false。