@tdesign/uniapp 0.8.0 → 0.8.1

package/dist/image/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-image />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TImage from '@tdesign/uniapp/image/image.vue';

package/dist/image-viewer/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-image-viewer />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TImageViewer from '@tdesign/uniapp/image-viewer/image-viewer.vue';

package/dist/index.js

@@ -1,3 +1,16 @@
 // This file is intentionally empty.
 // It serves as the runtime entry point for module resolvers.
 // All meaningful exports from this package are type-only.
+
+// mixins
+export { handlePageScroll } from './mixins/page-scroll';
+
+// 函数式调用
+export { default as DialogPlugin } from './dialog/index';
+export { default as Dialog } from './dialog/index';
+export { default as MessagePlugin } from './message/index';
+export { default as Message } from './message/index';
+export { default as Toast, showToast, hideToast } from './toast/index';
+export { default as ToastPlugin } from './toast/index';
+export { default as ActionSheetPlugin, ActionSheetTheme } from './action-sheet/index';
+export { default as ActionSheet } from './action-sheet/index';

package/dist/indexes/README.md

@@ -7,7 +7,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-indexes />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TIndexes from '@tdesign/uniapp/indexes/indexes.vue';

package/dist/input/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-input />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TInput from '@tdesign/uniapp/input/input.vue';

package/dist/input/input.vue

@@ -151,7 +151,7 @@ import { getCharacterLength, calcIcon, coalesce, nextTick } from '../common/util
 import { isDef } from '../common/validator';
 import { getInputClass } from './computed.js';
 import tools from '../common/utils.wxs';
-import { RELATION_MAP } from '../common/relation/parent-map.js';
+import { RELATION_MAP } from '../common/relation/parent-map';
 
 
 const name = `${prefix}-input`;
@@ -205,9 +205,6 @@ export default {
         tools,
 
         dataValue: coalesce(this.value, this.defaultValue),
-
-      // rawValue: '',
-      // innerMaxLen: -1,
       };
     },
     watch: {
@@ -282,30 +279,7 @@ export default {
           this.dataValue = value;
           this.count = isDef(value) ? String(value).length : 0;
         }
-
-      // this.updateInnerMaxLen();
       },
