147 lines
4.6 KiB
TypeScript
147 lines
4.6 KiB
TypeScript
/**
|
|
* Collabora Online 高亮选中文本工具 (Python 脚本版本)
|
|
*
|
|
* 职责: 实现文本的搜索、高亮、跳转功能
|
|
*
|
|
* 核心改进:
|
|
* - 使用单个 Python 脚本替代低效的 UNO 命令链
|
|
* - 每次调用自动清除所有旧高亮 + 高亮新文本
|
|
* - Python 脚本高亮所有匹配文本后，使用 customGotoPage 跳转到指定页面
|
|
* - 性能提升 3-5 倍
|
|
*
|
|
* @encoding UTF-8
|
|
*/
|
|
|
|
import { callPythonScript, type ScriptResult } from '../CallCustomScript';
|
|
import { customGotoPage } from './gotoPage';
|
|
|
|
/**
|
|
* 高亮选项
|
|
*/
|
|
export interface HighlightOptions {
|
|
/** 高亮颜色 (LibreOffice Decimal 格式), 默认 16776960 = 黄色 */
|
|
color?: number;
|
|
/** 目标页码 (从1开始), 默认第1页 */
|
|
page?: number | null;
|
|
}
|
|
|
|
/**
|
|
* 高亮响应
|
|
*/
|
|
export interface HighlightResponse {
|
|
success: boolean;
|
|
message: string;
|
|
highlightedCount?: number;
|
|
page?: number | null;
|
|
timestamp: number;
|
|
}
|
|
|
|
/**
|
|
* 高亮文本并跳转到指定页面
|
|
*
|
|
* 此函数会：
|
|
* 1. 清除文档中所有相同颜色的旧高亮
|
|
* 2. 搜索并高亮新文本（整个文档）
|
|
* 3. 使用 customGotoPage 跳转到指定页面
|
|
*
|
|
* @param iframeWindow - Collabora iframe 的 contentWindow
|
|
* @param text - 要高亮的文本
|
|
* @param options - 可选配置
|
|
*
|
|
* @example
|
|
* // 首次高亮（默认在第1页）
|
|
* await highlightText(iframeWindow, '{乙方名称}');
|
|
*
|
|
* @example
|
|
* // 高亮下一个字段（自动清除上一个）
|
|
* await highlightText(iframeWindow, '{乙方法定代表人}');
|
|
*
|
|
* @example
|
|
* // 跳转到第2页并高亮
|
|
* await highlightText(iframeWindow, '{合同编号}', { page: 2 });
|
|
*
|
|
* @example
|
|
* // 使用自定义颜色
|
|
* await highlightText(iframeWindow, '{甲方名称}', { color: 0xFF00FF, page: 1 });
|
|
*/
|
|
export async function highlightText(
|
|
iframeWindow: Window,
|
|
text: string,
|
|
options?: HighlightOptions
|
|
): Promise<HighlightResponse> {
|
|
const color = options?.color ?? 16776960; // 默认黄色
|
|
// const page = options?.page ?? 1; // 默认第1页
|
|
const page = options?.page ?? null; // 默认第1页
|
|
|
|
// console.log('[HighlightSelectText] 调用 Python 脚本高亮文本:', {
|
|
// text,
|
|
// color,
|
|
// page
|
|
// });
|
|
|
|
try {
|
|
// 调用 Python 脚本: HighlightAndJumpToPage
|
|
// 完成: 清除旧高亮 + 高亮新文本（所有匹配的）
|
|
//
|
|
// 重要: Collabora 只能正确传递单个参数（与 ClearHighlights.py 一致）
|
|
// 多个参数会被展开为位置参数导致传递失败
|
|
// 解决方案: 使用逗号分隔的字符串 "search_text,page_number,highlight_color"
|
|
const dataString = `${text},${page},${color}`;
|
|
|
|
const result: ScriptResult = await callPythonScript(
|
|
iframeWindow,
|
|
'Highlightselecttext.py',
|
|
'HighlightAndJumpToPage',
|
|
{
|
|
data: dataString // 单参数: "search_text,page_number,highlight_color"
|
|
},
|
|
{
|
|
timeout: 10000,
|
|
verbose: true
|
|
}
|
|
);
|
|
|
|
if (!result.success) {
|
|
console.error('[HighlightSelectText] Python 脚本执行失败:', result.message);
|
|
return {
|
|
success: false,
|
|
message: result.message,
|
|
timestamp: result.timestamp
|
|
};
|
|
}
|
|
|
|
console.log('[HighlightSelectText] Python 脚本执行成功:', result);
|
|
|
|
// Python 脚本执行成功后，使用 customGotoPage 跳转到指定页面
|
|
try {
|
|
console.log(`[HighlightSelectText] 调用 customGotoPage 跳转到第 ${page} 页`);
|
|
await customGotoPage(iframeWindow, page);
|
|
console.log(`[HighlightSelectText] 成功跳转到第 ${page} 页`);
|
|
} catch (gotoError) {
|
|
console.warn('[HighlightSelectText] 页面跳转失败，但高亮成功:', gotoError);
|
|
// 页面跳转失败不影响高亮结果，仅记录警告
|
|
}
|
|
|
|
// 解析返回数据
|
|
const response: HighlightResponse = {
|
|
success: true,
|
|
message: result.message,
|
|
highlightedCount: result.data?.count,
|
|
page: page,
|
|
timestamp: result.timestamp
|
|
};
|
|
|
|
return response;
|
|
|
|
} catch (error) {
|
|
const errorMessage = error instanceof Error ? error.message : String(error);
|
|
console.error('[HighlightSelectText] 调用失败:', errorMessage);
|
|
|
|
return {
|
|
success: false,
|
|
message: errorMessage,
|
|
timestamp: Date.now()
|
|
};
|
|
}
|
|
}
|