文档管理中心
ASCF框架API参考组件媒体组件image

image

图片。

起始版本: 1.0.0

约束与限制:

image组件默认宽度320px,高度240px。

属性:

展开
名称 类型 默认值 必填 描述
src string - 图片资源地址。支持线上资源和本地资源,支持png,jpg,jpeg,gif,svg,bmp,webp。
mode string scaleToFill 图片裁剪、缩放的模式。详细内容参见“mode合法值说明”。
binderror eventhandle - 当错误发生时触发,event.detail = {errMsg}。
bindload eventhandle - 当图片载入完毕时触发,event.detail = {height, width}。
lazy-load boolean false

图片懒加载,在进入视区时才开始加载。

起始版本: 1.0.9

mode合法值说明:

展开
描述
scaleToFill 缩放模式,不保持纵横比缩放图片,使图片的宽高完全拉伸至填满image元素。
aspectFit 缩放模式,保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。
aspectFill 缩放模式,保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。
widthFix 缩放模式,宽度不变,高度自动变化,保持原图宽高比不变。
heightFix 缩放模式,高度不变,宽度自动变化,保持原图宽高比不变。
top 裁剪模式,不缩放图片,只显示图片的顶部区域。
bottom 裁剪模式,不缩放图片,只显示图片的底部区域。
center 裁剪模式,不缩放图片,只显示图片的中间区域。
left 裁剪模式,不缩放图片,只显示图片的左边区域。
right 裁剪模式,不缩放图片,只显示图片的右边区域。
top left 裁剪模式,不缩放图片,只显示图片的左上边区域。
top right 裁剪模式,不缩放图片,只显示图片的右上边区域。
bottom left 裁剪模式,不缩放图片,只显示图片的左下边区域。
bottom right 裁剪模式,不缩放图片,只显示图片的右下边区域。

示例:

hxml文件:

收起
自动换行
深色代码主题
复制
  1. <view>
  2. <view has:for="{{ array }}" has:for-item="item">
  3. <view>{{item.text}}</view>
  4. <view>
  5. <image
  6. style="width: 200px; height: 200px; background-color: #eeeeee"
  7. mode="{{ item.mode }}"
  8. src="{{ src }}"
  9. binderror="binderror"
  10. bindload="bindload"
  11. ></image>
  12. </view>
  13. </view>
  14. </view>

js文件:

收起
自动换行
深色代码主题
复制
  1. Page({
  2. data: {
  3. array: [
  4. {
  5. mode: 'scaleToFill',
  6. text: 'scaleToFill:不保持纵横比缩放图片,使图片完全适应',
  7. },
  8. {
  9. mode: 'aspectFit',
  10. text: 'aspectFit:保持纵横比缩放图片,使图片的长边能完全显示出来',
  11. },
  12. {
  13. mode: 'aspectFill',
  14. text: 'aspectFill:保持纵横比缩放图片,只保证图片的短边能完全显示出来',
  15. },
  16. {
  17. mode: 'widthFix',
  18. text: 'widthFix:宽度不变,高度自动变化,保持原图宽高比不变',
  19. },
  20. {
  21. mode: 'top',
  22. text: 'top:不缩放图片,只显示图片的顶部区域',
  23. },
  24. {
  25. mode: 'bottom',
  26. text: 'bottom:不缩放图片,只显示图片的底部区域',
  27. },
  28. {
  29. mode: 'center',
  30. text: 'center:不缩放图片,只显示图片的中间区域',
  31. },
  32. {
  33. mode: 'left',
  34. text: 'left:不缩放图片,只显示图片的左边区域',
  35. },
  36. {
  37. mode: 'right',
  38. text: 'right:不缩放图片,只显示图片的右边区域',
  39. },
  40. {
  41. mode: 'top left',
  42. text: 'top left:不缩放图片,只显示图片的左上边区域',
  43. },
  44. {
  45. mode: 'top right',
  46. text: 'top right:不缩放图片,只显示图片的右上边区域',
  47. },
  48. {
  49. mode: 'bottom left',
  50. text: 'bottom left:不缩放图片,只显示图片的左下边区域',
  51. },
  52. {
  53. mode: 'bottom right',
  54. text: 'bottom right:不缩放图片,只显示图片的右下边区域',
  55. },
  56. ],
  57. src: 'https://www.example.com/example.jpg', // 此处仅为样例,请开发者更换为可用图片资源地址
  58. },
  59. binderror: function(e) {
  60. console.info('加载失败', e.detail);
  61. },
  62. bindload: function(e) {
  63. console.info('加载完成', e.detail);
  64. },
  65. });
相关推荐
文档icon
文档Image
文档textarea
文档canvas
文档text
文档input
在 ASCF框架 中进行搜索
请输入您想要搜索的关键词