ZUI is an HTML5 front UI framework.
list-unstyled
用于移除 <ol>
和 <ul>
列表样式;hideOthers
选项在显示时隐藏其他已经显示的提示消息;placement
选项可能失效的问题;closeOthers
选项用于设置对话框打开时关闭其他已经打开的对话框。maxDate
和 minDate
的支持,用于设置可选日期范围;-webkit-font-smoothing:antialiased
以获得更加平滑的边缘;pointer
;zui.定制名称.css
;这是 ZUI 3 的 alpha 测试版本,后面将加快更新速度,欢迎随时反馈问题 :)
访问 https://easysoft.github.io/zui/3/ 来提前预览组件库。
👉 如果你需要访问 ZUI 1,请访问 https://openzui.com/ ,ZUI 1 源码已经转移到 zui1
分支。
[2021-11-04]
本次更新新增下拉选择器插件,兼容 Chosen 用法,支持大数目选项列表以及从服务器进行搜索;本次更新还修复了大量已知问题,欢迎更新!
新增下拉选择器组件
单选模式 | 多选模式 |
---|---|
.not-clear-menu
的支持,在 .dropdown-menu
内使用此辅助类可以禁用用户点击特定元素时隐藏下拉菜单;scrollInside
选项后,对话框尺寸可能计算错误的问题;$.fn.modalTrigger(methodName)
导致重复监听触发打开事件的问题;limitInsideWindow
用于限制菜单面板显示在窗口区域内;show
用于初始化完成后立即显示菜单;toggleTrigger
用于启用点击触发元素切换菜单显示和隐藏行为;menuCreator
用于自定义生成菜单元素;position
用于动态返回菜单位置;ContextMenu.isShow
方法用于检查指定 ID 菜单是否已经显示;transferEvents
用于将编辑器 iframe 页面内的点击事件传递到父级页面;Array.forEach
和 Array.isArray
polyfills;$.zui.uuid()
在 IE11 下失效的问题;const
关键字导致在 IE8 下 JS 执行错误。[2020-07-09]
本次更新修复了已知问题,并进行大量改进。
ZUI 官方网站为 https://www.openzui.com/ ,并提供了英文文档 https://www.openzui.com/en/ 。
text-wrap
辅助类,相对于 text-nowrap
用于快速设置文本换行样式;<a href="#heading1" />
);.input-group-addon
时的边框样式;.nav
、 .nav.nav-default
或 .nav.nav-simple
形式;icon-renren
图标;<select>
下拉三角图标的外观,与其他平台上统一;no_wrap
选项来禁用下拉选项上的文本换行,此选项默认不开启;sort_field
和 sort_value_splitter
选项来记录用户进行多选时选项在界面上显示的顺序;drop_item_height
选项用于指定下拉菜单上的选项高度,便于自动设置下拉菜单样式和弹出方向,通常此选项会自动进行计算,但当用户手动调整了 CSS 样式时可能需要此选项来手动指定高度;change
事件参数,当用户进行反选操作时会通过事件回调函数第二个参数对象上的 deselected
属性返回被取消选中的值;$.fn.chosen.Constructor.DEFAULTS
可能失效的问题;middle_highlight
在 max_drop_width
选项开启时失效的问题;className
用于向弹出菜单元素添加自定义类名;html
属性,如果指定 HTML 文本则会作为构建整个菜单项使用,而不仅仅是作为菜单项文本内容,这样方便用户构建任意交互形式的菜单项;$.zui.reloadModal(urlOrOptions, modalID)
来方便用户重新载入指定远程对话框上的内容,当对话框内容重新载入时会显示加载中提示动画;scrollInside
选项,现在同时支持对话框和对话框触发器,解决了在一些特殊情况下没有按预期工作的问题,并针对浏览器窗口发生变化情况进行了优化;$.fn.show()
方法时没有使用全局选项 $.zui.ModalTrigger.DEFAULTS
的问题;broken
事件时没有返回有效的 HTML 字符串可能导致出错的问题;initialState
增加新的选项值 'active'
,在初始化之后展开所有激活的节点以及对应的父节点(确保激活的节点可见)$.fn.expandSelect(selector)
方法,用户展开指定的节点以及父节点;$.zui.Messager.DEFAULTS.icons
来设置预设类型的图标;onSizeError
选项,当原始图片尺寸不符合选项 minWidth
和 minHeight
要求时的回调函数,包含一个参数 {width, height}
用于返回当前图片宽和高,在此函数内可以提示用户更换图片;hideFirstDayNumber
选项用于隐藏月份第一天时的日期显示(会显示 “一月”,而不是 “一月1”);$.fn.removeEvents()
出错的问题(@JIMhackKING issue #157);status
或 result
属性仍然视为上传成功;onClickCell
事件,用于监听用户点击单元格事件;gotoPage
的描述错(issue #156);$.zui.uuid()
方法,现在返回的字符串长度为 12,之前为 10;$.zui.browser
对 IE11 的检查问题;3.4.1
版本,旧的 1.12.4
仍然可用;<html>
标签上通过 lang
属性来指定语言并且使用组件时没有指定语言选项时,默认以英文作为默认界面语言。大幅优化 Kindeditor 交互体验,重做 Kindeditor 内表格功能。
placeholder
选项为编辑器设置并显示没有内容时的占位提示文本;pasteImage
选项实现贴图自动上传功能;spellcheck
选项启用或禁用拼写检查功能;transferTab
选项禁用编辑器内 Tab 键插入空格功能,转而实现激活编辑器在页面上下一个表单控件;syncAfterBlur
选项实现自动在编辑器失去焦点时执行同步(sync()
)操作;simpleWrap
选项来优化源码格式化功能,当该选项为 true
时,源码中当块级元素内容不会显示为新的行;themeType
选项指定主题样式表的问题;max_drop_width
选项,用于启用根据下拉菜单条目文字长度自动调整下拉菜单宽度的功能(STORY #220);highlight_selected
选项,用于让下拉菜单上的选中项目永远有高亮效果,并且与鼠标悬停时的效果进行区分(STORY #217);height
设置为 page
时鼠标无法滚动的问题(BUG #28);<select>
在 macOS 系统上强制拥有圆角外观的问题;modal
):
e.preventDefault is undefined
错误。新增 加载指示器,并解决了已知问题。
.clearfix
声明重复的问题(issue #99);<a>
和按钮元素上的默认 CSS 动画效果,现在仅针对部分 CSS 属性(例如 color
、background
等)启用动画;.no-margin
辅助类用于强制移除元素的外边距;.col-1
、.col-2
~ .col-12
辅助类,用于进行快捷宽度设置,但不提供响应式效果;scrollInside
选项用于设置当对话框高度不够时是否在对话框内部显示滚动条;position
选项,现在支持使用一个函数来动态返回对话框打开时的位置;.nav-default
类来提供基本导航样式,便于定制个性化导航;updateColor
选项失效的问题;onKeyDown
事件失效的问题;saerch_compact
选项用于应用更加紧凑的单选选择框外观,此时搜索框与选择框合并一起显示;.form-control
类,则自定将 Chosen 控件宽度设置为 100%
;autoResetFails
选项用于自动重置上传失败的文件;plupload
升级到 2.3.6
;<li>
)被激活时(拥有 .active
类),自动在激活的父节点上添加 .has-active-item
类,方便自定义高级外观;title
属性;onSelectRow
事件,用于监听行选中状态变更;showRowIndex
选项没有按预期生效的问题;value
属性为 undefined
时在界面上显示为 'undefined'
的问题,现在改为不显示任何内容;resetData(data)
方法用于重新设置日历数据;eventSorter
选项,用于指定一个回调函数来比较两个事件对象,每次渲染日历时会对事件进行排序操作;reopen()
方法有时没有生效的问题;dropToClass
和 stopPropagation
选项;listenClick
选项,如果设置为 false,则用户点击元素但没有拖拽操作时不会选中任何内容;$.zui.uuid()
方法,现在该方法会 36 进制字符串来代替数字,减少结果长度;$.zui.Color
构造方法支持 RGB 颜色字符串格式,例如 new $.zui.Color('rgba(255,0,0,0.5)')
;解决了近两周社区反馈的问题。
responsive
选项和 checkbox
选项同时启用冲突的问题@YNZZZ);configs
中的 html
属性和列配置的 html
属性设置为 true
时没有生效的问题(@YNZZ);valueOperator
没有按照预期工作的问题,同时修复了值转换期函数中参数不完整的问题(@zz);checkByClickRow
和 selectable
选项冲突的问题,当 checkByClickRow
被禁用时,如果开启拖拽选择,则仅可以在勾选框所在列进行拖选操作(@YNZZZ);mouseWheelFactor
参数用于控制滚轮滚动速度和方向;id
或 rowId
属性时获取选中行编号为 undefined
的问题;showRowIndex
设置为 false
列宽混乱的问题;1
;html
选项设置为 true
时没有按照预期工作的问题;.no-padding
类用于移除元素所有内边距;input-group-addon
左侧边框有双倍宽度的问题;hideEmptyWeekends
默认值设置为 false
;setImage(image, caption)
和 show()
方法用于手动控制显示和更新内容(QQ 群 @深圳市雷诺表业-it);感谢 @neo20、zora-han 提交了 Pull Request。欢迎大家反馈建议,最好是在论坛发帖或者在 Github 上提交 issue,更欢迎有能力的同学提交 Pull Request。
1.8 版本带来了多个新的 JS 组件,包括全新的数据表格2、标签页管理器、上下文菜单、搜索框、输入框和分页器。
数据表格2支持自定义数据源(包括远程数据),提供行列固定、排序、分页、搜索、行选择、自适应、跨行跨列单元格等重量级功能,并且使用灵活方便定制(旧版本数据表格将不再继续支持,将于 1.9 中淘汰)。
标签页管理器最大化增强了标签页控件功能,现在可以使用标签页动态加载内容,甚至是远程页码,还可以手动打开、关闭标签页,就像使用浏览器标签页一样方便。
上下文菜单允许你在任意位置弹出浮动在鼠标光标附近的菜单,非常方便的监听鼠标右键并屏蔽系统行为从而定制自己的右键菜单。
分页器提供完全自动化的分页界面控件管理,只需要给定当前页码和条目数目即可。
搜索框提供了常用的搜索输入框+按钮的组合界面,并且提供一个延迟触发事件用于监听搜索框文本变更事件,使用搜索框可以非常方便的定制现代话搜索交互功能。
输入框创建了一种将标签和图标内置到输入框的现代化形式,创建更美观的表单界面。
icon-check-plus
和 icon-check-minus
图标,现在看起来更大些;.fix-padding
在 IE8 上失效的问题;name
属性时会自动更新界面上的文件名;staticFiles
)对支持,现在在提示信息中会计算静态文件的个数和大小;renameActionOnDone
回调函数执行参数 doRenameFile
方法无效的问题;addData()
方法后当显示鼠标悬停标签出错的问题;<option>
上的 value
属性;drop_direction
选项设置为 'auto'
时,现在弹出方向不会随着条目数目变动;moveable
选项,当设置为 'inside'
时不会允许用户将模态框移动到窗口可视区域之外;className
选项失效的问题;broken
事件中返回的错误文本内容没有显示的问题;canMoveHere
选项;move
选项,现在可以使用一个回调函数来执行移动操作;lazy
、canMoveHere
、nested
选项对支持;start
事件中获取不到事件参数 event
的问题;destroy
无效的问题;foldable
属性来设置是否可以折叠该节点;dragThenDrop
选项的支持,现在可以使用一个对象来初始化拖放插件;hideEmptyWeekends
选项可以折叠周末所在列;contentClass
选项失效的问题;<html>
会自动添加 os-win
或 os-mac
等辅助类用于为不同的操作系统应用样式;svg
标签 max-width
样式设定,避免在一些地图控件中造成冲突。