2.0 alpha
These docs describe 2.0. Install it with @once-ui-system/core@alpha.
On 1.8.x? Read the 1.x docs
TrademarkTrademarkDocs
Ctrl k
Search docs...
Basics

Border

Updated: May 4, 2025
Shape language in design profoundly influences the style of an interface. For instance, a website employing a large border radius often appears more playful, whereas one with small borders and sharp corners tends to convey a more conservative feel. Override the default shape style with the data-border attribute on a native HTML element. In Once UI, we adopt the T-shirt size model for managing border radius, with values ranging from xs to xl. A common challenge in border-radius systems is nesting. For nested elements to maintain an aesthetic and natural appearance, they require varying border radius sizes. Once UI addresses this issue by providing additional border radius values specifically for containers with static-size-4 and static-size-8 paddings, which are the most frequently used nesting sizes. Sets the border-width property.
Class
Preview
.border-1
.border-2
Sets the border-style property.
Class
Preview
.border-solid
.border-dashed
Sets the border-color property.
Class
Value
.neutral-border-weakvar(--neutral-border-weak)
.neutral-border-mediumvar(--neutral-border-medium)
.neutral-border-strongvar(--neutral-border-strong)
.neutral-alpha-alpha-weakvar(--neutral-border-alpha-weak)
.neutral-alpha-alpha-mediumvar(--neutral-border-alpha-medium)
.neutral-alpha-alpha-strongvar(--neutral-border-alpha-strong)
.brand-border-weakvar(--brand-border-weak)
.brand-border-mediumvar(--brand-border-medium)
.brand-border-strongvar(--brand-border-strong)
.brand-alpha-alpha-weakvar(--brand-border-alpha-weak)
.brand-alpha-alpha-mediumvar(--brand-border-alpha-medium)
.brand-alpha-alpha-strongvar(--brand-border-alpha-strong)
.accent-border-weakvar(--accent-border-weak)
.accent-border-mediumvar(--accent-border-medium)
.accent-border-strongvar(--accent-border-strong)
.accent-alpha-alpha-weakvar(--accent-border-alpha-weak)
.accent-alpha-alpha-mediumvar(--accent-border-alpha-medium)
.accent-alpha-alpha-strongvar(--accent-border-alpha-strong)
.warning-border-weakvar(--warning-border-weak)
.warning-border-mediumvar(--warning-border-medium)
.warning-border-strongvar(--warning-border-strong)
.warning-alpha-alpha-weakvar(--warning-border-alpha-weak)
.warning-alpha-alpha-mediumvar(--warning-border-alpha-medium)
.warning-alpha-alpha-strongvar(--warning-border-alpha-strong)
.danger-border-weakvar(--danger-border-weak)
.danger-border-mediumvar(--danger-border-medium)
.danger-border-strongvar(--danger-border-strong)
.danger-alpha-alpha-weakvar(--danger-border-alpha-weak)
.danger-alpha-alpha-mediumvar(--danger-border-alpha-medium)
.danger-alpha-alpha-strongvar(--danger-border-alpha-strong)
.success-border-weakvar(--success-border-weak)
.success-border-mediumvar(--success-border-medium)
.success-border-strongvar(--success-border-strong)
.success-alpha-alpha-weakvar(--success-border-alpha-weak)
.success-alpha-alpha-mediumvar(--success-border-alpha-medium)
.success-alpha-alpha-strongvar(--success-border-alpha-strong)
Edit this page on GitHub
TrademarkTrademark
Built with curiosity by Lorant One and the Design Engineers Club