URL 方法
URL 方法用于输出静态文件的 CDN 地址。友好速搭 CDN 根域名是asset.ibanquan.com
。
在 URL 方法的输出中,在网址中都会包含问号?
,以及后面的参数v
。这个值是用来标识文件的版本。在文件更新后,这个值会变化,从而实现 CDN 的缓存刷新。
//asset.ibanquan.com/middle/1423/c/19/5469e53cf2943978e00000cb/index_slide_1?v=1416303687_1416226108
图片裁剪缩放
对于存储的图片资源,友好速搭 CDN 提供简单的缩略、裁剪功能。
在图片的链接中,通过在图片名后,以下划线:_
间隔,再加处理后缀:w 宽度像素
、h 高度像素
、g 裁剪重心
。对图片进行指定处理,例如:
定宽等比缩略:
//asset.ibanquan.com/middle/1423/c/19/5469e53cf2943978e00000cb/index_slide_1_w120
定高等比缩略:
//asset.ibanquan.com/middle/1423/c/19/5469e53cf2943978e00000cb/index_slide_1_h40
上面两个链接,处理效果一致。
当同时指定宽和高,没指定重心时,例如index_slide_1_w120h320
,将以等比缩略图片,不会裁剪或放大。如需裁剪,需要指定g 参数
,例如:
http://asset.ibanquan.com/middle/1423/c/19/5469e53cf2943978e00000cb/slide_w200h100gc
g 参数
的重心值,可选以下:
在指定图片处理参数时,如果三个参数,都存在,顺序左至右依次为:w
、h
、g
,顺序不能随意调整。
图片裁剪缩放,适用以下方法:
其它 URL 方法:
- asset_url
- global_asset_url
- url_for_vendor
- url_for_type
- customer_login_link
- customer_logout_link
- customer_register_link
asset_url
用于返回主题中资源/Assets目录下的文件地址。
输入:
{{ 'main.css' | asset_url }}
输出:
//asset.ibanquan.com/middle/1423/c/19/5469e53df2943978e00000da/main.css?v=1416316309_1416226109
针对图片处理需求:
输入:
{{ 'index_slide_1' | asset_url | replace: 'index_slide_1', 'index_slide_1/s_w200h200gc.jpg' }}
注意:需要带上文件扩展名
输出:
//asset.ibanquan.com/s/xxx/xxx/index_slide_1/s_w200h200gc.jpg?v=1582259098_1582251333
global_asset_url
获取友好速搭通用资源文件地址,通用文件经过优化,加载速度会更快。
输入:
{{ 'jquery-2.1.4.min.js' | global_asset_url }}
输出:
//asset.ibanquan.com/common/js/jquery-2.1.4.min.js?v=1
以下是部分常用通用文件:
JavaScript 文件 | 包含内容 |
---|---|
jquery-1.11.3.min.js |
jQuery 1.11.3 的压缩版本 |
jquery-2.1.4.min.js |
jQuery 2.1.4 的压缩版本 |
zepto-1.1.4.min.js |
Zepto 1.1.4 的压缩版本 |
riot-2.2.2.min.js |
Riot 2.2.2 的压缩版本 |
jquery.qrcode.min.js |
jQuery QRCode 的压缩版本 |
图像文件 | 包含内容 |
---|---|
account.png |
注册方式图标 |
banks-160623.png |
支付方式图标 |
oauth-141215.png |
社交登录方式图标 |
image_url
通过 image 对象来获取图片地址,可以通过参数,指定长和宽的像素值,来获取缩略图。
如果image
对象为空,则返回空字符串。
输入:
{{ blog_author.avatar | image_url }}
{{ blog_author.avatar | image_url : 400, 400 }}
{{ blog_author.avatar | image_url : 400, 400, "sw" }}
输出:
//asset.ibanquan.com/image/53faebc26387e44752000003/s.jpg?v=1408953282
//ibanquan.ibanquan.com/image/53faebc26387e44752000003/s_w400h400.jpg?v=1408953282
//ibanquan.youhaosuda.com/image/53faebc26387e44752000003/s_w400h400gsw.jpg?v=1408953282
product_image_url
用于商品相关 image 对象的图片地址获取,可以通过参数,指定长和宽的像素值,来获取缩略图。
如果image
对象为空,则返回默认的商品图片地址。
输入:
{{ product.feature_image | product_image_url }}
{{ product.feature_image | product_image_url: 400, 400 }}
{{ product.feature_image | product_image_url: 400, 400, "sw" }}
输出:
//asset.ibanquan.com/image/53faebc26387e44752000003/s.jpg?v=1408953282
//ibanquan.ibanquan.com/image/53faebc26387e44752000003/s_w400h400.jpg?v=1408953282
//ibanquan.youhaosuda.com/image/53faebc26387e44752000003/s_w400h400gsw.jpg?v=1408953282
url_for_vendor
输出指定品牌的链接。可直接用于vendor
对象或vendor.handle
。
输入:
{{ vendor | url_for_vendor }}
{{ vendor.handle | url_for_vendor }}
输出:
/vendors/V000002
/vendors/V000002
url_for_type
输出指定商品分类的链接。可直接用于type
对象或type.handle
。
输入:
{{ type | url_for_type }}
{{ type.handle | url_for_type }}
输出:
/types/T000002
/types/T000002
customer_login_link
输出登录链接。
输入:
{{ customer_login_link }}
输出:
/account/login
customer_logout_link
输出注销链接。
输入:
{{ customer_logout_link}}
输出:
/account/logout
customer_register_link
输出注册链接。
输入:
{{ customer_register_link}}
输出:
/account/register