Ting Web UI

简洁、直观、强悍、跨浏览器的前端开发框架,让web开发更迅速、简单。

组件

本章节组件更推荐使用 Javascript 框架封装成组件使用。本项目是一个纯 CSS 实现的表单组件,示例页内的 Javascript 代码,仅为文档演示。

类描述
.btn为按钮添加基本样式
.btn-default默认/标准按钮
.btn-{context}语境色按钮
.btn-outline-{context}边框按钮
.btn-{size}按钮大小:大、小、超小
.btn-block块级按钮(拉伸至父元素100%的宽度)
.btn-round圆角按钮
.btn-square正方形按钮,不同尺寸
.btn-label按钮内部文字
.btn-icon-left
.btn-icon-right
按钮内部图标
.btn-loading加载状态按钮,禁用点击,半透明显示
.btn-disabled禁用状态按钮,灰色背景,不可点击

使用方法

类描述
.btn-toolbar按钮工具栏容器,管理按钮组的间距
.btn-group按钮组容器,将多个按钮合并为一组
.btn-group-justified宽度均分按钮组,按钮平均分配容器宽度
.btn-group-vertical垂直排列按钮组,按钮纵向堆叠

使用方法

breadcrumb在一个带有层次的导航结构中标明当前页面的位置。

类描述
.breadcrumb路径导航容器,浅灰色背景,使用斜杠分隔各级

使用方法

导航组件都依赖同一个 .nav 类,状态类也是共用的。改变修饰类可以改变样式。提供了选项卡标签页、药丸标签页、下划线标签页三种。

类描述
.nav导航基础容器,清除列表默认样式
.nav-pills药丸导航,圆角背景,激活项填充主题色
.nav-tabs选项卡导航,底部边框,激活项带边框和白色背景
.nav-underline指示器导航,底部边框,激活项底部显示主题色指示线
.nav-justified两端对齐导航,导航项平均分配宽度
.nav-flush可以使选项卡组紧贴容器

使用方法

类描述
.tabs标签页组总容器
.tabs-nav标签页导航容器
.tabs-content标签页内容容器
.tabs-pane标签页内容面板,默认隐藏
.tabs-horizontal导航水平布局
.tabs-nav-left导航左排
.tabs-nav-right导航右排
.tabs-nav-below导航下排
.tabs-flush标签页组紧贴容器
.tabs-fill标签页组填充容器

使用方法

类描述
.navbar导航栏基础容器,提供基本的定位和布局
.navbar-dark导航栏暗黑模式,一般还要搭配.dark,使得子元素也变暗
.navbar-fixed-top导航栏固定在顶部
.navbar-sticky-top导航栏粘滞在顶部
.navbar-brand导航栏品牌标识区域,通常放置Logo或网站名称
.navbar-nav导航栏内的导航列表容器
.navbar-collapsible响应式折叠区域,在小屏幕时可折叠/展开
.navbar-toggler移动端折叠触发按钮
.navbar-header导航栏头部,包含品牌标识和移动端切换按钮
.navbar-right导航栏内容右对齐
.navbar-form导航栏内的表单区域,自动适配间距和对齐
.navbar-btn导航栏内的按钮,适配垂直居中
.navbar-text导航栏内的文本内容,自动适配行高和对齐
.navbar-link导航栏内的普通链接样式

使用方法

为您的网站或应用提供带有展示页码的分页组件,或者可以使用简单的翻页组件。

类描述
.pagination分页列表容器,内联块级显示
.pagination-lg
.pagination-sm
分页大小:大、小
.pagination-gutter分页项之间有间距的样式
.active当前激活的页码项
.disabled禁用的页码项,不可点击

使用方法

类描述
.list-group列表组容器,提供基本的列表样式和边框
.list-group-item列表组中的单个项目,支持悬停效果和语境色
.list-group-flush去除列表组边框和圆角,使其与父容器无缝融合
.list-group-item-{context}列表项的语境色样式,用于表示不同状态
.active激活状态的列表项,高亮显示

使用示例

类描述
.progress进度条容器,浅灰色背景,带内阴影
.progress-bar进度条主体,默认主题色背景,白色文字,支持动画过渡
.progress-bar-{context}进度条语境色,表示不同状态
.progress-sm小号进度条,高度12px
.progress-xs超小进度条,高度6px

使用方法

类描述
.carousel轮播图容器,相对定位
.carousel-indicators轮播指示器,底部圆点导航
.carousel-inner轮播内容区域,隐藏溢出,横向排列
.carousel-item轮播项,每个幻灯片
.carousel-control-prev左切换按钮
.carousel-control-next右切换按钮
.carousel-caption轮播图文字说明,底部半透明黑色背景

使用方法

类描述
.dropdown下拉菜单容器,相对定位
.dropdown-menu下拉菜单列表,绝对定位,默认隐藏
.dropdown-menu-right右对齐的下拉菜单
.dropdown-item下拉菜单项,支持悬停效果
.dropdown-toggle把一个按钮或链接转换为下拉菜单风格
.dropup、.dropleft、.dropright弹出的菜单方向
.dropdown-toggle-split下拉按钮分隔样式
.dropright-submenu二级子菜单容器
.dropdown-header分组标题
.dropdown-divider分割线

