?
このドキュメントでは、 php中國語ネットマニュアル リリース
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 | "" | 可選圖象描述(鼠標指向圖象或圖象文件不存在時顯示的字符串信息) |
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 產生一個圖象的 HTML 標簽. 如果沒有提供高度和寬度值,將根據圖象的實際大小自動取得.
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 是相對圖象路徑的基路徑. 如果沒有給出該屬性,將依據WEB服務器的根路徑(環(huán)境變量 DOCUMENT_ROOT)為準. 如果模板的安全設置打開了,圖象的位置必須位于為安全文件夾下.
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 是圖象鏈接指向的位置. 如果設置了該屬性,圖象兩側將被加上超級鏈接標簽,形成一個圖象鏈接.
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.
技術要點: html_image 需要訪問磁盤以獲取圖象的尺寸. 如果不使用緩沖,為了優(yōu)化性能,一般情況下建議使用靜態(tài)圖象標簽而避免使用 html_iamge.
Example 8-7. html_image
|