Returns an HTML image tag for thesource
. Thesource
can be a full path or a file.
Options
You can add HTML attributes using theoptions
. Theoptions
supports three additionalkeys for convenience and conformance:
-
:alt
- If no alt text is given, the file name part of thesource
is used (capitalized and without the extension) -
:size
- Supplied as "{Width}x{Height}" or "{Number}", so"30x45" becomes width="30" and height="45", and "50" becomes width="50" andheight="50".:size
will be ignored if the value is not in thecorrect format.
Examples
- <span class="ruby-identifier"><span class="identifier">image_tag</span></span>(<span class="ruby-string"><span class="string">"icon"</span></span>)
- <span class="ruby-comment"><span class="comment"># => <img alt="Icon" src="/assets/icon" /></span></span>
- <span class="ruby-identifier"><span class="identifier">image_tag</span></span>(<span class="ruby-string"><span class="string">"icon.png"</span></span>)
- <span class="ruby-comment"><span class="comment"># => <img alt="Icon" src="/assets/icon.png" /></span></span>
- <span class="ruby-identifier"><span class="identifier">image_tag</span></span>(<span class="ruby-string"><span class="string">"icon.png"</span></span>, <span class="ruby-identifier"><span class="identifier"><span class="keymethods">size</span></span></span><span class="ruby-operator"><span class="symbol">:</span></span> <span class="ruby-string"><span class="string">"16x10"</span></span>, <span class="ruby-identifier"><span class="identifier">alt</span></span><span class="ruby-operator"><span class="symbol">:</span></span> <span class="ruby-string"><span class="string">"Edit Entry"</span></span>)
- <span class="ruby-comment"><span class="comment"># => <img src="/assets/icon.png" width="16" height="10" alt="Edit Entry" /></span></span>
- <span class="ruby-identifier"><span class="identifier">image_tag</span></span>(<span class="ruby-string"><span class="string">"/icons/icon.gif"</span></span>, <span class="ruby-identifier"><span class="identifier"><span class="keymethods">size</span></span></span><span class="ruby-operator"><span class="symbol">:</span></span> <span class="ruby-string"><span class="string">"16"</span></span>)
- <span class="ruby-comment"><span class="comment"># => <img src="/icons/icon.gif" width="16" height="16" alt="Icon" /></span></span>
- <span class="ruby-identifier"><span class="identifier">image_tag</span></span>(<span class="ruby-string"><span class="string">"/icons/icon.gif"</span></span>, <span class="ruby-identifier"><span class="identifier">height</span></span><span class="ruby-operator"><span class="symbol">:</span></span> <span class="ruby-string"><span class="string">'32'</span></span>, <span class="ruby-identifier"><span class="identifier">width</span></span><span class="ruby-operator"><span class="symbol">:</span></span> <span class="ruby-string"><span class="string">'32'</span></span>)
- <span class="ruby-comment"><span class="comment"># => <img alt="Icon" height="32" src="/icons/icon.gif" width="32" /></span></span>
- <span class="ruby-identifier"><span class="identifier">image_tag</span></span>(<span class="ruby-string"><span class="string">"/icons/icon.gif"</span></span>, <span class="ruby-identifier"><span class="class"><span class="keyword">class</span></span></span><span class="class"><span class="ruby-operator">:</span> <span class="ruby-string">"<span class="title">menu_icon</span>"</span>)</span>
- <span class="ruby-comment"><span class="comment"># => <img alt="Icon" class="menu_icon" src="/icons/icon.gif" /></span></span>