@jx3box/jx3box-ui 2.0.4 → 2.0.5

package/.storybook/main.js

@@ -0,0 +1,208 @@
+const path = require('path');
+
+const lessResourcePatterns = [
+    path.resolve(__dirname, '../node_modules/@jx3box/jx3box-common/css/var.less'),
+    path.resolve(__dirname, '../node_modules/@jx3box/jx3box-common/css/mixin.less'),
+    path.resolve(__dirname, '../assets/css/var.less'),
+    path.resolve(__dirname, '../assets/css/mixin.less'),
+    path.resolve(__dirname, '../node_modules/csslab/base.less'),
+];
+
+function walkRules(rules, visitor) {
+    if (!Array.isArray(rules)) return;
+    rules.forEach((rule) => {
+        visitor(rule);
+        if (Array.isArray(rule.oneOf)) walkRules(rule.oneOf, visitor);
+        if (Array.isArray(rule.rules)) walkRules(rule.rules, visitor);
+    });
+}
+
+function ensureVueSvgInlineLoader(config) {
+    walkRules(config.module?.rules, (rule) => {
+        if (!Array.isArray(rule.use)) return;
+
+        const hasVueLoader = rule.use.some((use) => {
+            const loader = typeof use === 'string' ? use : use?.loader;
+            return loader && loader.includes('vue-loader');
+        });
+
+        if (!hasVueLoader) return;
+
+        const hasSvgInlineLoader = rule.use.some((use) => {
+            const loader = typeof use === 'string' ? use : use?.loader;
+            return loader && loader.includes('vue-svg-inline-loader');
+        });
+
+        if (!hasSvgInlineLoader) {
+            rule.use.push({
+                loader: require.resolve('vue-svg-inline-loader'),
+            });
+        }
+    });
+}
+
+function ensureLessGlobalResources(config) {
+    walkRules(config.module?.rules, (rule) => {
+        if (!Array.isArray(rule.use)) return;
+
+        for (let i = 0; i < rule.use.length; i += 1) {
+            const currentUse = rule.use[i];
+            const loader = typeof currentUse === 'string' ? currentUse : currentUse?.loader;
+
+            if (!loader || !loader.includes('less-loader')) continue;
+
+            const hasStyleResource = rule.use.some((use) => {
+                const useLoader = typeof use === 'string' ? use : use?.loader;
+                return useLoader && useLoader.includes('style-resources-loader');
+            });
+
+            if (!hasStyleResource) {
+                rule.use.splice(i + 1, 0, {
+                    loader: require.resolve('style-resources-loader'),
+                    options: {
+                        patterns: lessResourcePatterns,
+                    },
+                });
+            }
+
+            break;
+        }
+    });
+}
+
+function removeVueDocgenLoader(config) {
+    walkRules(config.module?.rules, (rule) => {
+        const directLoader = typeof rule.loader === 'string' ? rule.loader : '';
+        if (directLoader.includes('vue-docgen-loader')) {
+            rule.__remove = true;
+            return;
+        }
+
+        if (!Array.isArray(rule.use)) return;
+        rule.use = rule.use.filter((use) => {
+            const loader = typeof use === 'string' ? use : use?.loader;
+            return !(loader && loader.includes('vue-docgen-loader'));
+        });
+    });
+
+    if (Array.isArray(config.module?.rules)) {
+        config.module.rules = config.module.rules.filter((rule) => !rule.__remove);
+    }
+}
+
+function ensureStyleRules(config) {
+    const rules = config.module?.rules || [];
+    const hasLessRule = rules.some((rule) => String(rule.test).includes('less'));
+    const hasScssRule = rules.some((rule) => String(rule.test).includes('scss'));
+    const hasCssRule = rules.some((rule) => String(rule.test).includes('\\.css$'));
+
+    if (hasCssRule) {
+        walkRules(rules, (rule) => {
+            if (!String(rule.test).includes('\\.css$') || !Array.isArray(rule.use)) return;
+            const hasPostcss = rule.use.some((use) => {
+                const loader = typeof use === 'string' ? use : use?.loader;
+                return loader && loader.includes('postcss-loader');
+            });
+            if (!hasPostcss) {
+                rule.use.push({
+                    loader: require.resolve('postcss-loader'),
+                    options: {
+                        postcssOptions: {
+                            config: path.resolve(__dirname, '../postcss.config.js'),
+                        },
+                    },
+                });
+            }
+        });
+    }
+
+    if (!hasLessRule) {
+        rules.push({
+            test: /\.less$/i,
+            use: [
+                require.resolve('style-loader'),
+                {
+                    loader: require.resolve('css-loader'),
+                    options: { importLoaders: 1 },
+                },
+                {
+                    loader: require.resolve('postcss-loader'),
+                    options: {
+                        postcssOptions: {
+                            config: path.resolve(__dirname, '../postcss.config.js'),
+                        },
+                    },
+                },
+                {
+                    loader: require.resolve('less-loader'),
+                    options: {
+                        lessOptions: {
+                            javascriptEnabled: true,
+                        },
+                    },
+                },
+                {
+                    loader: require.resolve('style-resources-loader'),
+                    options: {
+                        patterns: lessResourcePatterns,
+                    },
+                },
+            ],
+        });
+    }
+
+    if (!hasScssRule) {
+        rules.push({
+            test: /\.s[ac]ss$/i,
+            use: [
+                require.resolve('style-loader'),
+                require.resolve('css-loader'),
+                {
+                    loader: require.resolve('postcss-loader'),
+                    options: {
+                        postcssOptions: {
+                            config: path.resolve(__dirname, '../postcss.config.js'),
+                        },
+                    },
+                },
+                require.resolve('sass-loader'),
+            ],
+        });
+    }
+
+    config.module.rules = rules;
+}
+
+/** @type { import('@storybook/vue3-webpack5').StorybookConfig } */
+module.exports = {
+    stories: ['../src/**/*.stories.@(js|jsx|ts|tsx|mdx)'],
+    addons: [
+        {
+            name: '@storybook/addon-essentials',
+            options: {
+                docs: false,
+            },
+        },
+        '@storybook/addon-interactions',
+    ],
+    framework: {
+        name: '@storybook/vue3-webpack5',
+        options: {
+            docgen: false,
+        },
+    },
+    webpackFinal: async (config) => {
+        config.resolve = config.resolve || {};
+        config.resolve.alias = {
+            ...(config.resolve.alias || {}),
+            '@': path.resolve(__dirname, '../src'),
+        };
+
+        removeVueDocgenLoader(config);
+        ensureStyleRules(config);
+        ensureVueSvgInlineLoader(config);
+        ensureLessGlobalResources(config);
+
+        return config;
+    },
+};