-      // updateInnerMaxLen() {
-      // this.innerMaxLen = this.getInnerMaxLen();
-      // },
-      // getInnerMaxLen() {
-      //   const {
-      //     allowInputOverMax,
-      //     maxcharacter,
-      //     maxlength,
-      //     dataValue,
-      //     rawValue,
-      //     count,
-      //   } = this;
-      //   return getInnerMaxLen({
-      //     allowInputOverMax,
-      //     maxcharacter,
-      //     maxlength,
-      //     dataValue,
-      //     rawValue,
-      //     count,
-      //   });
-      // },
 
       updateClearIconVisible(value = false) {
         const { clearTrigger, disabled, readonly } = this;

package/dist/link/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-link />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TLink from '@tdesign/uniapp/link/link.vue';

package/dist/loading/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-loading />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 
 ```js

package/dist/message/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-message />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TMessage from '@tdesign/uniapp/message/message.vue';
@@ -16,10 +18,13 @@ import TMessage from '@tdesign/uniapp/message/message.vue';
 
 ### 引入 API
 
-若以 API 形式调用 Message，则需在页面 `page.js` 中引入组件 API：
+若以 API 形式调用 Message，则需在页面中引入组件 API：
 
 ```js
-import Message from '@tdesign/uniapp/message/index';
+// MessagePlugin 和 Message 均可使用
+import { MessagePlugin } from '@tdesign/uniapp';
+// 或
+// import { Message } from '@tdesign/uniapp';
 ```
 
 ### 组件类型

package/dist/mixins/page-scroll.d.ts

@@ -0,0 +1,19 @@
+interface Bus {
+  on(evtName: string, listener: (...args: any[]) => void): void;
+  once(evtName: string, listener: (...args: any[]) => void): void;
+  emit(evtName: string, ...args: any[]): void;
+  off(evtName: string, listener?: (...args: any[]) => void): void;
+}
+
+export declare const bus: Bus;
+export declare const PAGE_SCROLL_EVENT_NAME: string;
+
+declare function pageScrollMixin(
+  funcName?: string,
+  useBus?: boolean,
+): Record<string, any>;
+
+export default pageScrollMixin;
+
+export declare function getScroller(el: Element, root?: Window): Element | Window;
+export declare function handlePageScroll(e: any): Bus;

package/dist/mixins/skyline.js

@@ -1,4 +1,4 @@
-import { getCurrentPage } from '../common/utils.js';
+import { getCurrentPage } from '../common/utils';
 
 export default {
   data() {

package/dist/navbar/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-navbar />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TNavbar from '@tdesign/uniapp/navbar/navbar.vue';

package/dist/notice-bar/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-notice-bar />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TNoticeBar from '@tdesign/uniapp/notice-bar/notice-bar.vue';

package/dist/overlay/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-overlay />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TOverlay from '@tdesign/uniapp/overlay/overlay.vue';

package/dist/picker/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-picker />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TPicker from '@tdesign/uniapp/picker/picker.vue';

package/dist/popover/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-popover />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TPopover from '@tdesign/uniapp/popover/popover.vue';

package/dist/popup/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-popup />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TPopup from '@tdesign/uniapp/popup/popup.vue';

package/dist/progress/README.md

@@ -9,9 +9,9 @@ isComponent: true
 
 ## 引入
 
-### 引入组件
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-progress />`。详细配置请参考 [快速开始](../getting-started)。
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+如需手动引入：
 
 ```js
 import TProgress from '@tdesign/uniapp/progress/progress.vue';

package/dist/pull-down-refresh/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-pull-down-refresh />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TPullDownRefresh from '@tdesign/uniapp/pull-down-refresh/pull-down-refresh.vue';

package/dist/qrcode/README.md

@@ -7,7 +7,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-qrcode />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TQRCode from '@tdesign/uniapp/qrcode/qrcode.vue';

package/dist/radio/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-radio />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TRadio from '@tdesign/uniapp/radio/radio.vue';

package/dist/rate/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-rate />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TRate from '@tdesign/uniapp/rate/rate.vue';

package/dist/rate/rate.css

@@ -60,6 +60,7 @@
   box-shadow: var(--td-shadow-1, 0 1px 10px rgba(0, 0, 0, 0.05), 0 4px 5px rgba(0, 0, 0, 0.08), 0 2px 4px -1px rgba(0, 0, 0, 0.12));
   background-color: var(--td-bg-color-container, var(--td-font-white-1, #ffffff));
   transform: translateX(-50%);
+  z-index: 2;
 }
 .t-rate__tips--bottom {
   top: calc(100% + 16rpx);

package/dist/result/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-result />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TResult from '@tdesign/uniapp/result/result.vue';

package/dist/script/postinstall.js

@@ -2,43 +2,68 @@ const fs = require('fs');
 const path = require('path');
 
 
-function switchVersion(version) {
-  const pkg = require('../package.json');
-  if (version != 2) {
-    return;
+function printVue2PostCSSWarning() {
+  console.warn('\n');
+  console.warn('⚠️  [TDesign UniApp] 检测到当前使用 Vue2 环境');
+  console.warn('   Vue2 项目需要在 postcss.config.js 中进行适配，否则样式可能无法正常工作。');
+  console.warn('');
+  console.warn('   📖 适配指南: https://juejin.cn/post/7602901195154030644');
+  console.warn('   📦 Vue2 CLI 参考项目: https://github.com/TDesignOteam/tdesign-uniapp-starter-vue2-cli');
+  console.warn('\n');
+}
+
+
+/**
+ * 多重检测 Vue 版本，提升准确性
+ * 优先级：环境变量 > require('vue') > 用户项目 package.json
+ */
+function detectVueVersion() {
+  // 1. 环境变量优先
+  if (process.env.npm_config_vueVersion) {
+    return process.env.npm_config_vueVersion;
   }
 
-  delete pkg.exports;
+  // 2. 尝试直接 require vue
+  try {
+    const Vue = require('vue');
+    if (Vue && Vue.version) return Vue.version;
+  } catch (e) {}
 
-  const pkgStr = JSON.stringify(pkg, null, 2);
+  // 3. 读用户项目的 package.json 中的 vue 版本声明
+  try {
+    const userPkgPath = path.resolve(process.cwd(), 'package.json');
+    const userPkg = JSON.parse(fs.readFileSync(userPkgPath, 'utf-8'));
+    const vueDep = (userPkg.dependencies && userPkg.dependencies.vue)
+      || (userPkg.devDependencies && userPkg.devDependencies.vue);
+    if (vueDep) return vueDep;
+  } catch (e) {}
 
-  fs.writeFileSync(path.resolve(__dirname, '../package.json'), pkgStr, 'utf-8');
+  return null;
 }
 
-
-function loadModule(name) {
-  try {
-    return require(name);
-  } catch (e) {
-    return undefined;
-  }
+function isVue2(version) {
+  if (!version || typeof version !== 'string') return false;
+  // 匹配 "2.x"、"^2.x"、"~2.x"、">=2.x" 等
+  return /(?:^|[~^>=\s])2\./.test(version);
 }
 
-const Vue  = loadModule('vue');
+function isVue3(version) {
+  if (!version || typeof version !== 'string') return false;
+  return /(?:^|[~^>=\s])3\./.test(version);
+}
 
 function main() {
-  const version =  process.env.npm_config_vueVersion || (Vue ? Vue.version : '2.7.');
-  if (!Vue || typeof version !== 'string') {
-    console.warn('Vue is not found. Please run "npm install vue" to install.');
+  const version = detectVueVersion();
+
+  if (!version) {
+    console.warn('[TDesign UniApp] Vue is not found. Please run "npm install vue" to install.');
     return;
   }
 
-  if (version.startsWith('2.')) {
-    switchVersion(2);
-  } else if (version.startsWith('3.')) {
-    switchVersion(3);
-  } else {
-    console.warn(`Vue version v${version} is not supported.`);
+  if (isVue2(version)) {
+    printVue2PostCSSWarning();
+  } else if (!isVue3(version)) {
+    console.warn(`[TDesign UniApp] Vue version ${version} is not supported.`);
   }
 }
 

package/dist/search/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-search />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSearch from '@tdesign/uniapp/search/search.vue';

package/dist/side-bar/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-side-bar />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSideBar from '@tdesign/uniapp/side-bar/side-bar.vue';

package/dist/skeleton/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-skeleton />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSkeleton from '@tdesign/uniapp/skeleton/skeleton.vue';

package/dist/slider/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-slider />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSlider from '@tdesign/uniapp/slider/slider.vue';

package/dist/stepper/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-stepper />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TStepper from '@tdesign/uniapp/stepper/stepper.vue';

package/dist/steps/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-steps />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSteps from '@tdesign/uniapp/steps/steps.vue';

package/dist/sticky/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-sticky />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSticky from '@tdesign/uniapp/sticky/sticky.vue';

package/dist/swipe-cell/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-swipe-cell />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSwipeCell from '@tdesign/uniapp/swipe-cell/swipe-cell.vue';

package/dist/swiper/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-swiper />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSwiper from '@tdesign/uniapp/swiper/swiper.vue';

package/dist/switch/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-switch />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TSwitch from '@tdesign/uniapp/switch/switch.vue';

package/dist/tab-bar/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-tab-bar />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TTabBar from '@tdesign/uniapp/tab-bar/tab-bar.vue';

package/dist/tabs/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-tabs />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TTabs from '@tdesign/uniapp/tabs/tabs.vue';

package/dist/tag/README.md

@@ -8,7 +8,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-tag />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 ```js
 import TTag from '@tdesign/uniapp/tag/tag.vue';

package/dist/textarea/README.md

@@ -9,7 +9,9 @@ isComponent: true
 
 ## 引入
 
-可在 `main.ts` 或在需要使用的页面或组件中引入。
+推荐使用 easycom 模式引入组件，配置后无需手动 import 即可直接在模板中使用 `<t-textarea />`。详细配置请参考 [快速开始](../getting-started)。
+
+如需手动引入：
 
 
 ```js