DsPdfViewer では、大/小文字を区別、ワイルドカード、近接などのさまざまな高度な検索オプションを使用して検索操作を実行できます。デフォルトでは、ツールバーに「検索」アイコンが表示されます。 このアイコンをクリックすると、フローティング検索バーが表示されます。ただし、以下で説明するように、フローティング状態である検索バーを無効にして、検索パネルをサイドバーに配置することもできます。
DsPdfViewer では、ツールバーの直下、右上隅にフローティング 状態であるテキストの検索バーが表示されます。フローティング テキスト検索バーを開くには、 ツールバーアイコン()を使用するか、[Ctrl]+[F]キーを押します。その後、指定の検索入力フィールドに検索する用語を入力することで検索操作を開始できます。入力を開始すると、検索機構が自動的にドキュメント内で一致する用語の検索を開始し、入力中にリアルタイムで結果を強調表示または表示します。この動的な検索処理により、即フィードバックされ、関連コンテンツを迅速に見つけるのに役立ちます。
検索設定をカスタマイズおよび微調整するには、[設定]ボタン()にあるさまざまな高度な検索オプションを提供するフローティングテキスト検索バーを使用できます。これにより、無関係なオプションが削除され、検索クエリの範囲が絞り込まれます。
フローティング テキスト検索バーを閉じる場合は、[閉じる] ()ボタンを使用するか、検索の入力フィールドにフォーカスがあるときに ESC キーを押します。
サイドバーの検索パネルを使用するには、useFloatingSearchBarオプションを false に設定します。サイドバーの検索パネルには、高度な検索オプションを提供するだけでなく、検索結果の合計数と特定の結果が見つかったページ番号も表示されます。
次のサンプルコードは、サイドバーの検索パネルを使用する方法を示しています。
C# |
コードのコピー
|
---|---|
// フローティング検索バーの代わりにサイドバーの検索パネルを使用します。 var viewer = new DsPdfViewer("#root", { useFloatingSearchBar: false }); |
次のセクションでは、DsPdfViewer が提供するさまざまな高度な検索オプションについて説明します。
検索クエリで指定されたテキストと同じ大・小文字の出現をPDFドキュメントで検索します。
例: 「test」を検索すると、検索結果で「test」、「tests」、「testing」が表示されますが、 「Test」の出現が表示されません。
検索クエリで指定された単語全体を含むPDFドキュメント内のすべての出現箇所を検索します。
例:「demo」を検索すると、検索結果で「demo」と「Demo」が表示されますが、「demonstration」や「demos」が表示されません。
検索クエリで指定された文字で始まるPDFドキュメント内のすべての出現箇所を検索します。
例: 「us」を検索すると、検索結果で「us」、「used」、「Users」が表示されますが、「various」や「status」などの出現が表示されません。
検索クエリで指定された文字で終わるPDFドキュメント内のすべての出現箇所を検索します。
例: 「at」を検索すると、検索結果で「at」、「format」、「treat」が表示されますが、「attribute」や「atom」などの出現が表示されません。
本オプションを使用すると、検索結果を最大化できます。 単語の一部を入力して、任意の数のワイルドカード文字を使用できます。PDFビューワは、次の2つのワイルドカード文字をサポートしています。
「近接」オプションを使用して、特定の数の単語で分離されている2つ以上の単語を検索できます。演算子AROUND(n)を使用して、検索語間の単語の最大数を指定できます。検索結果には、PDFドキュメントの同じページに存在する単語のみが含まれます。
例: PDFドキュメント内の次のテキストを例として説明します。
Several species of game fish live or spawn in wetlands. Hundreds, if not thousands, of invertebrates that form the food of birds also rely on water for most, if not all, phases of their existence. In fact, most all species of animals we have must spend at least part of the year in wetlands. To lose any more of these vital areas is almost unthinkable.
用例1:
検索クエリ: species AROUND(8) wetlands
検索結果: species of game fish live or spawn in wetlands
説明: 「species」と「wetlands」という言葉は、互いに7語の間隔を置いて存在します。この検索結果を表示するには、「n」の値が7以上である必要があります。
用例2:
検索クエリ: species wetlands
検索結果:species of game fish live or spawn in wetlands
species of animals we have must spend at least part of the year in wetlands
説明: 演算子AROUND(n)が指定されない場合、検索結果には、場所の制約なしにクエリからのすべての単語が含まれます。
用例3:
検索クエリ: species AROUND(8) wetlands AROUND(4) thousands
検索結果: species of game fish live or spawn in wetlands. Hundreds, if not thousands
説明: 「species」、「wetlands」と「thousands」の言葉は、指定された間隔を置いて存在します。
検索パネルで[全てをハイライト表示]のチェックボックスがオンの場合、すべての検索結果が一度に協調表示されます。 以下のコード例は、useCanvasForSelectionオプションを使用してデフォルトのハイライト色を変更する方法を示しています。
Index.cshtml |
コードのコピー
|
---|---|
var viewer = new DsPdfViewer('#root', { useCanvasForSelection: { selectionColor: 'rgba(0, 0, 195, 0.25)', highlightColor: 'rgba(255, 0, 0, 0.35)', inactiveHighlightColor: "rgba(180, 0, 170, 0.35)" } }); |
PDFビューワには、以下に説明するような高度な検索オプションが用意されています。
上記検索オプションを非表示にしたい場合は、ページの<head>部分に以下のとおりCSSスタイルを追加してください。
Index.cshtml |
コードのコピー
|
---|---|
<style> .ds-viewer .search .search__query-params > label:nth-child(1), .ds-viewer .search .search__query-params > label:nth-child(2), .ds-viewer .search .search__query-params > label:nth-child(3), .ds-viewer .search .search__query-params > label:nth-child(4), .ds-viewer .search .search__query-params > label:nth-child(5), .ds-viewer .search .search__query-params > label:nth-child(6) { display: none; } </style> |