Skip to content

Image 图片

图片组件,用于展示图片,支持网络图片、默认图片和错误图片显示,同时支持图片预览功能。

何时使用

当需要在应用中展示图片时使用,组件内置了加载失败和默认图片的处理逻辑,同时支持点击预览功能。

代码演示

import 'package:antd_flutter_example/demo_block.dart';
import 'package:flutter/widgets.dart';
import 'package:trionesdev_antd_mobile/trionesdev_antd_mobile.dart';

class ImagePage extends StatefulWidget {
  const ImagePage({super.key});

  @override
  State<StatefulWidget> createState() => _ImagePageState();
}

class _ImagePageState extends State<ImagePage> {
  @override
  @override
  Widget build(BuildContext context) {
    return SafeArea(child: AntScaffold(
        appBar: AntAppBar(
          title: const Text('Image 图片'),
        ),
        body: SingleChildScrollView(
          child: Column(
            children: [
              DemoBlock(
                title: '基础用法',
                child: UnconstrainedBox(
                  alignment: Alignment.centerLeft,
                  child: AntImage(
                    src:
                    'https://zos.alipayobjects.com/rmsportal/jkjgkEfvpUPVyRjUImniVslZfWPnJuuZ.png',
                    width: 200,
                  ),
                ),
              ),
              DemoBlock(
                title: '默认图片',
                child: UnconstrainedBox(
                  alignment: Alignment.centerLeft,
                  child: AntImage(
                    width: 200,
                  ),
                ),
              ),
              DemoBlock(
                title: '加载失败',
                child: UnconstrainedBox(
                  alignment: Alignment.centerLeft,
                  child: AntImage(
                    src:
                    'https://zos.alipayobjects.com/rmsportal/1.png',
                    width: 200,
                  ),
                ),
              ),
            ],
          ),
        )));
  }
}

API

图片的属性说明如下:

属性说明类型默认值
src图片地址String?null
width图片宽度double?null
height图片高度double?null
preview是否开启图片预览booltrue

使用示例

基础用法

显示网络图片:

dart
AntImage
(
src: 'https://zos.alipayobjects.com/rmsportal/jkjgkEfvpUPVyRjUImniVslZfWPnJuuZ.png',
width: 200,
)

默认图片

当未指定图片地址时,会显示默认图片:

dart
AntImage(width:200,)

加载失败处理

当网络图片加载失败时,会自动显示错误图片:

dart
AntImage
(
src: 'https://zos.alipayobjects.com/rmsportal/1.png',
width: 200,
)

禁用预览

可以通过设置 preview 为 false 来禁用图片预览功能:

dart
AntImage
(
src: 'https://zos.alipayobjects.com/rmsportal/jkjgkEfvpUPVyRjUImniVslZfWPnJuuZ.png',
width: 200,
preview:
false
,
)