リンクヘルパー

<p><font><font class=””>リンクを生成するための簡潔なAPIを提供します。</font><font>それはだ</font></font><strong><font><font>、パブリックメソッド</font></font></strong><font><font>と呼ばれる</font></font><code>#link_to</code><font><font>の両方で使用することができ、</font></font><strong><font><font>ビュー</font></font></strong><font><font>と</font></font><strong><font><font>テンプレート</font></font></strong><font><font>。</font></font></p>

<h2 id=”usage” class=”title”><a name=”usage” class=”anchor” href=”#usage”>      <svg aria-hidden=”true” class=”octicon octicon-link” height=”16″ version=”1.1″ viewBox=”0 0 16 16″ width=”16″>
<path d=”M4 9h1v1h-1c-1.5 0-3-1.69-3-3.5s1.55-3.5 3-3.5h4c1.45 0 3 1.69 3 3.5 0 1.41-0.91 2.72-2 3.25v-1.16c0.58-0.45 1-1.27 1-2.09 0-1.28-1.02-2.5-2-2.5H4c-0.98 0-2 1.22-2 2.5s1 2.5 2 2.5z m9-3h-1v1h1c1 0 2 1.22 2 2.5s-1.02 2.5-2 2.5H9c-0.98 0-2-1.22-2-2.5 0-0.83 0.42-1.64 1-2.09v-1.16c-1.09 0.53-2 1.84-2 3.25 0 1.81 1.55 3.5 3 3.5h4c1.45 0 3-1.69 3-3.5s-1.5-3.5-3-3.5z”></path>
</svg>
</a><font><font>使用法</font></font></h2>

<p><font><font>2つの必須引数と1つのオプション引数を受け入れます。</font><font>最初はタグの内容、2番目はパス、3番目はHTML属性の集合を表すHashです。</font></font></p>
<pre class=”language-ruby erb”><code><span class=”cp”>&lt;%=</span> <span class=”n”>link_to</span> <span class=”s1″>’Home'</span><span class=”p”>,</span> <span class=”s1″>’/'</span> <span class=”cp”>%&gt;</span>
<span class=”cp”>&lt;%=</span> <span class=”n”>link_to</span> <span class=”s1″>’Profile'</span><span class=”p”>,</span> <span class=”n”>routes</span><span class=”p”>.</span><span class=”nf”>profile_path</span><span class=”p”>,</span> <span class=”ss”>class: </span><span class=”s1″>’btn'</span><span class=”p”>,</span> <span class=”ss”>title: </span><span class=”s1″>’Your profile'</span> <span class=”cp”>%&gt;</span>
<span class=”cp”>&lt;%=</span>
<span class=”n”>link_to</span><span class=”p”>(</span><span class=”n”>routes</span><span class=”p”>.</span><span class=”nf”>profile_path</span><span class=”p”>,</span> <span class=”ss”>class: </span><span class=”s1″>’avatar'</span><span class=”p”>,</span> <span class=”ss”>title: </span><span class=”s1″>’Your profile'</span><span class=”p”>)</span> <span class=”k”>do</span>
<span class=”n”>img</span><span class=”p”>(</span><span class=”ss”>src: </span><span class=”n”>user</span><span class=”p”>.</span><span class=”nf”>avatar</span><span class=”p”>.</span><span class=”nf”>url</span><span class=”p”>)</span>
<span class=”k”>end</span>
<span class=”cp”>%&gt;</span>
</code></pre>

<p><font><font>出力:</font></font></p>
<pre class=”language-ruby html”><code><span class=”nt”>&lt;a</span> <span class=”na”>href=</span><span class=”s”>”/”</span><span class=”nt”>&gt;</span>Home<span class=”nt”>&lt;/a&gt;</span>
<span class=”nt”>&lt;a</span> <span class=”na”>href=</span><span class=”s”>”/profile”</span> <span class=”na”>class=</span><span class=”s”>”btn”</span> <span class=”na”>title=</span><span class=”s”>”Your profile”</span><span class=”nt”>&gt;</span>Profile<span class=”nt”>&lt;/a&gt;</span>
<span class=”nt”>&lt;a</span> <span class=”na”>href=</span><span class=”s”>”/profile”</span> <span class=”na”>class=</span><span class=”s”>”avatar”</span> <span class=”na”>title=</span><span class=”s”>”Your profile”</span><span class=”nt”>&gt;</span>
<span class=”nt”>&lt;img</span> <span class=”na”>src=</span><span class=”s”>”/images/avatars/23.png”</span><span class=”nt”>&gt;</span>
<span class=”nt”>&lt;/a&gt;</span>
</code></pre>

