编辑“Siteserver-stl:image显示图片”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[Siteserver二次开发指南|上一页]]</span>
<div style="clear:both;"></div>

'''stl:image 显示图片'''

*获取并显示栏目或内容的图片

'''属性列表'''

下表显示所有属于此元素的属性列表。所有属于[[Html]] 元素<img>的成员均适用于<stl:image>元素。 属于Html 元素<img>的属性列表未在下表列出。

{| border="1" cellspacing="0" cellpadding="0"<tbody>
|-
! 属性
! width="18%" | 可能的取值
! width="18%" | 默认值
! 简介
|-
| channelIndex
| &nbsp;
| &nbsp;
| 栏目索引
|-
| channelName
| &nbsp;
| &nbsp;
| 栏目名称
|-
| parent
| &nbsp;
| &nbsp;
| 是否显示父栏目的图片。此属性只可属于以下可能的取值的一种。
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | true
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 显示父栏目的图片，等价于upLevel=&quot;1&quot;
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | false
| bgcolor="#ffffcc" |√ 
| bgcolor="#ffffcc" | 不显示父栏目的图片
|-
| upLevel
| &nbsp;
| &nbsp;
| 显示上几级栏目的图片，0为本级，1为父栏目，以此类推。
|-
| topLevel
| &nbsp;
| &nbsp;
| 显示从首页向下某个级别栏目的图片，0代表网站首页，1代表一级栏目，以此类推。
|-
| src
| &nbsp;
| &nbsp;
| 图片文件地址，可以用&ldquo;@&rdquo;开头表示当前网站根目录，用&ldquo;~&rdquo;开头表示系统根目录。
|-
| altSrc
| &nbsp;
| &nbsp;
| 指定的图片不存在时的显示地址，可以用&ldquo;@&rdquo;开头表示当前网站根目录，用&ldquo;~&rdquo;开头表示系统根目录。
|-
| type
| &nbsp;
| ImageUrl
| 指定存储图片的字段，可以是自定义字段
|-
| width
| &nbsp;
| &nbsp;
| 图片的宽度
|-
| height
| &nbsp;
| &nbsp;
| 图片的高度
|-
| isDynamic
| &nbsp;
| &nbsp;
| 是否动态显示
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | true
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 动态显示
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | false
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 静态显示

|}

'''注意''':

*stl:image 元素的地址取自栏目或内容的图片地址，当图片地址为SWF结尾时自动转成<stl:flash>元素。

*元素<stl:image>在栏目模版中默认显示此栏目的图片，在内容[[模版]]中默认显示此内容的图片。

*stl:image 元素能够作为<stl:channels>等元素的子元素，当作为<stl:channels>的子元素使用时将显示栏目的图片。

*stl:image 元素能够作为<stl:contents>等元素的子元素，当作为<stl:contents>的子元素使用时将显示内容的图片。

*stl:image 元素默认显示内容的图片字段，如果希望显示自定义的图片字段，则需要设置 type 属性。


'''stl:image 示例'''

* '''示例一'''：显示指定栏目的图片

下面的例子显示栏目索引为“公司介绍”的栏目的图片，如果栏目没有图片显示，则不显示任何信息。 
<pre>    
<stl:image channelIndex="公司介绍"></stl:image>   
 
<stl:image channelIndex="公司介绍"></stl:image> 
 </pre>

*'''示例二'''：在内容列表中显示内容图片

下面的例子显示栏目索引为"新闻"的栏目的内容图片列表，点击图片后新窗口打开内容页。 
<pre>
    
<stl:contents channelIndex="新闻" width="80%">    
    <stl:a target="_blank">    
        <stl:image width="200" height="100"></stl:image>    
    </stl:a>    
</stl:contents>   
 
<stl:contents channelIndex="新闻" width="80%"> 
    <stl:a target="_blank"> 
        <stl:image width="200" height="100"></stl:image> 
    </stl:a> 
</stl:contents> 
 </pre>

*'''示例三'''：显示指定的图片文件

下面的例子显示文件名称为“banner.jpg”的图片文件。 
<pre>    
<stl:image src="/images/banner.jpg" width="200" height="100"></stl:image>  
</pre>

==参考资料==
*[http://help.siteserver.cn SiteServer官方]

[[category:SiteServer|S]]