xy-ui是一套使用原生Web Components规范开发的跨框架UI组件库

xy-ui是一套使用原生Web Components规范开发的跨框架UI组件库

xy-ui

xy-ui是一套使用原生Web Components规范开发的跨框架UI组件库。查看文档

github项目地址

更新

update

特性

跨框架。无论是react、vue还是原生项目均可使用。组件化。shadow dom真正意义上实现了样式和功能的组件化。类原生。一个组件就像使用一个div标签一样。无依赖。纯原生，无需任何预处理器编译。无障碍。支持键盘访问。

兼容性

现代浏览器。

包括移动端，不支持IE。

IE不支持原生customElements，webcomponentsjs可以实现对IE的兼容，不过很多CSS特性仍然无效，所以放弃

安装

npm

npm i xy-ui

cdn

直接在github上获取最新文件（推荐）。

目录如下：

.└── xy-ui ├── components //功能组件 | ├── xy-icon.js | └── ... ├── iconfont //图标库 | └── icon.svg └── index.js

将整个文件夹放入项目当中（可选择以上几个目录文件即可，其他文件夹均为文档测试）。

button

现代浏览器支持原生import语法，不过需要注意script的类型type="module"。

react项目引用

import 'xy-ui';//推荐//如需单独使用import 'xy-ui/components/xy-button.js';ReactDOM.render(button, document.body);

demo

关于react中使用Web Components的注意细节可参考https://react.docschina.org/docs/web-components.html

vue项目引用

import 'xy-ui';//推荐//如需单独使用import 'xy-ui/components/xy-button.js';

使用同原生组件类似

你可能已经注意到 Vue 组件非常类似于自定义元素，它是 Web 组件规范的一部分，这是因为 Vue 的组件语法部分参考了该规范。

为了避免歧义，需要将自定义元素忽略掉，可参考官方文档

Vue.config.ignoredElements = [ 'my-custom-web-component', 'another-web-component', // 用一个 `RegExp` 忽略所有“ion-”开头的元素 // 仅在 2.5+ 支持 /^ion-/]

其他事件绑定可自行搜索~

其他

大部分情况下，可以把组件当成普通的html标签，

比如给button添加事件，有以下几种方式

button

btn.onclick = function(){ alert(5)}btn.addEventListener('click',function(){ alert(5)})

自定义事件只能通过addEventListener绑定

比如元素的获取，完全符合html规则

tab1 tab2 tab3

const tab3 = document.getElementById('tab3');tab3.parentNode;//xy-tab

组件的布尔类型的属性也遵从原生规范（添加和移除属性），比如

button button

总之，大部分情况下把它当成普通的html标签（不用关注shadow dom的结构）就好了，以前怎么做现在仍然怎么做，只是新增了方法而已。

License

MIT

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。