<p><font><font>あるいは、コンテンツは、所与のブロックとして表すことができる。</font></font></p>
<pre class=”language-ruby ruby”><code><span class=”k”>module</span> <span class=”nn”>Web::Views::Books</span>
<span class=”k”>class</span> <span class=”nc”>Show</span>
<span class=”kp”>include</span> <span class=”no”>Web</span><span class=”o”>::</span><span class=”no”>View</span><font></font>
<font></font>
<span class=”k”>def</span> <span class=”nf”>look_inside_link</span>
<span class=”n”>url</span> <span class=”o”>=</span> <span class=”n”>routes</span><span class=”p”>.</span><span class=”nf”>look_inside_book_path</span><span class=”p”>(</span><span class=”ss”>id: </span><span class=”n”>book</span><span class=”p”>.</span><span class=”nf”>id</span><span class=”p”>)</span><font></font>
<font></font>
<span class=”n”>link_to</span> <span class=”n”>url</span><span class=”p”>,</span> <span class=”ss”>class: </span><span class=”s1″>’book-cover'</span> <span class=”k”>do</span>
<span class=”n”>html</span><span class=”p”>.</span><span class=”nf”>img</span><span class=”p”>(</span><span class=”ss”>src: </span><span class=”n”>book</span><span class=”p”>.</span><span class=”nf”>cover_url</span><span class=”p”>)</span>
<span class=”k”>end</span>
<span class=”k”>end</span>
<span class=”k”>end</span>
<span class=”k”>end</span>
</code></pre>

<p><font><font>テンプレート:</font></font></p>
<pre class=”language-ruby erb”><code><span class=”cp”>&lt;%=</span> <span class=”n”>look_inside_link</span> <span class=”cp”>%&gt;</span>
</code></pre>

<p><font><font>出力:</font></font></p>
<pre class=”language-ruby html”><code><span class=”nt”>&lt;a</span> <span class=”na”>href=</span><span class=”s”>”/books/1/look_inside”</span> <span class=”na”>class=</span><span class=”s”>”book-cover”</span><span class=”nt”>&gt;</span>
<span class=”nt”>&lt;img</span> <span class=”na”>src=</span><span class=”s”>”https://cdn.bookshelf.org/books/1/full.png”</span><span class=”nt”>&gt;</span>
<span class=”nt”>&lt;/a&gt;</span>
</code></pre>

<h2 id=”security” class=”title”><a name=”security” class=”anchor” href=”#security”>      <svg aria-hidden=”true” class=”octicon octicon-link” height=”16″ version=”1.1″ viewBox=”0 0 16 16″ width=”16″>
<path d=”M4 9h1v1h-1c-1.5 0-3-1.69-3-3.5s1.55-3.5 3-3.5h4c1.45 0 3 1.69 3 3.5 0 1.41-0.91 2.72-2 3.25v-1.16c0.58-0.45 1-1.27 1-2.09 0-1.28-1.02-2.5-2-2.5H4c-0.98 0-2 1.22-2 2.5s1 2.5 2 2.5z m9-3h-1v1h1c1 0 2 1.22 2 2.5s-1.02 2.5-2 2.5H9c-0.98 0-2-1.22-2-2.5 0-0.83 0.42-1.64 1-2.09v-1.16c-1.09 0.53-2 1.84-2 3.25 0 1.81 1.55 3.5 3 3.5h4c1.45 0 3-1.69 3-3.5s-1.5-3.5-3-3.5z”></path>
</svg>
</a><font><font>セキュリティ</font></font></h2>

<p><font><font>マークアップでリンクを使用するときは、</font></font><strong><font><font>ホワイトリストに登録</font></font></strong><font></font><strong><font><font>された</font></font></strong><font><strong><font>URL</font></strong><font>と</font><strong><font>エスケープされた属性の</font></strong><font> 2つの側面があります</font><font>。</font><font>詳細な説明</font><font>については、</font></font><a href=”/guides/helpers/escape”><font><font>Markup Escapeの</font></font></a><font><font>セクションを</font><font>ご覧ください</font><font>。</font></font></p>