npm 包 react-native-img-with-placeholder 使用教程

阅读时长 5 分钟读完

介绍

react-native-img-with-placeholder 是一款基于 React Native 的图片占位组件。它可以帮助开发者在加载图片前显示占位图,提升用户体验。

安装

可以使用 npm 或者 yarn 安装该包:

使用

该组件的 API 与官方的 <Image> 组件大致相同,只需传入两个必选的 prop:sourceplaceholderSource,其中 source 表示图片的真实地址,placeholderSource 表示占位图的地址。

-- -------------------- ---- -------
------ ----- ---- --------
------ ------ ----------- ---- ---------------
------ ------------------ ---- ------------------------------------

------ ------- -------- ----- -
  ------ -
    ----- -------------------------
      -------------------
        --------------------
        ------------- -------------------------------------------------
        ------------------------------------------------------
      --
    -------
  --
-

----- ------ - -------------------
  ---------- -
    ----- --
    ----------- ---------
    --------------- ---------
  --
  ------ -
    ------ ----
    ------- ----
  --
---

配置

可以配置 ImgWithPlaceholder 组件的默认占位图,以及加载图片时的 loading 效果。

设置默认占位图

可以在应用启动时设置 ImgWithPlaceholder.defaultProps.placeholderSource 来设置所有该组件的默认占位图。

-- -------------------- ---- -------
------ ----- ---- --------
------ ------ ----------- ---- ---------------
------ ------------------ ---- ------------------------------------

------------------------------------------------- - -------------------------------------------

------ ------- -------- ----- -
  ------ -
    ----- -------------------------
      -------------------
        --------------------
        ------------- -------------------------------------------------
      --
    -------
  --
-

----- ------ - -------------------
  ---------- -
    ----- --
    ----------- ---------
    --------------- ---------
  --
  ------ -
    ------ ----
    ------- ----
  --
---

设置 loading 效果

可以使用 ImgWithPlaceholderloadingRender 属性自定义加载图片时的效果。

例如,可以使用 ActivityIndicator 组件实现一个旋转的 loading 效果:

-- -------------------- ---- -------
------ ----- ---- --------
------ ------ ----------- ------------------ ---- ---------------
------ ------------------ ---- ------------------------------------

------ ------- -------- ----- -
  ----- ------------- - -- -- -
    ------------------ ------------ -----------------
  --

  ------ -
    ----- -------------------------
      -------------------
        --------------------
        ------------- -------------------------------------------------
        ------------------------------------------------------
        -----------------------------
      --
    -------
  --
-

----- ------ - -------------------
  ---------- -
    ----- --
    ----------- ---------
    --------------- ---------
  --
  ------ -
    ------ ----
    ------- ----
  --
---

总结

本文介绍了 npm 包 react-native-img-with-placeholder 的用法和配置方法,该组件可以帮助开发者在加载图片前显示占位图,提升用户体验。希望本文能对前端开发者有所帮助。完整示例代码可以在 GitHub 上查看。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055cd981e8991b448da799

纠错
反馈