package/.storybook/preview.js

@@ -0,0 +1,84 @@
+import { setup } from '@storybook/vue3';
+import ElementPlus from 'element-plus';
+import zhCn from 'element-plus/es/locale/lang/zh-cn';
+import * as ElementPlusIconsVue from '@element-plus/icons-vue';
+import axios from 'axios';
+
+import { Jx3boxUiI18n } from '../i18n';
+import navData from '../assets/data/nav.json';
+import boxData from '../assets/data/box.json';
+
+import '@jx3box/jx3box-common/css/normalize.css';
+import '@jx3box/jx3box-common/css/font.css';
+import 'element-plus/dist/index.css';
+import '@jx3box/jx3box-common/css/tailwind.css';
+
+let axiosPatched = false;
+
+function patchAxiosForStorybook() {
+    if (axiosPatched) return;
+
+    const originalGet = axios.get.bind(axios);
+    axios.get = (url, ...args) => {
+        if (typeof url === 'string' && url.includes('/config/global.json')) {
+            return Promise.resolve({
+                data: {
+                    token_version: 'storybook',
+                },
+            });
+        }
+        return originalGet(url, ...args);
+    };
+
+    axiosPatched = true;
+}
+
+function bootstrapRuntimeData() {
+    try {
+        sessionStorage.setItem('nav', JSON.stringify(navData));
+        sessionStorage.setItem('box', JSON.stringify(boxData));
+    } catch (e) {
+        // ignore session storage failures in restricted contexts
+    }
+
+    try {
+        localStorage.removeItem('token');
+        localStorage.removeItem('uid');
+        localStorage.removeItem('group');
+        localStorage.removeItem('created_at');
+        localStorage.removeItem('name');
+        localStorage.removeItem('status');
+        localStorage.removeItem('avatar');
+    } catch (e) {
+        // ignore local storage failures in restricted contexts
+    }
+}
+
+setup((app) => {
+    app.use(Jx3boxUiI18n, { locale: 'zh-CN' });
+    app.use(ElementPlus, { locale: zhCn });
+
+    for (const [name, component] of Object.entries(ElementPlusIconsVue)) {
+        app.component(name, component);
+    }
+});
+
+patchAxiosForStorybook();
+
+export const decorators = [
+    (story) => {
+        bootstrapRuntimeData();
+        return story();
+    },
+];
+
+export const parameters = {
+    actions: { argTypesRegex: '^on[A-Z].*' },
+    controls: {
+        matchers: {
+            color: /(background|color)$/i,
+            date: /Date$/i,
+        },
+    },
+    layout: 'fullscreen',
+};

