概要

SpreadJSはExcelライクなハイパーリンクをサポートします。ワークシート内のセルに挿入したハイパーリンクを通して、関連する情報に素早くアクセスすることができます。

<p>Webページやファイルに素早くアクセスするためにワークシートのセルにハイパーリンクを挿入することができます。</p> <p><strong>setHyperlink</strong>を使用してハイパーリンクを設定できます。</p> <p>サンプルコード:</p> <pre><code class="hljs javascript language-javascript">sheet.setHyperlink(<span class="hljs-number">0</span>, <span class="hljs-number">2</span>, { <span class="hljs-attr">url</span>: <span class="hljs-string">'https://www.grapecity.com/spreadjs'</span>, <span class="hljs-attr">tooltip</span>: <span class="hljs-string">'grapecity'</span>, <span class="hljs-attr">linkColor</span>: <span class="hljs-string">'#0066cc'</span>, <span class="hljs-attr">visitedLinkColor</span>: <span class="hljs-string">'#3399ff'</span>, <span class="hljs-attr">target</span>: GC.Spread.Sheets.Hyperlink.HyperLinkTargetType.blank }, GC.Spread.Sheets.SheetArea.viewport); <span class="hljs-comment">// ハイパーリンクをクリックするために、セルに値を設定する必要があります。</span> sheet.setText(row, col, <span class="hljs-string">'Click me! I am hyperlink!'</span>); sheet.setHyperlink(<span class="hljs-number">1</span>, <span class="hljs-number">1</span>, { <span class="hljs-attr">url</span>: <span class="hljs-string">'https://www.grapecity.com/spreadjs'</span>, <span class="hljs-attr">tooltip</span>: <span class="hljs-string">'GrapeCity'</span>, <span class="hljs-attr">target</span>: GC.Spread.Sheets.Hyperlink.HyperLinkTargetType.top, <span class="hljs-attr">drawUnderline</span>: <span class="hljs-literal">true</span>, <span class="hljs-attr">command</span>: <span class="hljs-string">'navigationLeft'</span> }, GC.Spread.Sheets.SheetArea.viewport); sheet.setText(<span class="hljs-number">1</span>, <span class="hljs-number">1</span>, <span class="hljs-string">'GrapeCity'</span>); </code></pre> <p>セルに設定されたハイパーリンクを取得する場合は、<strong>getHyperlink</strong>を使用できます。</p> <p>サンプルコード:</p> <pre><code class="hljs javascript language-javascript"><span class="hljs-keyword">var</span> firstHyperlinkData = sheet.getHyperlink(<span class="hljs-number">0</span>, <span class="hljs-number">2</span>, GC.Spread.Sheets.SheetArea.viewport); <span class="hljs-keyword">var</span> secondHyperlinkData = sheet.setHyperlink(<span class="hljs-number">1</span>, <span class="hljs-number">1</span>, GC.Spread.Sheets.SheetArea.viewport); </code></pre> <p>ハイパーリンクは以下のキーを持っています:</p> <table border="1" style="border-collapse: collapse;width:95%;"> <tbody> <tr> <th style="width: 200px;">キー</th> <th style="width: 200px">値タイプ</th> <th>説明</th> </tr> <tr> <td> url </td> <td> string </td> <td> ハイパーリンクのリンク先を指定します。ハイパーリンクは「http/https/ftp/file/mailto」などさまざまなプロトコルをサポートしています。このほかにも、"sjs://"で始まる url でワークシート上のセル参照もサポートします。 </td> </tr> <tr> <td>tooltip</td> <td>string</td> <td>ハイパーリンクがあるセル上でマウスをホバーしたときに表示されるツールチップのメッセージを指定します。</td> </tr> <tr> <td>linkColor</td> <td>string</td> <td>未訪問のリンクの色を指定します。デフォルトは #0066cc です。</td> </tr> <tr> <td>visitedLinkColor</td> <td>string</td> <td>訪問済みのリンクの色を指定します。デフォルトは #3399ff です。</td> </tr> <tr> <td>target</td> <td>number</td> <td>ハイパーリンクにリンクした情報をどこに表示するかを指定します。デフォルトは 0 /* blank */ です。 </td> </tr> <tr> <td>drawUnderline</td> <td>boolean</td> <td>ハイパーリンクがあるセルに下線を表示するかどうかを指定します。デフォルトは true です。</td> </tr> <tr> <td>command</td> <td>string | function</td> <td>ハイパーリンクをクリックしたときの動作を指定します。</td> </tr> </tbody> </table> <p>セルにリンクを入力したときに、自動的にハイパーリンクを作成する機能もサポートしています。 このためのオプションとして、スプレッドのオプションに<code>allowAutoCreateHyperlink</code>があります。</p> <p>ハイパーリンクの自動作成はデフォルトで有効になっています。 自動的にハイパーリンクを作成しない場合は、 <strong>allowAutoCreateHyperlink</strong> を false にします。</p>
window.onload = initFunction; function initFunction() { var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {sheetCount: 1}); var sheet = spread.getActiveSheet(); spread.suspendPaint(); sheet.setText(1, 1, 'SpreadJS Demo Link'); sheet.setText(2, 1, 'https://www.grapecity.com/spreadjs/demos'); var hyperlinkForUrl = {}; hyperlinkForUrl.url = 'https://www.grapecity.com/spreadjs/demos'; sheet.setHyperlink(2, 1, hyperlinkForUrl); sheet.setText(5, 1, 'Link with tooltip'); sheet.setText(6, 1, 'https://www.grapecity.com/spreadjs/demos'); var hyperlinkForTooltip = {}; hyperlinkForTooltip.url = 'https://www.grapecity.com/spreadjs/demos'; hyperlinkForTooltip.tooltip = 'GrapeCity SpreadJS Demos'; sheet.setHyperlink(6, 1, hyperlinkForTooltip); sheet.setText(9, 1, 'Change link foreColor'); sheet.setText(10, 1, 'https://www.grapecity.com/spreadjs/demos'); var hyperlinkForForeColor = {}; hyperlinkForForeColor.url = 'https://www.grapecity.com/spreadjs/demos'; hyperlinkForForeColor.tooltip = 'GrapeCity SpreadJS Demos'; hyperlinkForForeColor.linkColor = 'red'; sheet.setHyperlink(10, 1, hyperlinkForForeColor); sheet.setText(13, 1, 'Change link visited color'); sheet.setText(14, 1, 'https://www.grapecity.com/spreadjs/demos'); var hyperlinkForVisitedColor = {}; hyperlinkForVisitedColor.url = 'https://www.grapecity.com/spreadjs/demos'; hyperlinkForVisitedColor.tooltip = 'GrapeCity SpreadJS Demos'; hyperlinkForVisitedColor.visitedLinkColor = 'green'; sheet.setHyperlink(14, 1, hyperlinkForVisitedColor); sheet.setText(17, 1, 'Link without underline'); sheet.setText(18, 1, 'https://www.grapecity.com/spreadjs/demos'); var hyperlinkWithoutUnderline = {}; hyperlinkWithoutUnderline.url = 'https://www.grapecity.com/spreadjs/demos'; hyperlinkWithoutUnderline.tooltip = 'GrapeCity SpreadJS Demos'; hyperlinkWithoutUnderline.drawUnderline = false; sheet.setHyperlink(18, 1, hyperlinkWithoutUnderline); var hyperlinkButtonElement = document.getElementById('setHyperlinkButton'); hyperlinkButtonElement.onclick = function (e) { var hyperlink = {}; hyperlink.url = document.getElementById('hyperlinkURL').value; hyperlink.tooltip = document.getElementById('tooltip').value; hyperlink.linkColor = document.getElementById('linkColor').value; if (hyperlink.linkColor === "") { hyperlink.linkColor = undefined; } hyperlink.visitedLinkColor = document.getElementById('visitedLinkColor').value; if (hyperlink.visitedLinkColor === "") { hyperlink.visitedLinkColor = undefined; } hyperlink.target = document.getElementById('hyperlinkTarget').value; hyperlink.drawUnderline = document.getElementById('drawUnderline').checked; var row = sheet.getActiveRowIndex(); var col = sheet.getActiveColumnIndex(); sheet.setHyperlink(row, col, hyperlink); }; var allowAutoCreateHyperlinkElement = document.getElementById('allowAutoCreateHyperlink'); allowAutoCreateHyperlinkElement.checked = true; allowAutoCreateHyperlinkElement.onchange = function (e) { spread.options.allowAutoCreateHyperlink = e.target.checked; }; spread.resumePaint(); }
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta name="spreadjs culture" content="ja-jp" /> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets-resources-ja/dist/gc.spread.sheets.resources.ja.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script> <script src="app.js" type="text/javascript"></script> <link rel="stylesheet" type="text/css" href="styles.css"> </head> <body> <div class="sample-tutorial"> <div id="ss" class="sample-spreadsheets"></div> <div class="options-container"> <strong class="sp-demo-HeaderTitle">設定:</strong> <P style="padding:2px 10px">選択したセルにハイパーリンクを設定します:</P> <fieldset> <div id="settingsDiv" style="margin-top: 10px"> <div class="option-row"> <label for="hyperlinkURL">URL:</label> <input type="text" id="hyperlinkURL" placeholder="https://www.grapecity.com/"> </div> <div class="option-row"> <label for="tooltip">ツールチップ:</label> <input type="text" id="tooltip" placeholder="GrapeCity"> </div> <div class="option-row"> <label for="linkColor">リンクの色:</label> <input type="text" id="linkColor" placeholder="#0066cc"> </div> <div class="option-row"> <label for="visitedLinkColor">訪問済みのリンクの色:</label> <input type="text" id="visitedLinkColor" placeholder="#3399ff"> </div> <div class="option-row"> <label for="hyperlinkTarget">表示場所:</label> <select id="hyperlinkTarget" name="hyperlinkTarget"> <option value="0">blank</option> <option value="1">self</option> <option value="2">parent</option> <option value="3">top</option> </select> </div> <div class="option-row"> <label for="drawUnderline">下線を表示する:</label> <input type="checkbox" id="drawUnderline"> </div> <div class="option-row"> <button id="setHyperlinkButton">ハイパーリンクを設定する</button> </div> </div> </fieldset> <div style="margin-top: 10px"> <div class="option-row"> <label for="allowAutoCreateHyperlink">ハイパーリンクを自動的に作成する:</label> <input id="allowAutoCreateHyperlink" type="checkbox"> </div> </div> </div> </div></body> </html>
.sample-tutorial { position: relative; height: 100%; overflow: hidden; } .sample-spreadsheets { width: calc(100% - 280px); height: 100%; overflow: hidden; float: left; } .options-container { float: right; width: 280px; padding: 12px; height: 100%; box-sizing: border-box; background: #fbfbfb; overflow: auto; } .options-container legend { text-align: center; } .option-row { font-size: 14px; padding: 5px; } input { display:block; width: 100%; margin: 8px 0; box-sizing: border-box; } label, input { padding: 4px 6px; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; } #drawUnderline { display: inline-block; width: 30px; } #drawUnderlineLabel { display: inline-block; } #allowAutoCreateHyperlink { display: inline-block; width: 30px; } #setHyperlinkButton { font-weight: bold; background-color: #ecf3ff; width: 200px; height: 35px; border-radius: 4px; border-color: #0b93d5; border-width: thin; }