Howdy
theme-lighttheme-dark

Dashboard自定义面板项目介绍

May 29, 2021

项目介绍

Dashboard是一个笔者基于Vite + Vue3 + Typesript开发的项目,个性化的浏览器导航首页面板,支持自定义添加组件,可编辑组件各种属性。响应式设计,可自定义随机壁纸背景图。

功能特性

✨组件长度单位

面板可基于响应式设计布局,添加组件时可选择FR单位,FR单位会基于当前屏幕宽度动态计算出组件宽度。当然也可以使用PX固定长度单位,一般建议是宽度使用FR而高度使用PX

组件长度单位

💫布局模式

当前提供两种布局模式,默认布局是基于文档流的,使用vuedraggable可拖拽改变组件顺序。另一种是Fixed模式,是基于Fixed定位的,使用@howdyjs/to-drag拖拽改变位置。

🍭编辑模式

添加的组件含有较多配置可自定义,不限于背景颜色、阴影、字体颜色大小与组件属性等。点击右下方菜单解除锁定后即可进入编辑模式,编辑模式下通过右键点击组件即可弹出菜单进行编辑(移动端下是长按弹出菜单),右键菜单基于@howdyjs/mouse-menu

🍌数据同步

点击右下方辅助功能进入导入导出面板,现在支持两种同步方式,一种是生成随机码进行同步,另一种是导出JSON文件进行同步。后续有可能考虑会添加账户功能进行同步。

🎉默认主题

当前首次进入网站,会弹出默认主题选择,用户可先选择一种默认主题再进行二次创作。

🌟随机图片与动态壁纸

网站背景图与组件背景可以设置使用随机图片,图片来源于Unsplash的随机图片,可选自定义关键词,并提供了可选的国内镜像加速(由多吉提供,服务暂未稳定)。最新已加入动态壁纸的支持,选择背景图时选择网络图片后输入一个网络视频路径即会识别成动态壁纸。

🌈多种物料组件

当前提供了多种物料组件,例如时钟、天气、搜索栏等,后面会陆续添加更多的组件。组件引入采用按需加载,没有使用的组件不会在初始化时加载。

物料组件选择

物料组件

  • Empty: 占位区块组件,支持一些简单配置与自定义文本

占位区块

  • Clock: 时钟组件

时钟

  • Verse: 随机古诗组件,API来源于https://www.jinrishici.com/

随机古诗

  • Search: 搜索栏,支持自定义搜索引擎,按Tab键自动切换下一个,关键词联想

搜索栏

  • Collection: 键盘收藏夹,设置网站后按相应按键自动跳转,网站Icon自动获取

键盘收藏夹

  • Iframe: Iframe外部网站,最新版浏览器只支持同协议(当前网站为https)的Iframe

Iframe外部网站

  • TodoList: 备忘清单,可同时设置不同日期

TodoList备忘清单

  • Weather: 天气组件,支持通过IP自动获取城市也可手动输入,后续考虑添加读取GPS

天气

  • CountDown: 倒计时组件,支持天、小时、分钟三种单位

倒计时组件

  • JuejinList: 掘金组件,显示最新热门列表

掘金组件

  • WeiboList:微博热搜

微博热搜

  • GithubTrending: Github趋势,显示当日热门仓库

Github趋势

项目相关

StandardForm表单封装

项目中使用了ElementPlus框架,为了减轻代码量与抽离复用逻辑,封装了一个StandardForm组件,可以使用jsx文件生成Element表单。

各物料组件需提供一个自己的setting.tsx文件为该组件的配置,同时将可复用的配置项抽离出来。

例如: Weather组件的setting.tsx

// @/materials/Weather/setting.tsx
import pick from '../base'
export default {
  formData: {
    weatherMode: 1,
    cityName: '',
    duration: 15,
    position: 5,
    baseFontSize: 16,
    textColor: '#262626',
    textShadow: '0 0 1px #464646',
    iconShadow: '0 0 1px #464646',
    fontFamily: '',
    padding: 10
  },
  formConf (formData: any) {
    return {
      weatherMode: {
        label: '天气城市',
        type: 'radio-group',
        radio: {
          list: [
            {
              name: '自动获取(IP)',
              value: 1
            },
            {
              name: '手动输入',
              value: 2
            }
          ],
          label: 'name',
          value: 'value'
        }
      },
      cityName: {
        when: (formData: any) => formData.weatherMode === 2,
        type: 'input',
        attrs: {
          placeholder: '请输入城市名(目前仅支持中国城市名)',
          clearable: true
        },
        rules: [{
          required: true,
          validator: (rule: any, value: any, callback: Function) => {
            if (formData.weatherMode === 2 && !value) {
              callback(new Error('请输入城市名'))
            }
            callback();
          }
        }]
      },
      duration: {
        label: '自动刷新频率',
        type: 'input-number',
        attrs: {
          'controls-position': 'right',
          min: 5,
          max: 12 * 60
        },
        tips: '刷新频率,单位为分钟'
      },
      ...pick(formData, [
        'position',
        'baseFontSize',
        'textColor',
        'textShadow',
        'iconShadow',
        'fontFamily',
        'padding'
      ])
    }
  }
}

formConf需要传入一个参数为formData函数以作为vModel的双向绑定

字体选择器

组件有一个公用的属性是设置字体,需要获取到用户系统的自带字体列表。参考《小tips: 使用JS检测用户是否安装某font-family字体》(张鑫旭)后,抽离出判断getSupportFontFamilyList方法。

原理是利用canvas画出设置后的字体,看它是否与默认字体生成的一样,如果一样则说明不支持,不一样说明新字体设置生效,用户支持该字体。

同时后面有可能考虑加入Google Font支持自定义字体。

Todo

  • 更多的物料组件
  • Service worker存储图片缓存(已完成)
  • Chrome extension添加浏览器插件模式(已完成)
  • Electorn桌面应用模式(已完成)

项目仍在持续开发及优化中,若文章或项目中有做的不好的地方欢迎指出,不胜感激。


to-top