@tzk-design-vue2/shared 1.0.0

package/utils/platform.js

@@ -0,0 +1,179 @@
+/**
+ * 平台判断工具函数
+ */
+
+/* eslint-disable no-unreachable */
+
+/**
+ * 获取系统信息
+ * @returns {Object}
+ */
+let systemInfo = null;
+
+export function getSystemInfo() {
+  if (systemInfo) return systemInfo;
+
+  try {
+    systemInfo = uni.getSystemInfoSync();
+  } catch (e) {
+    systemInfo = {};
+  }
+
+  return systemInfo;
+}
+
+/**
+ * 是否为微信小程序
+ * @returns {boolean}
+ */
+export function isWeixin() {
+  // #ifdef MP-WEIXIN
+  return true;
+  // #endif
+  // #ifndef MP-WEIXIN
+  return false;
+  // #endif
+}
+
+/**
+ * 是否为支付宝小程序
+ * @returns {boolean}
+ */
+export function isAlipay() {
+  // #ifdef MP-ALIPAY
+  return true;
+  // #endif
+  // #ifndef MP-ALIPAY
+  return false;
+  // #endif
+}
+
+/**
+ * 是否为百度小程序
+ * @returns {boolean}
+ */
+export function isBaidu() {
+  // #ifdef MP-BAIDU
+  return true;
+  // #endif
+  // #ifndef MP-BAIDU
+  return false;
+  // #endif
+}
+
+/**
+ * 是否为字节跳动小程序
+ * @returns {boolean}
+ */
+export function isToutiao() {
+  // #ifdef MP-TOUTIAO
+  return true;
+  // #endif
+  // #ifndef MP-TOUTIAO
+  return false;
+  // #endif
+}
+
+/**
+ * 是否为 QQ 小程序
+ * @returns {boolean}
+ */
+export function isQQ() {
+  // #ifdef MP-QQ
+  return true;
+  // #endif
+  // #ifndef MP-QQ
+  return false;
+  // #endif
+}
+
+/**
+ * 是否为 H5
+ * @returns {boolean}
+ */
+export function isH5() {
+  // #ifdef H5
+  return true;
+  // #endif
+  // #ifndef H5
+  return false;
+  // #endif
+}
+
+/**
+ * 是否为 App
+ * @returns {boolean}
+ */
+export function isApp() {
+  // #ifdef APP-PLUS
+  return true;
+  // #endif
+  // #ifndef APP-PLUS
+  return false;
+  // #endif
+}
+
+/**
+ * 是否为小程序环境
+ * @returns {boolean}
+ */
+export function isMiniProgram() {
+  return isWeixin() || isAlipay() || isBaidu() || isToutiao() || isQQ();
+}
+
+/**
+ * 是否为 iOS
+ * @returns {boolean}
+ */
+export function isIOS() {
+  const system = getSystemInfo();
+  return system.platform === 'ios';
+}
+
+/**
+ * 是否为 Android
+ * @returns {boolean}
+ */
+export function isAndroid() {
+  const system = getSystemInfo();
+  return system.platform === 'android';
+}
+
+/**
+ * 获取平台名称
+ * @returns {string}
+ */
+export function getPlatform() {
+  if (isWeixin()) return 'weixin';
+  if (isAlipay()) return 'alipay';
+  if (isBaidu()) return 'baidu';
+  if (isToutiao()) return 'toutiao';
+  if (isQQ()) return 'qq';
+  if (isH5()) return 'h5';
+  if (isApp()) return 'app';
+  return 'unknown';
+}
+
+/**
+ * rpx 转 px
+ * @param {number} rpx - rpx 值
+ * @returns {number}
+ */
+export function rpxToPx(rpx) {
+  const system = getSystemInfo();
+  const screenWidth = system.screenWidth || 375;
+  return (rpx / 750) * screenWidth;
+}
+
+/**
+ * px 转 rpx
+ * @param {number} px - px 值
+ * @returns {number}
+ */
+export function pxToRpx(px) {
+  const system = getSystemInfo();
+  const screenWidth = system.screenWidth || 375;
+  return (px / screenWidth) * 750;
+}
+
+/* eslint-enable no-unreachable */

package/utils/type.js

@@ -0,0 +1,105 @@
+/**
+ * 类型判断工具函数
+ */
+
+/**
+ * 获取数据类型
+ * @param {*} value
+ * @returns {string}
+ */
+export function getType(value) {
+  return Object.prototype.toString.call(value).slice(8, -1).toLowerCase();
+}
+
+/**
+ * 是否为字符串
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isString(value) {
+  return typeof value === 'string';
+}
+
+/**
+ * 是否为数字
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isNumber(value) {
+  return typeof value === 'number' && !isNaN(value);
+}
+
+/**
+ * 是否为布尔值
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isBoolean(value) {
+  return typeof value === 'boolean';
+}
+
+/**
+ * 是否为数组
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isArray(value) {
+  return Array.isArray(value);
+}
+
+/**
+ * 是否为对象
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isObject(value) {
+  return value !== null && typeof value === 'object' && !isArray(value);
+}
+
+/**
+ * 是否为函数
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isFunction(value) {
+  return typeof value === 'function';
+}
+
+/**
+ * 是否已定义
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isDef(value) {
+  return value !== undefined && value !== null;
+}
+
+/**
+ * 是否未定义
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isUndef(value) {
+  return value === undefined || value === null;
+}
+
+/**
+ * 是否为空
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isEmpty(value) {
+  if (isUndef(value)) return true;
+  if (isArray(value) || isString(value)) return value.length === 0;
+  if (isObject(value)) return Object.keys(value).length === 0;
+  return false;
+}
+
+/**
+ * 是否为 Promise
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isPromise(value) {
+  return isDef(value) && isFunction(value.then) && isFunction(value.catch);
+}

package/utils/warn.js

@@ -0,0 +1,64 @@
+/**
+ * 开发环境警告系统
+ */
+
+/**
+ * 打印警告信息
+ * @param {string} message - 警告信息
+ * @param {Object} context - 上下文
+ */
+export function warn(message, context) {
+  if (process.env.NODE_ENV === 'production') return;
+
+  console.warn(`[TZK Warn] ${message}`);
+
+  if (context) {
+    console.warn('[TZK Warn Context]', context);
+  }
+}
+
+/**
+ * Props 类型校验警告
+ * @param {string} propName - 属性名
+ * @param {*} value - 属性值
+ * @param {string} expectedType - 期望类型
+ * @param {string} componentName - 组件名
+ */
+export function warnPropType(propName, value, expectedType, componentName) {
+  const actualType = typeof value;
+  warn(
+    `Invalid prop: type check failed for prop "${propName}". Expected ${expectedType}, got ${actualType}.`,
+    { componentName, propName, value }
+  );
+}
+
+/**
+ * 废弃 API 警告
+ * @param {string} oldApi - 旧 API
+ * @param {string} newApi - 新 API
+ * @param {string} version - 废弃版本
+ */
+export function warnDeprecated(oldApi, newApi, version) {
+  warn(
+    `"${oldApi}" is deprecated and will be removed in version ${version}. Please use "${newApi}" instead.`
+  );
+}
+
+/**
+ * 性能警告
+ * @param {string} message - 警告信息
+ * @param {Object} data - 数据
+ */
+export function warnPerformance(message, data) {
+  warn(`Performance warning: ${message}`, data);
+}
+
+/**
+ * 最佳实践建议
+ * @param {string} message - 建议信息
+ */
+export function suggestBestPractice(message) {
+  if (process.env.NODE_ENV === 'production') return;
+
+  console.info(`[TZK Suggestion] ${message}`);
+}