别误会我的意思,我并不反对 web 组件 api 的默认值。我对他们的问题是他们不可靠。
问题
为 api 提供可用选项列表的常见方法是使用 typescript 的 untion 类型。
/** the display variant for the button */@property({reflect: true})variant: 'default' | 'solid' | 'ghost' = 'default';
这里有一些基本的 css 来使这些变体发挥作用。
:host { --accent-color: #0265dc;}button { cursor: pointer; padding: 0.5rem;}:host([variant='default']) button { border: solid 1px var(--accent-color); background-color: white; color: var(--accent-color);}:host([variant='solid']) button { border: solid 1px var(--accent-color); background-color: var(--accent-color); color: white;}:host([variant='ghost']) button { border: solid 1px transparent; background-color: transparent; color: var(--accent-color);}
注意:代码示例使用 lit,但这里讨论的原理可以轻松应用于其他库和框架。
挑战是自定义元素/web 组件可以在任何地方使用。它们可以以字符串、服务器端语言(如 php)插入到 dom 中,可以在 javascript 的 createelement 函数中创建,甚至可以在标准 html 中创建。我的意思是,并不总是有一种“类型安全”的方法来确保准确设置自定义元素属性。因此,我们组件库的 pr 清单中的一项是:
✅ 属性和属性在设置、取消设置和设置不当时都有效。
测试我们的 api
根据这些准则,让我们测试上面的 api 设置。
设置 – 一切看起来都很好。
default buttonsolid buttonmy button

未设置 没有设置属性,它可以正常工作,因为我们有一个默认值,并且它被配置为在设置时反映元素上的属性。如果我们将变量属性设置为未定义,则会破坏样式。
no attribute buttonunset button

设置不当 – 当我们将变体属性设置为“垃圾”时,它也会崩溃。
rubbish button

您可以在这里测试这个示例:

Zyro AI Background Remover
Zyro推出的AI图片背景移除工具
55 查看详情
修复 api
解决此问题的最简单方法是使按钮元素样式与默认样式匹配。
button { border: solid 1px var(--accent-color); background-color: white; color: var(--accent-color); cursor: pointer; padding: 0.5rem;}
现在我们可以删除默认变体的代码。
/* we can remove this */:host([variant='default']) button { border: solid 1px var(--accent-color); background-color: white; color: var(--accent-color);}
为了避免混淆,您可以留下样式并添加评论。
/* styles for this variant are under the `button` element */:host([variant='default']) { }
我们还可以更新 typescript api,使其成为可选并删除默认值。
/** The display variant for the button */@property({ reflect: true })variant?: 'default' | 'solid' | 'ghost';
现在,如果值已设置、未设置或设置不当,元素的行为将保持一致!

您可以在此处查看最终代码:

结论
通过删除对默认值的依赖,您可以创建更具弹性的 web 组件 api。如果您的组件必须具有默认值才能正常运行,请务必查看本文以创建一致工作的 web 组件。
以上就是不要依赖默认属性值来设置 Web 组件的样式的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1152220.html
微信扫一扫
支付宝扫一扫