بحث
بحث نصي أصلي في تركيبة العارض
يوفر عارض Doconut بحثًا عاديًا باستخدام النص المستخرج من عارض التنسيق أو إعادة توجيه PDF المعتمد على النص. يتطلب قدرة الترخيص Search.
تمكين واجهة البحث
البحث هو وحدة في العارض، وليس شريط أدوات مستقل. يجب أن تشمل الصفحة الكاملة موارد العارض، شريط أدوات العارض، تثبيت العارض، وobjViewer المُهيأ؛ ثم يتم تثبيت شريط البحث وربطه بنفس المثيل.
البحث والتعليق هما ميزتان مرخصتان مدمجتان، وليسا حزم AddPlugin<T>(). اطلب موارد البحث من Viewer؛ يتم إصدار العلامات الخاصة بها فقط عندما يمنح الترخيص البحث. لا تحتوي عروض MVC 5 على @inject، لذا قم بإنشاء العلامات في المتحكم ومررها عبر ViewBag، مع علم الترخيص الذي تحتاجه الصفحة:
public class ViewerController : Controller
{
public ActionResult Index()
{
var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();
ViewBag.ViewerCss = viewer.ReferenceCss(new CssConfig
{
IncludeViewerCss = true,
IncludeSearchCss = true
});
ViewBag.ViewerScripts = viewer.ReferenceScripts(new ScriptConfig
{
IncludeJQuery = true,
IncludeViewerScripts = true,
IncludeSearchScripts = true,
IncludeSearchBar = true
});
ViewBag.IsSearchEnabled = viewer.IsSearchEnabled;
return View();
}
}اكتبها في العرض باستخدام @Html.Raw(ViewBag.ViewerCss) و@Html.Raw(ViewBag.ViewerScripts). في Web Forms، عرّض القيم نفسها من الكود الخلفي واكتبها باستخدام <%= %>.
يقوم الشريط المدمج باستدعاء نفس طرق JavaScript المتاحة لواجهة مستخدم مخصصة.
احرص على إبقاء تركيبة العارض الكاملة مرئية في العلامات، وابدأ بتهيئة docViewer أولاً، ثم اربط الشريط المرخص:
<nav id="toolbar" aria-label="Document viewer controls">
<!-- عناصر التحكم في العارض، بما في ذلك الزر الذي يفتح البحث -->
</nav>
<div id="searchBarMount"></div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>
<script>
let searchBar = null;
let currentToken = '';
const objViewer = $('#div_ctlDoc').docViewer({
BasePath: '/',
ResPath: 'doconut-res/images'
});
@if ((bool)ViewBag.IsSearchEnabled)
{
<text>
searchBar = $('#searchBarMount').doconutSearchBar({
docId: 'ctlDoc',
getRequestParams: () => ({ token: currentToken }),
onStatus: (message) => console.log(message),
onToast: (message, type) => console.log(type, message),
onLayout: () => requestAnimationFrame(() => objViewer.Refit())
});
searchBar.attach(objViewer);
</text>
}
</script>يهم if على جانب الخادم: بدون قدرة البحث، يتجاهل ReferenceScripts سكريبت الشريط، لذا فإن استدعاء doconutSearchBar(...) غير محمي سيتسبب في حدوث خطأ وإيقاف صفحة العارض عن البدء. في Web Forms، اكتب نفس الحماية كـ <% if (IsSearchEnabled) { %> … <% } %>.
يُدرج المكوّن مجموعات Find و Options و Results ويتعامل مع البحث، والمسح، وعدد التطابقات، والتنقل بين التطابق السابق/التالي. يحتاج شريط أدوات العارض المملوك للمضيف فقط إلى تبديله:
searchBar.isOpen() ? searchBar.close() : searchBar.open();واجهة برمجة التطبيقات العامة الخاصة به صغيرة عمدًا:
| الطريقة | الغرض |
|---|---|
attach(objViewer) | ربط الشريط بالعارض المُهيأ؛ مطلوب مرة واحدة |
open() / close() | إظهار أو إخفاء الشريط؛ الإغلاق أيضًا يمسح التحديدات |
reset() | مسح المصطلح الحالي، عدد النتائج، والتحديدات |
isOpen() | الإبلاغ عما إذا كان الشريط مرئيًا |
setStatus(message) | تمرير رسالة حالة عبر رد الاتصال المُكوَّن |
يسمح رد الاتصال الاختياري onToggle(isOpen) للمضيف بمزامنة زر البحث الخاص به، ويسمح onLayout له بإعادة تحجيم/ملاءمة العارض عندما يتغير ارتفاع الشريط. للحصول على تسلسل بدء تشغيل العارض، البحث، والتعليق المدمج، راجع البدء السريع.
البحث من جافاسكريبت
objViewer.Search(keyword, false, function (resultCount) {
console.log('Matches:', resultCount);
});المعامل الثاني هو مطابقة كلمة كاملة/دقيقة. عدد التطابقات يصل في رد النداء: Search نفسه يذهب إلى الخادم ولا يُعيد شيئًا مفيدًا، لذا var n = objViewer.Search(keyword, false) دائمًا يقرأ undefined — وتُظهر صفحة مُنشأة بهذه الطريقة رسالة "لم يتم العثور على شيء" بينما يُبرز العارض التطابقات. بعد رد النداء:
| الطريقة | النتيجة |
|---|---|
SearchMatchCount() | إجمالي التطابقات الفردية في المستند. |
SearchSummary(false) | [pageNumber, matchCount] إدخالات دون إعادة رسم. |
SearchSummary(true) | نفس الملخص ويرسم إبرازات الصفحة/الصورة المصغرة. |
GotoSearchMatch(index) | ينتقل إلى فهرس تطابق يبدأ من الصفر. |
DocImage.axd يجيب على search=<term> و exact=true|false باستخدام XML. استخدم واجهة برمجة التطبيقات للودجت بدلاً من تحليل ذلك الرد الداخلي بنفسك.
التحقق من قدرة البحث
تقارير استجابة التهيئة:
X-Doconut-Can-Search: 1بعد التهيئة، objViewer.CanSearch() يكشف عن نفس حكم التنسيق/الجلسة. يُعيد false عندما يرسل الخادم 0؛ قبل الاستجابة، أو مع خادم أقدم يُهمل الرأس، فإنه يفرض true.
يجب عدم الخلط بين ثلاث بوابات مستقلة:
| البوابة | السؤال |
|---|---|
CanSearch() / response header | هل يمتلك العارض المُحل مسار فهرس/بحث أصلي؟ |
AllowSearch | هل طلب تكوين هذا التنسيق استخراج النص حيث يوجد المفتاح؟ |
LicenseCapability.Search | هل التطبيق مخول بتنفيذ البحث واستلام حزم واجهة المستخدم؟ |
يمكن أن يكون التنسيق قابلًا للبحث تقنيًا بينما الترخيص الحالي يمنع العملية.
تمكين الاستخراج لكل تنسيق
var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
AllowSearch = true,
AllowCopy = true // اختياري: يسمح للمستخدم بسحب منطقة ونسخ نصها
});AllowSearch و AllowCopy موجودان على PdfConfig، WordConfig، ExcelConfig، و PptConfig. خصائص Office تفوض إلى PdfConfig المتداخلة. كلاهما يفرض القيمة الافتراضية false.
محولات البحث الأصلية العادية موجودة لـ PDF، Word، Excel، PowerPoint، TXT، Visio، البريد الإلكتروني، EPUB، و MHT. يستخدم XPS مساره PDF بشكل افتراضي. تستفيد HTML وMicrosoft Project من إعادة توجيه PDF قائم على النص:
// DefaultRender = false → تم التحويل إلى PDF نصي → قابل للبحث
var token = await viewer.OpenDocumentAsync(path, new HtmlConfig { DefaultRender = false });بالنسبة للعارضين الأصليين، CanSearch() يصف قدرة العارض؛ لا يضمن أن مستندًا معينًا يحتوي على نص قابل للاستخدام. يمكن لملف PDF تكون صفحاته صورًا ممسوحة ضوئيًا فقط أن ينتج صفر نتائج أصلية.
سلوك البحث العادي
يحاول الخادم مصادر البحث بالترتيب التالي:
- النتائج من عارض التنسيق الأصلي.
- فهرس بحث
.srhمُسبق الإنشاء. - نتيجة خطأ/فارغة عندما لا يوجد مصدر بحث.
CanSearch() يمكن أن يكون صحيحًا لعارض قابل للبحث حتى عندما لا يحتوي مستند معين على طبقة نصية وبالتالي لا يُعيد أي تطابقات.
الترخيص وسلوك واجهة المستخدم
ترخيص مؤقت/تجريبي نشط يمنح البحث خلال فترة نشاطه. ترخيص مفقود وملف TRIAL قديم لا يمنح أي قدرة على البحث. بدون البحث:
ReferenceCssوReferenceScriptsيحذفان حزم البحث.DocImage.axdيرفض طلبات البحث بدلاً من إرجاع النتائج.
تحكم في رؤية واجهة المستخدم المخصصة من خلال IDoconutLicenseService.IsCapabilityGranted(LicenseCapability.Search) واستخدم CanSearch() لحكم التنسيق/الجلسة المنفصل.
استكشاف الأخطاء وإصلاحها
| العَرَض | التحقق |
|---|---|
| شريط البحث مفقود | قدرة البحث و IncludeSearchCss/IncludeSearchScripts/IncludeSearchBar |
CanSearch() خاطئ | عارض التنسيق، المسار المختار DefaultRender، ورأس استجابة التهيئة |
| البحث يُرجع صفرًا لملف PDF ممسوح | المستند لا يحتوي على طبقة نصية؛ استخدم مصدرًا يحتوي نصًا أو إسقاط PDF يحافظ على النص |
| البحث يعمل لكن الإبرازات غير متطابقة | مسار العرض، الدقة، تحويلات المستند، ومربعات الكلمات المستخرجة |
هل كانت هذه الصفحة مفيدة؟