?
Dieses Dokument verwendet PHP-Handbuch für chinesische Websites Freigeben
Attribute Name | Type | Required | Default | Description |
---|---|---|---|---|
file | string | Yes | n/a | name/path to image |
border | string | No | 0 | size of border around image |
height | string | No | actual image height | height to display image |
width | string | No | actual image width | width to display image |
basedir | string | no | web server doc root | directory to base relative paths from |
alt | string | no | "" | alternative description of the image |
href | string | no | n/a | href value to link the image to |
屬性 | 類型 | 是否必須 | 缺省值 | 描述 |
---|---|---|---|---|
file | string | Yes | n/a | 圖象文件的名稱或路徑 |
border | string | No | 0 | 圖象邊框大小 |
height | string | No | actual image height | 顯示圖象高度 |
width | string | No | actual image width | 顯示圖象寬度 |
basedir | string | no | web server doc root | 圖象文件位置的相對路徑 |
alt | string | no | "" | 可選圖象描述(鼠標(biāo)指向圖象或圖象文件不存在時(shí)顯示的字符串信息) |
href | string | no | n/a | 圖象鏈接到的地址 |
html_image is a custom function that generates an HTML tag for an image. The height and width are automatically calculated from the image file if none are supplied.
自定義函數(shù) html_image 產(chǎn)生一個(gè)圖象的 HTML 標(biāo)簽. 如果沒有提供高度和寬度值,將根據(jù)圖象的實(shí)際大小自動(dòng)取得.
basedir is the base directory that relative image paths are based from. If not given, the web server document root (env variable DOCUMENT_ROOT) is used as the base. If security is enabled, the path to the image must be within a secure directory.
basedir 是相對圖象路徑的基路徑. 如果沒有給出該屬性,將依據(jù)WEB服務(wù)器的根路徑(環(huán)境變量 DOCUMENT_ROOT)為準(zhǔn). 如果模板的安全設(shè)置打開了,圖象的位置必須位于為安全文件夾下.
href is the href value to link the image to. If link is supplied, an <a href="LINKVALUE"><a> tag is put around the image tag.
href 是圖象鏈接指向的位置. 如果設(shè)置了該屬性,圖象兩側(cè)將被加上超級鏈接標(biāo)簽,形成一個(gè)圖象鏈接.
Technical Note: html_image requires a hit to the disk to read the image and calculate the height and width. If you don't use template caching, it is generally better to avoid html_image and leave image tags static for optimal performance.
技術(shù)要點(diǎn): html_image 需要訪問磁盤以獲取圖象的尺寸. 如果不使用緩沖,為了優(yōu)化性能,一般情況下建議使用靜態(tài)圖象標(biāo)簽而避免使用 html_iamge.
Example 8-7. html_image
|