Giter VIP home page Giter VIP logo

qmui_web's Introduction

Banner

QMUI Web Version Number

一个旨在提高 UI 开发效率、快速产生项目 UI 的前端框架

官网:http://qmuiteam.com/web

下载 Demo:https://github.com/QMUI/QMUIDemo_Web/releases

[English] / [简体中文] / [繁體中文]

Build Status Build status QMUI Team Name License

QMUI Web 是一个专注 Web UI 开发,帮助开发者快速实现特定的一整套设计的框架。框架主要由一个强大的 SASS 方法合集与内置的工作流构成。通过 QMUI Web,开发者可以很轻松地提高 Web UI 开发的效率,同时保持了项目的高可维护性与稳健。如果你需要方便地控制项目的整体样式,或者需要应对频繁的界面变动,那么 QMUI Web 框架将会是你最好的解决方案。

功能特性

基础配置与组件

通过内置的公共组件和对应的 SASS 配置表,你只需修改简单的配置即可快速实现所需样式的组件。(QMUI SASS 配置表和公共组件如何帮忙开发者快速搭建项目基础 UI?

SASS 增强支持

QMUI Web 包含70个 SASS mixin/function/extend,涉及布局、外观、动画、设备适配、数值计算以及 SASS 原生能力增强等多个方面,可以大幅提升开发效率。

完善的内置工作流

QMUI Web 内置的工作流拥有从初始化项目到变更文件的各种自动化处理,包含了模板引擎,雪碧图处理,图片集中管理与自动压缩,静态资源合并、压缩与变更以及冗余文件清理等功能。

扩展组件

QMUI Web 除了内置的公共组件外,还通过扩展的方式提供了常用的扩展组件,如等高左右双栏,文件上传按钮,树状选择菜单。

环境配置

请确保安装 Node.js(建议 14.0 或以上版本),并用以下命令全局安装 gulp:

#安装 gulp
npm install --global gulp

快速开始

推荐使用 Yeoman 脚手架 generator-qmui 安装和配置 QMUI Web。该工具可以帮助你完成 QMUI Web 的所有安装和配置。

#安装 Yeoman,如果本地已安装可以忽略
npm install -g yo
#安装 QMUI 的模板
npm install -g generator-qmui
#在项目根目录执行以下命令
yo qmui

效果预览

完成后生成的项目目录结构

项目根目录
├─public          // 静态资源目录,由 gulp 生成
│  ├─js           // 静态资源 js 文件
│  └─style        // 静态资源 UI 文件
│     ├─css       // 静态资源 css 文件
│     └─images    // 静态资源 images 文件
├─UI_dev          // 实际进行开发的样式目录
│  ├─project      // 项目相关 SASS 与 images 文件,由 gulp 生成
│  │  ├─images    // 项目相关图片文件
│  │  ├─logic     // 项目相关逻辑样式
│  │  └─widget    // 项目相关公共组件样式
│  └─qmui_web     // QMUI Web 主源码应放置在这一层目录
├─UI_html         // 静态模板目录
└─UI_html_result  // 静态模板 gulp 处理后的版本,用于前端拼接最终的模板

对于需要有更强定制性的开发者,请参考创建新项目(高级)

工作流任务列表

#在 UI_dev/qmui_web 中执行以下命令可以查看工作流的任务列表及说明
gulp list

也可以查看文档中的详细说明

完善框架

如果有意见反馈或者功能建议,欢迎创建 Issue 或发送 Pull Request,调试与修改框架请先阅读文档,感谢你的支持和贡献。

设计稿 Sketch 源文件可在 Dribbble 上获取。

QMUI Web Desktop

推荐配合使用的桌面 App:QMUI Web Desktop。它可以管理基于 QMUI Web 进行开发的项目,通过 GUI 界面处理 QMUI Web 的服务开启/关闭,使框架的使用变得更加便捷,并提供了编译提醒,出错提醒,进程关闭提醒等额外的功能。

QMUI Web Desktop

qmui_web's People

Contributors

dependabot[bot] avatar jeff2ma avatar jostinsu avatar kayo5994 avatar zhuangya avatar zzefff avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

qmui_web's Issues

text_multiLine_ellipsis兼容性问题及末行间距Bug

在firefox47中无效,测试结果如图:
02
另外请注意上图,我设置的行高为60px,2行。chrome及safari中当启用两行限制后,明显发现两行的截断最后一行是会忽略行高的,这就意味着在不确定内容是一行还是多行的时候,该元素与下面的元素间距无法被合理控制。

萌新求指导~

大佬好,打扰大佬了,我是一名iOS开发者,目前在VX QMUI交流群里面,想接触一下web的东西,下载了QMUI_web,也部署好了,但是还不太会用,我试着去修改UI_html里面的index.html文件,着实是生效了,并且在UI_result里面生成了对应的文件。但是我在修改public.style.css.main.css 即时也是生效的。问题来了,我再一次gulp start的时候,对应css的修改又被恢复在原来的状态。貌似得在project文件夹里面进行业务修改(css修改)么?萌新还不太了解这个机制,能否稍微指导一下,我现在只是想通过直接修改demo的文件,来了解一下web的东西,暂时只是想搭一个个人网站,但是也没太多的精力搞,只能先这样了。麻烦大佬了。 我就是想通过修改一些文件,达到我想要UI就可以,请问我需要在哪修改css样式?

ui项目图片要放置到哪里呢?我放到ui_dev-project-images目录下不会自动发布到public中啊?

在提交 Issues 时,请尽量添加以下信息,这将有助于你的 Issues 能更及时、更妥当地被回复和解决。另外,可以检查你所运行的 QMUI Web 版本是否为 最新版本,因为问题可能已经被修复。

以上为提交 Issues 的模板说明文字,提交 Issues 时请删除。


运行环境

  • 操作系统版本:macOS (10.x) / Windows (7/8/10) / Linux / 其他(自行填写具体系统)
  • QMUI Web 版本:1.x.x
  • Node.js 版本:4.x.x

具体问题描述

问题截图

执行yo qmui创建项目不成功

运行环境

  • 操作系统版本:centOS (6.5 x86)
  • QMUI Web 版本:1.3.1
  • Node.js 版本:7.1.0

具体问题描述

执行yo qmui创建项目不成功

问题截图

[20:41:05] QMUI Config: 开始进入项目配置
? 项目名称: 137
? 项目前缀(用于公共组件的 Class-name ): g
? 项目主样式表文件名 main.scss
? 是否开启模板引擎(增强静态模板 include,条件判断,传参等能力)? Yes
? 是否开启 BrowserSync(修改后自动刷新浏览器)? Yes
? BrowserSync 的端口号 3030
? 是否显示 BrowserSync 的日志 Yes
[20:41:17] QMUI Install: 写入项目结构
[20:41:17] QMUI Install: 安装最新版本的 QMUI Web

events.js:160
throw er; // Unhandled 'error' event
^
AssertionError: Trying to copy from a source that does not exist: /data/www/html/137/UI_dev/qmui_web/config.js
at EditionInterface.exports._copySingle (/usr/local/lib/node_modules/generator-qmui/node_modules/mem-fs-editor/lib/actions/copy.js:45:3)
at EditionInterface.exports.copy (/usr/local/lib/node_modules/generator-qmui/node_modules/mem-fs-editor/lib/actions/copy.js:23:17)
at child.writing (/usr/local/lib/node_modules/generator-qmui/generators/app/index.js:127:13)
at Object. (/usr/local/lib/node_modules/generator-qmui/node_modules/yeoman-generator/lib/base.js:439:23)
at /usr/local/lib/node_modules/generator-qmui/node_modules/run-async/index.js:26:25
at /usr/local/lib/node_modules/generator-qmui/node_modules/run-async/index.js:25:19
at /usr/local/lib/node_modules/generator-qmui/node_modules/yeoman-generator/lib/base.js:440:9
at runCallback (timers.js:637:20)
at tryOnImmediate (timers.js:610:5)
at processImmediate [as _immediateCallback] (timers.js:582:5)

this is an error when gulp start on window7

PS F:\newuser\QMUI\qmuiweb\qmui_web> gulp start
[16:01:12] Using gulpfile F:\newuser\QMUI\qmuiweb\qmui_web\gulpfile.js
[16:01:12] Starting 'start'...
[16:01:12] Finished 'start' after 14 ms
events.js:141
throw er; // Unhandled 'error' event
^

Error: spawn gulp ENOENT
at exports._errnoException (util.js:870:11)
at Process.ChildProcess._handle.onexit (internal/child_process.js:178:32)
at onErrorNT (internal/child_process.js:344:16)
at nextTickCallbackWith2Args (node.js:442:9)
at process._tickCallback (node.js:356:17)
at Function.Module.runMain (module.js:443:11)
at startup (node.js:139:18)
at node.js:968:3

QMUI web工具运行GULP出错

[13:31:26] 开启 Gulp 服务...
'gulp' �����ڲ����ⲿ���Ҳ���ǿ����еij���
���������ļ���
child process exited with code 1[13:31:26] Gulp 进程意外关闭,请重新启动服务

什么时候支持vue,webpack?

运行环境

  • 操作系统版本:macOS (10.x) / Windows (7/8/10) / Linux / 其他(自行填写具体系统)
  • QMUI Web 版本:1.x.x
  • Node.js 版本:4.x.x

具体问题描述

问题截图

qmui 无法编译sass文件,

运行环境

  • 操作系统版本: Windows (10)
  • QMUI Web 版本:2.0
  • Node.js 版本:6.x.x

具体问题描述

sass文件无法编译

问题截图

image

更新最新依赖包后 Sass Task 报错

运行环境

  • 操作系统版本:macOS (10.13.1)
  • QMUI Web 版本:3.0.0
  • Node.js 版本:7.8.0

具体问题描述

清空 node_modules 缓存,重新执行 npm i 后,执行默认任务报错“TypeError: file.isSymbolic is not a function”,具体堆栈如下图。

问题截图

image

yo qmui创建项目后,直接gulp运行环境,样式文件丢失

具体问题描述

cnpm install -g generator-qmui
yo qmui后创建的目录为
├─public
├─UI_dev
│ └─qmui_web // QMUI Web 主源码应放置在这一层目录
├─UI_html
└─UI_html_result

public目录为空 、UI_dev子目录不存在project文件夹
导致gulp、gulp sass运行时不报错

虽然环境、页面正常运行,但就是拿不到CSS

后来查了下gulp配置,自己得先执行一下 gulp initProject重新初始化一次项目才行
再gulp就没问题了。。

样式的疑问

组件有些许少,还有样式好像在移动端能用,但好像不咋好看呀,比如树状下拉菜单,还有qui_inputext上边框有个难看的阴影。
我是用iphone7 plus ios10.3.3自带游览器测试。
是不是应该各个组件在各大平台上要不同样式,
1.比如qui_tab:在IOS应该对应原生UISegmentedControl这种样式,在安卓上应该对应原生android.support.design.widget.TabLayout 样式
2.树状选择菜单,在移动端好像很难用

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.