eBayUI 核心项目
Marko部件集;被认为是所有eBay组件,页面和app的核心构件.
所需资源
说明:eBayUI 核心部分使用马尔科旗帜,因此需要 <lasso-page/> 将添加到任何含有核心组件的页面.
说明: @ebay/skin/global 财务报告和审定财务报表 @ebay/skin/marketsans 用于所有模块正确加载.
注:为使分布属性正常工作, [email protected] 至少必须
浏览器策略
所有组件都开发并测试了交叉浏览器
无障碍(A11Y)
我们非常重视无障碍环境。 非常认真。 因此,所有部件都按照 eBay MIND 模式这些模式又取而代之,取而代之的是: WAI-ARIA 作者惯例。 。 。 .
构件采用分层、逐步加强的方式,利用下列资源:
每一层都尽其所能强制和加强无障碍。 我们认为,这种支持水平是我们的主要销售点之一,我们希望你也这样做!
构成部分
ebay-3d-viewerebay-alert-dialogebay-avatarebay-badgeebay-breadcrumbsebay-buttonebay-calendarebay-carouselebay-character-countebay-checkboxebay-chipebay-comboboxebay-cta-buttonebay-date-textboxebay-detailsebay-drawer-dialog-deprecatedebay-eekebay-fake-linkebay-fake-menuebay-fake-menu-buttonebay-fake-tabsebay-filterebay-filter-inputebay-filter-menuebay-filter-menu-buttonebay-fullscreen-dialog-deprecatedebay-iconebay-icon-buttonebay-infotipebay-inline-noticeebay-lightbox-dialogebay-listebay-listbox-buttonebay-menuebay-menu-buttonebay-page-noticeebay-paginationebay-panel-dialogebay-phone-inputebay-progress-barebay-progress-bar-expressiveebay-progress-spinnerebay-progress-stepperebay-radioebay-section-noticeebay-section-titleebay-segmented-buttonsebay-selectebay-signalebay-skeletonebay-snackbar-dialogebay-split-buttonebay-star-ratingebay-star-rating-selectebay-switchebay-tabsebay-textboxebay-toast-dialogebay-toggle-buttonebay-toggle-button-groupebay-tooltipebay-tourtipebay-tri-state-checkboxebay-video
开始
EBayUI核心组件作为 @ebay/ebayui-core 打开软件包 国家预防机制。 。 。 .
使用 npm 或 线条将包依赖性添加到您的工程中 :
npm add @ebay/ebayui-core
升级到最新版本
见 升级指南 更多信息
自定义标记
一旦添加了软件包依赖性, eBay 海关标记 现在可以在您的Marko模板中使用。 例如,使用 ebay-menu 组件 :
模板.marko
<ebay-menu text="Sort" type="radio">
<@item>Price</@item>
<@item>Time</@item>
<@item>Distance</@item>
</ebay-menu>
属性
属性为组件提供初始状态。 我们可以看到菜单有 text 财务报告和审定财务报表 type 属性 :
模板.marko
<ebay-menu text="Sort" type="radio">
<@item>Price</@item>
<@item>Time</@item>
<@item>Distance</@item>
</ebay-menu>
将新的属性传递给ebayui组件将永远重置为内部状态. 如果您想要自己坚持这个状态, 事件会被曝光, 允许您同步状态到自己的组件, 例如:
class {
onCreate() {
this.state = {
dialogIsOpen: false,
};
}
handleDialogClose() {
this.state.dialogIsOpen = false;
}
handleDialogOpen() {
this.state.dialogIsOpen = true;
}
}
<ebay-lightbox-dialog
open=state.dialogIsOpen
on-open("handleDialogOpen")
on-close("handleDialogClose")
>
...
</ebay-lightbox-dialog>
通过属性
HTML属性可以用于任何组件上,它们会被传递到组件最突出的标记上. 最突出的标记通常是根或形式控件,但单个组件如果因特定情况而异会注意.
静态使用示例:
<ebay-button id="my-button"/>
为了动态地使用通过属性,它们应当通过 html-attributes 属性 :
$ const myAttributes = { id: "my-button" };
<ebay-button html-attributes=myAttributes/>
静态和动态的通过属性可以同时使用(html属性在冲突中优先):
$ const myAttributes = { id: "my-button" };
<ebay-button html-attributes=myAttributes type="submit"/>
活动
事件也可以使用 马尔科语法数字 :
模板.marko
<ebay-menu text="Sort" type="radio" on-change("onMenuChange")>
<@item>Price</@item>
<@item>Time</@item>
<@item>Distance</@item>
</ebay-menu>
释放里程碑( M)
关于即将印发的路线图和历史,请参见我们 释放 财务报告和审定财务报表 里程碑 页面.
版本
Ebayui核心套件严格遵循 语义版本。 。 。 .
给一个版本号 MAJOR.MINOR.PATCH:
- 当我们进行不相容的 API 修改时, MaJOR 版本会递增
- MINOR 版本在以倒向兼容方式添加功能时会递增
- PATCH版本在做回相容的bug修正时会递增.
折旧
折旧将通过下列途径通报: 发布注释请仔细阅读 一般来说,期望在下一个主要版本中去掉任何被贬损的特性. 然而,在某些情况下,我们可能等待一段时间.
问题
请用我们的 问题页面 询问、报告问题或提交特征请求.
为了帮助追踪您的问题, 我们的管理员会给它分配一个或多个有色标签:
- 黑色: 问题类型( 如错误、 问题、 测试大小写)
- 白色: 分辨率( 如 wont fix, 无效, 重复)
- Gray:状态(例如积压,正在进行中,需要帮助)
- 红色:块状物(如依赖,讨论,设计等)
- 绿色:模块(例如按钮、收音机、对话框)
- 蓝色:外观(例如:构建、文档、网站)
- 黄色: semver 向导( 如: 打破更改, 向后兼容)
- 紫色:冲刺(如冲刺1,冲刺2等)
捐款
想要为eBay UI做贡献吗? 请来看我们 贡献页 更多信息.
许可证
版权 (c) 2018 eBay Inc.
使用此源代码受麻省理工学院风格许可的规范,该许可可在LICENSE文件中找到,也可在 https://opensource.org/licenses/MIT (中文(简体) )。 。 。 .
使用一些需要第三方提供单独、非公开资源的限制的构成部分
EBayUI库中的数据可视化组件和图表组件被设计为使用一个或多个HighCharts®软件产品. HighCharts是HighSoft AS的注册商标. HighSoft AS不隶属于埃拜公司. Ebay对于数据可视化组件和图表组件设计要使用的High Charts 软件产品,不提供任何种类的保证(例如,为特定目的的可商性、健身性和不侵犯性),无论是明示的还是默示的.
商业使用高科技产品需要高科技公司提供的优惠。 虽然eBayUI图书馆的许多组件根据麻省理工学院许可证获得许可,但设计用于EbayUI图书馆的数据可视化组件和图表组件的高图软件产品则根据麻省理工学院许可证或任何其他开源许可证不获得许可。 与HighHarts 软件产品有关的权利(例如,包括但不限于使用、安装、分发、公布、合并、复制和修改的权利),由在线提供的一项或多项专利许可协议的条款管辖 http://www.highcharts.com (中文(简体) ) 或根据海关许可协议的条款,HighSoft AS可自行决定与客户谈判。 HighSoft AS可能选择免费为HighHarts 软件产品非商业用途发放许可证,但它是希望使用HighCHARTS SOFTWARE 产品的任何缔约方的责任,以使用HHASTAFT 的特性。 不属于这种限制范围的缔约方,因为高压产品(或其供应者或导弹)不能使用高压产品,因此不能使用数据访问成分和易控液化成分.
这一通知应载入软件的所有副本或大部分.