使用方法

类描述
.tooltip工具提示容器,相对定位,内联块元素
.tooltip-inner提示气泡主体,黑色背景白色文字,带圆角
.tooltip-arrow气泡箭头,指向触发元素
.tooltip-top向上弹出,箭头朝下
.tooltip-right向右弹出,箭头朝左
.tooltip-bottom向下弹出,箭头朝上
.tooltip-left向左弹出,箭头朝右

使用方法

类描述
.popover弹出框容器,显示标题和内容
.popover-arrow弹出框箭头,指向触发元素
.popover-header弹出框标题区域
.popover-body弹出框正文区域
.popover-top向上弹出,箭头朝下
.popover-right向右弹出,箭头朝左
.popover-bottom向下弹出,箭头朝上
.popover-left向左弹出,箭头朝右

使用方法

类描述
.collapsible可折叠容器,默认展开显示内容
.collapsible.hide折叠状态,隐藏内容

使用方法

类描述
.accordion手风琴容器
.accordion-flush去除边框,贴紧父容器做到齐平嵌入
.accordion-dark暗黑模式手风琴
.accordion-item手风琴项目,每个可折叠`区块
.accordion-item.collapsed一个accordion-item的折叠状态
.accordion-header手风琴头部,包裹触发按钮
.accordion-button触发按钮,点击展开/折叠对应内容
.accordion-collapsible可折叠内容容器,默认展开,父组件可用.collapsed折叠
.accordion-body手风琴内容正文

使用方法

类描述
.tree树组件容器,相对定位,带内边距
.tree-icon树节点图标,垂直居中对齐
.tree-toggler树节点展开/折叠三角箭头
.tree-collapsible可折叠内容容器,默认展开,父组件可用.collapsed折叠
.tree li.collapsed折叠状态的树节点,隐藏子节点,箭头旋转
.tree li.active选中的树节点,使用主题色背景

使用方法

类描述
.sidebar侧栏容器
.sidebar-dark暗色侧栏容器,一般还要搭配 .dark 使得子组件也变暗
.sidebar-collapsed折叠状态,折叠后只显示图标
.sidebar-header侧栏头部区域
.sidebar-footer侧栏底部区域
.sidebar-body侧栏内容区域
.sidebar-brand侧栏品牌标识区域
.sidebar-group侧栏分组
.sidebar-group-label侧栏分组标签
.sidebar-menu一级菜单
.sidebar-item导航项
.sidebar-item.collapsed导航项折叠状态
.sidebar-indicator展示折叠状态的图标
.sidebar-icon导航项图标
.sidebar-link导航项链接
.sidebar-collapsible折叠容器
.sidebar-submenu二级及以下子菜单

使用方法

类描述
.overlay覆盖层容器,覆盖所属容器,半透明黑色背景
.overlay-viewport覆盖层容器,覆盖整个视口
.overlay-blocker覆盖层的事件捕获层,用于拦截用户点击

使用方法

提示信息用于在操作完成后向用户反馈结果。

类描述
.msg消息提示容器
.msg-toast半透明提示,黑色半透明背景
.msg-icon消息提示图标
.msg-label消息提示文本
.msg-vertical垂直排列的提示信息
.msg-square方形提示,合纯图标加载中场景

使用方法

类描述
.dialog对话框容器
.dialog-header对话框头部区域,浅灰色背景,带底部边框
.dialog-title对话框标题
.dialog-body对话框主体内容区域
.dialog-footer对话框底部按钮区域,带顶部边框
.dialog-{context}对话框语境色主题,影响头部背景色
.dialog-{size}预设大小

使用方法

类描述
.msgbox消息框容器,白色背景,顶部带4px语境色边框
.msgbox-{size}消息框尺寸
.msgbox-header消息框头部区域,包含图标和关闭按钮
.msgbox-title消息框标题,加粗字体,自动适配图标位置
.msgbox-body消息框主体内容区域
.msgbox-footer消息框底部按钮区域,居中显示
.msgbox-{context}消息框语境色主题,影响顶部边框颜色

使用方法

类描述
.win窗口容器,绝对定位,可拖动,带边框和标题栏
.win-header窗口标题栏,可拖动,包含标题和按钮组
.win-title窗口标题文本
.win-btn-group窗口标题栏右侧的按钮组(最小化、最大化、关闭)
.win-close窗口关闭按钮,红色背景
.win-body窗口主体内容区域,可滚动
.win-resizer窗口右下角的缩放手柄
.win-blocker窗口遮罩层,禁用时阻挡点击
.win-maximized最大化状态的窗口,占满整个视口
.win-inactive未激活状态的窗口
.win-disabled禁用状态的窗口,不可操作,显示半透明遮罩
.win-drag-rect窗口拖拽/缩放时的辅助边框

使用方法

类描述
.panel面板容器,白色背景,带边框和阴影
.panel-heading面板头部区域,带底部边框
.panel-title面板标题,继承父级颜色
.panel-body面板主体内容区域,带内边距
.panel-default默认面板,浅灰色头部
.panel-primary主题色面板,主题色边框和头部
.panel-success成功状态面板,绿色调
.panel-info信息状态面板,蓝色调
.panel-warning警告状态面板,黄色调
.panel-danger危险状态面板,红色调