Skip to content

迁移至v7.2

7.2版本中,APlus-UI彻底的移除了全局uiMode,现在只通过Design Token来设置主题。受此变更影响的组件有三个ApProCard.TitleApImageApTitle,均增加了属性uiMode,表示设置组件的显示模式(不同模式下显示效果有差异),和主题无关。

为了尽可能的减少迁移成本,在ConfigProvider中增加了三个组件的全局配置,可以通过这些配置快速的完成迁移。

迁移步骤如下:

  1. 移除ConfigProvider中的uiMode属性
  2. 如果在ConfigProvider中设置了uiMode='admin',则需要在ConfigProvider设置额外三个属性:
vue
<template>
  <ConfigProvider
    :ap-pro-card="{ uiMode: 'admin' }"
    :ap-title="{ uiMode: 'admin' }"
    :ap-image="{ uiMode: 'admin' }"
  />
</template>

迁移完成,现在你可以通过theme属性和aplus-token来定制组件主题了,不会再受到uiMode的困扰。

如果不想通过全局化配置来迁移,你可以找到项目中所有上述三个组件的使用地方,如果全局设置了uiMode='admin',则向这些组件添加属性uiMode='admin'即可。

vue
<ApProCard.Title ui-mode="admin" />
<ApImage ui-mode="admin" />
<ApTitle ui-mode="admin" />

为了兼容性考虑,在ConfigProvideruiMode属性直到下一个主要版本才会移除,现在配置uiMode不会有任何效果并收到一条警告。

7.2中,还移除了向html节点添加data-aplus-ui-mode属性的功能,如果有使用到此功能,请自行实现。