首页 > web前端 > css教程 > 正文

不要依赖默认属性值来设置 Web 组件的样式

碧海醫心
发布: 2024-11-12 22:54:35
转载
654人浏览过

别误会我的意思,我并不反对 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 设置。

  • 设置 - 一切看起来都很好。
<my-button variant="default">default button</my-button>
<my-button variant="solid">solid button</my-button>
<my-button variant="ghost">my button</my-button>
登录后复制

不要依赖默认属性值来设置 Web 组件的样式

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

<!-- jsx example -->
<my-button variant={undefined}>unset button</my-button>
登录后复制

不要依赖默认属性值来设置 Web 组件的样式

  • 设置不当 - 当我们将变体属性设置为“垃圾”时,它也会崩溃。
<my-button variant="rubbish">rubbish button</my-button>
登录后复制

不要依赖默认属性值来设置 Web 组件的样式

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

不要依赖默认属性值来设置 Web 组件的样式

AI Web Designer
AI Web Designer

AI网页设计师,快速生成个性化的网站设计

AI Web Designer 63
查看详情 AI Web Designer

修复 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 组件的样式

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

不要依赖默认属性值来设置 Web 组件的样式

结论

通过删除对默认值的依赖,您可以创建更具弹性的 web 组件 api。如果您的组件必须具有默认值才能正常运行,请务必查看本文以创建一致工作的 web 组件。

以上就是不要依赖默认属性值来设置 Web 组件的样式的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:dev.to网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号