HWUI帮助文档

适用于版本为:Preview 1.4.5的HWUI

前言
欢迎您使用HWUI,这里是HWUI的帮助文档。HWUI全称为HiSuperWan UI,通常适用于网站(Web)中。本项目为开源项目,请自觉遵守开源协议,您的配合会让开源社区更好!改帮助文档为最新版本。
注意
您可以修改css当中":root"中的变量用于设置主题颜色,修改js当中动画逻辑等。但不允许修改js文件中的load函数 (内包含了创作者的信息),谢谢您的配合!

按钮(Button)

基础的一个组件,最常用的组件。

您可以使用<hw-button>来添加此元素

基础用法

普通的按钮

通过设置color属性来更改样式

normal(默认) red green blue yellow

开关(Switch)

基础的一个组件,在设置中最常见。

您可以使用<hw-switch>来添加此元素

基础用法

在JS中您可以使用hw-switch.active获取开关状态 获取active

输入框(Input)

基础的一个组件,人机交互的基础。

您可以使用<hw-input>来添加此元素

基础用法

一个普通的输入框

设置type实现不同类型的输入方式

text password number
在JS中您可以使用hw-input.value获取开关状态
测试输入框 获取value

多选框(Checkbox)

一组选项中进行多选

您可以使用<hw-checkbox>来添加此元素

基础用法

测试多选框 干扰多选框 在JS中您可以使用hw-checkbox.active获取开关状态或设置属性

以下代码针对于测试多选框

更改多选状态 获取多选状态

选择器(Select)

一个,两个,三个,四个,五个...哎呀,不数了 : (

您可以使用<hw-select>和<hw-option>搭配来添加此元素

基础用法

一只平凡的选择器

蓝天新世界 HiSuperWan

在<hw-select>中嵌套<hw-option value="{{value}}">

通过hw-select.value获取当前值

标签页(Tabs)

让内容井井有条 分类明确

你可以使用<hw-tabs>和<hw-tab-pane>和<hw-tab-page>来添加此元素组合

基础用法

首页
想不到藏了一个按钮 想不又藏了一个按钮 想不还藏了一个按钮
联系人
exp1

特性

<hw-tabs active={{title}}></hw-tabs>可以使你更改或获取打开的页面(同理可在js中修改或获取Attribute) 修改具有实时性,立刻生效。 打开首页 打开联系人 获取当前打开页

列表(List)

可以互动的列表,例如上下开开关关~

您可以使用<hw-list>来添加此元素

基础用法

藏起来的小元素一号awa
藏起来的小元素二号qwq
藏起来的小元素三号LoL
在JS中您可以使用hw-list.active获取开关状态或设置属性。 更改列表开关 获取列表开关

关闭按钮(CloseButton)

一个无用的按钮,但却少不了

您可以使用<hw-closeButton>来添加此元素

看似美丽,实则无用,只是一个按钮。你可以添加你想要的任何事件if you like

轮播图(Carousel)

一个可以自动播放的图片墙

您可以使用<hw-carousel>来添加此元素

举个栗子

注:此轮播图添加了圆角,直接添加不自带~

功能

使用hw-carousel.value来获取进度(从0开始)

获取进度

若您需要添加图片:请使用appendChild并调用ReloadHWCarousel({{hw-carousel}})来重载

添加一张图片并重载

进度条(Process)

卡99%的真凶

您可以使用<hw-process>来添加此元素

举个栗子

value为50的进度条
hw-process的进度会自适应(value = 80)
正在重复变换的hw-process

使用hw-process.value = {{num}}(num = 0~100)来调节进度

document.getElementById("process-test2").value = 100;

气泡卡片(Popover)

通常可以对一个元素进行描述或者展开一些更高级的东西

举个栗子

卡片(Card)

正如您所见,这就是一个卡片。

您可以使用<hw-card>来添加此元素(甚至可以无限套娃)

看到了吗?This is hw-card

信息提示(Message)

使用JS触发,使用户被动阅读提示。

语法

HWMessage(提示内容,类型,icon,显示时间)

举个栗子

(normal)普通的信息提示 (success)成功的信息提示 (info)信息的信息提示 (warning)警告的信息提示 (danger)错误的信息提示

信息弹窗(MessageBox)

使用JS触发,用于打断用户操作,使用户阅读弹窗内容或做出选择。

语法

HWMessageBox.alert("主体内容","标题内容","按钮内容",function(result){}); //第四参数为回调函数,当用户完成当前对话时执行 //result返回用户点击的元素:如果点击普通按钮为"button",关闭按钮为"close"

举个栗子

文字弹窗(无标题) 文字弹窗(带标题) 激活HTML弹窗 (+回调展示)

请输入您要查找的用户

用户名
关闭 查找

对话框(Dialog)

适用于需要深度定制的场景,例如表单填写。

举个栗子

打开dialog

使用步骤

1.HTML中在body内(头部或尾部)新建一个<hw-dialog>并定义一个id,然后在标签夹层插入其他标签。

<hw-dialog id="test-dialog"> <hw-button>点我</hw-button> </hw-dialog>

2.使用JS调用,HWDialog.open(元素)来显示这个dialog,或者HWDialog.close(元素)来关闭这个dialog。

//打开dialog HWDialog.open(document.getElementById(test)); //关闭dialog HWDialog.close(document.getElementById(test));

开发人员

HiSuperWan

十方