package/README.md

@@ -5,40 +5,32 @@
 
 ## 模块
 
-### 个人模块 author
-
-一般用于文章详情的左侧边栏
+### 全局
+- CommonHeader 公共头
+- Breadcrumb 面包屑
+- Main 默认内容框架（非必须）
+- LeftSidebar 左侧边栏（非必须）
+- LeftSideToggle 左侧边栏触发器（非必须，可独立使用）
+- RightSidebar 右侧边栏（非必须）
+- CommonFooter 公共底
+- SuspendCommon 移动侧浮窗底（此组件需要手动引入）
+
+### 内容单页 single
 
--   AuthorFans 粉丝榜
--   AuthorFollow 关注用户（区分rss，此处用户更新不会收到消息）
--   AuthorGift 打赏用户
--   AuthorHonor 用户称号
--   AuthorInfo 用户基础信息
--   AuthorLink 用户绑定平台账号（微博，github，直播间）
--   AuthorMedals 用户勋章
--   AuthorPosts 用户作品
--   AuthorRss 订阅用户
--   AuthorTeams 所在团队
--   Avatar 头像
--   UserPop 搜索用户弹窗
--   
-
-### 管理员模块 bread
-
-一般用于文章详情的右上角管理按钮
-
-- AdminDrop 管理模块触发器
-- Admin 文章管理模块（管理员）
-- AdminDirectMessage 管理员私信
-- Crumb 栏目动态
-- DesignTask 设计任务
-
-
-### 评论模块 comment
+主要是用于详情页的展示内容
 
-文章评论模块，用途包括反馈中心，文章详情评论
+- CmsSingle 单页框架
+- Author 侧边栏作者信息整合
+- PostDirectory 目录
+- PostHeader 创作信息
+- Creators 联合创作
+- Collection 小册
+- Article 文章内容
+- Thx 交互组件
+- SimpleThx 交互组件简化版（仅PVP栏目使用，需要手动引入）
+- Comment 评论
 
-### 筛选模块 filters
+### 筛选模块 list
 
 主要用于各栏目的列表筛选
 
@@ -46,58 +38,26 @@
 - markBy 标记筛选
 - menuBy 通用筛选
 - orderBy 排序筛选
-- tagBy 
+- tagBy 标签筛选
 - topicBy 主题筛选
 - versionBy 版本筛选
 - zlpBy 资料片筛选
 
+### 个人模块 author
 
-### 顶部模块
-
-主要是header的模块
-
-- alternate 马甲切换
-- asset 用户资产
-- box 魔盒矩阵（移动端）
-- box2 魔盒矩阵（PC）
-- client 客户端切换
-- lang 语言切换
-- logo
-- manage 后台管理入口
-- message 消息中心入口
-- nav 导航栏
-- publish 创作中心入口
-- search 搜索框
-- shop 商城入口
-- user 用户头像+信息pop
-- 会员中心入口
-
-### 交互模块
-
-主要是文章详情中用于用户交互的组件，包含打赏，分享，收藏等等
-
-- BoxcoinAdmin 管理员品鉴
-- BoxcoinRecords 品鉴+打赏记录
-- BoxcoinUser 用户打赏
-- Contributors 多人合作文章中打赏目标选择
-- Fav 收藏
-- Like 点赞
-- Rss 订阅
-- Share 分享
-- WatchLater 稍后再看
-
+一般用于文章详情的左侧边栏，个人主页等
 
-### 单页
+-   Avatar 头像
+-   AuthorFans 粉丝榜
+-   AuthorFollow 关注用户（区分rss，此处用户更新不会收到消息）
+-   AuthorGift 打赏用户
+-   AuthorHonor 用户称号
+-   AuthorInfo 用户基础信息
+-   AuthorLink 用户绑定平台账号（微博，github，直播间）
+-   AuthorMedals 用户勋章
+-   AuthorPosts 用户作品
+-   AuthorRss 订阅用户
+-   AuthorTeams 所在团队
+-   UserPop 搜索用户弹窗
 
-主要是用于详情页的展示内容
 
-- Author 侧边栏作者信息
-- CmsSingle 单页框架
-- Collection 小册
-- Comment 评论
-- Creators 联合创作
-- PostDirectory 目录
-- PostHeader 创作信息
-- PostTopic 右侧边栏头条
-- SimpleThx 简单交互组件集合
-- Thx 交互组件

package/package.json

@@ -1,12 +1,14 @@
 {
     "name": "@jx3box/jx3box-ui",
-    "version": "2.0.4",
+    "version": "2.0.5",
     "description": "JX3BOX Vue3 UI",
     "main": "index.js",
     "scripts": {
         "dev": "vue-cli-service serve --mode development",
         "serve": "vue-cli-service serve --mode production",
         "debug": "vue-cli-service serve --mode debug",
+        "storybook": "storybook dev -p 6006",
+        "build-storybook": "storybook build",
         "build": "npm run build:prod",
         "build:dev": "cross-env NODE_OPTIONS=--max-old-space-size=4096 vue-cli-service build --mode development",
         "build:prod": "cross-env NODE_OPTIONS=--max-old-space-size=4096 vue-cli-service build --mode production",
@@ -31,7 +33,7 @@
     },
     "dependencies": {
         "@element-plus/icons-vue": "^2.3.2",
-        "@jx3box/jx3box-common": "^9.1.0",
+        "@jx3box/jx3box-common": "^9.1.1",
         "@jx3box/jx3box-data": "^3.9.2",
         "@jx3box/jx3box-emotion": "^1.3.0",
         "@jx3box/jx3box-macro": "^1.0.3",
@@ -60,6 +62,10 @@
     "devDependencies": {
         "@babel/core": "^7.12.16",
         "@babel/eslint-parser": "^7.28.6",
+        "@storybook/addon-essentials": "^8.6.18",
+        "@storybook/addon-interactions": "^8.6.18",
+        "@storybook/test": "^8.6.18",
+        "@storybook/vue3-webpack5": "^8.6.18",
         "@tailwindcss/postcss": "^4.2.1",
         "@vue/cli-plugin-babel": "~5.0.0",
         "@vue/cli-plugin-eslint": "~5.0.0",
@@ -77,6 +83,7 @@
         "prettier": "2.7.1",
         "sass": "^1.97.3",
         "sass-loader": "^16.0.7",
+        "storybook": "^8.6.18",
         "style-resources-loader": "^1.5.0",
         "tailwindcss": "^4.2.1",
         "vue-svg-inline-loader": "^2.1.3"

package/src/CommonFooter.vue

@@ -3,10 +3,10 @@
         <div class="mx-auto w-full" style="max-width: 92rem">
             <div class="grid grid-cols-1 gap-10 pb-10 lg:grid-cols-12 lg:gap-8">
                 <section class="lg:col-span-3">
-                    <div class="flex items-center space-x-3">
+                    <a class="flex items-center space-x-3 cursor-pointer" href="/">
                         <img class="u-logo h-9 w-9" svg-inline src="../assets/img/common/logo.svg" alt="JX3BOX" />
                         <span class="text-2xl font-bold tracking-tight text-white">JX3BOX</span>
-                    </div>
+                    </a>
                     <p class="mt-5 text-sm leading-7 text-gray-400" style="max-width: 20rem">
                         {{ $jx3boxT("jx3boxUi.footer.slogan1", "一站式剑三工具与资源聚合站。") }}<br />
                         {{ $jx3boxT("jx3boxUi.footer.slogan2", "江湖路远，幸甚有你。") }}

package/src/footer/resource.vue

@@ -17,9 +17,35 @@
                     <template #reference>
                         <a
                             class="flex h-12 items-center rounded-xl border border-gray-700 bg-gray-800 px-4 text-xs text-gray-300 transition hover:border-blue-500 hover:bg-gray-700"
-                            :href="item.href || 'javascript:;'"
+                            :href="item.href || '#'"
                             :target="item.href ? '_blank' : null"
                             :rel="item.href ? 'noopener noreferrer' : null"
+                            @click="handleLinkClick($event, item)"
+                        >
+                            <span class="mr-2.5 flex h-4 w-4 items-center justify-center">
+                                <img class="h-4 w-4" :src="item.icon" :alt="getDownloadName(item)" />
+                            </span>
+                            <span>{{ getDownloadName(item) }}</span>
+                        </a>
+                    </template>
+                </el-popover>
+                <el-popover
+                    v-else-if="item.placeholder"
+                    trigger="hover"
+                    placement="top"
+                    :show-after="150"
+                    popper-class="c-footer--v4__popover"
+                >
+                    <div class="p-3 text-center text-xs font-semibold">
+                        {{ item.placeholder }}
+                    </div>
+                    <template #reference>
+                        <a
+                            class="flex h-12 items-center rounded-xl border border-gray-700 bg-gray-800 px-4 text-xs text-gray-300 transition hover:border-blue-500 hover:bg-gray-700"
+                            :href="item.href || '#'"
+                            :target="item.href ? '_blank' : null"
+                            :rel="item.href ? 'noopener noreferrer' : null"
+                            @click="handleLinkClick($event, item)"
                         >
                             <span class="mr-2.5 flex h-4 w-4 items-center justify-center">
                                 <img class="h-4 w-4" :src="item.icon" :alt="getDownloadName(item)" />
@@ -31,9 +57,10 @@
                 <a
                     v-else
                     class="flex h-12 items-center rounded-xl border border-gray-700 bg-gray-800 px-4 text-xs text-gray-300 transition hover:border-blue-500 hover:bg-gray-700"
-                    :href="item.href || 'javascript:;'"
+                    :href="item.href || '#'"
                     :target="item.href ? '_blank' : null"
                     :rel="item.href ? 'noopener noreferrer' : null"
+                    @click="handleLinkClick($event, item)"
                 >
                     <span class="mr-2.5 flex h-4 w-4 items-center justify-center">
                         <img class="h-4 w-4" :src="item.icon" :alt="getDownloadName(item)" />
@@ -98,6 +125,7 @@ export default {
                     href: "",
                     icon: require("../../assets/img/common/ios.svg"),
                     // qrcode: require("../../assets/img/common/ios.jpg"),
+                    placeholder: "即将上线",
                 },
                 {
                     key: "android",
@@ -105,6 +133,7 @@ export default {
                     href: "",
                     icon: require("../../assets/img/common/android.svg"),
                     // qrcode: require("../../assets/img/common/android.jpg"),
+                    placeholder: "即将上线",
                 },
                 {
                     key: "harmonyNext",
@@ -112,6 +141,7 @@ export default {
                     href: "",
                     icon: require("../../assets/img/common/harmony.svg"),
                     // qrcode: require("../../assets/img/common/harmony.jpg"),
+                    placeholder: "即将上线",
                 },
                 {
                     key: "miniProgram",
@@ -141,6 +171,9 @@ export default {
             if (item?.labelKey) return this.$jx3boxT(`jx3boxUi.footer.${item.labelKey}`, item.label || item.labelKey);
             return item?.label || "";
         },
+        handleLinkClick(e, item) {
+            if (!item?.href) e.preventDefault();
+        },
     },
     created: function () {},
     mounted: function () {},

package/src/header/box2.vue

@@ -92,11 +92,16 @@ export default {
             return this.data.filter((item) => {
                 const currentClient = String(this.client || "").toLowerCase();
                 const rawClient = item.client;
-                const matchedClient = !rawClient
-                    ? true
+                const clients = !rawClient
+                    ? []
                     : Array.isArray(rawClient)
-                    ? rawClient.map((c) => String(c || "").toLowerCase()).includes(currentClient)
-                    : String(rawClient || "").toLowerCase().includes(currentClient);
+                    ? rawClient.map((c) => String(c || "").toLowerCase())
+                    : String(rawClient || "")
+                          .split(",")
+                          .map((c) => String(c || "").trim().toLowerCase())
+                          .filter(Boolean);
+                const matchedClient =
+                    !clients.length || clients.includes("all") || clients.includes(currentClient);
                 return matchedClient;
             });
         },

package/src/stories/layout/CommonFooter.stories.js

@@ -0,0 +1,22 @@
+import CommonFooter from '../../CommonFooter.vue';
+
+const meta = {
+    title: 'Layout/CommonFooter',
+    component: CommonFooter,
+    parameters: {
+        layout: 'fullscreen',
+    },
+};
+
+export default meta;
+
+export const Default = {
+    render: () => ({
+        components: { CommonFooter },
+        template: `
+            <div style="min-height: 100vh; display: flex; align-items: flex-end; background: #111827;">
+                <CommonFooter style="width: 100%;" />
+            </div>
+        `,
+    }),
+};

package/src/stories/layout/CommonHeader.stories.js

@@ -0,0 +1,39 @@
+import CommonHeader from '../../CommonHeader.vue';
+
+const meta = {
+    title: 'Layout/CommonHeader',
+    component: CommonHeader,
+    parameters: {
+        layout: 'fullscreen',
+    },
+    argTypes: {
+        overlayEnable: { control: 'boolean' },
+    },
+};
+
+export default meta;
+
+export const Default = {
+    args: {
+        overlayEnable: false,
+    },
+    render: (args) => ({
+        components: { CommonHeader },
+        setup() {
+            return { args };
+        },
+        template: `
+            <div style="min-height: 200vh; background: linear-gradient(180deg, #0b1220 0%, #1f2937 100%);">
+                <CommonHeader v-bind="args" />
+                <div style="height: 1600px;"></div>
+            </div>
+        `,
+    }),
+};
+
+export const Overlay = {
+    args: {
+        overlayEnable: true,
+    },
+    render: Default.render,
+};