Needless UI 支援 Angular 22。元件都是獨立指令,因此不需要匯入任何模組。

安裝

執行 ng add。它會加入 Angular 套件,以及提供鍵盤操作與無障礙行為的 Angular Aria 和 CDK,並在你的全域樣式中匯入樣式表。

ng-add.sh
ng add @needless-ui/angular

如果想改為手動設定,請先加入這些套件,再依照下方範例匯入樣式。

install.sh
pnpm add @needless-ui/angular @angular/aria @angular/cdk

匯入樣式

在 src/styles.css 最上方匯入一次樣式表即可,ng add 也會把它放在這個位置。在 Sass 樣式表中,請改用 @use '@needless-ui/css';。樣式表中包含 Design Token 和所有元件。

styles.css
/* src/styles.css */
@layer reset, nui, app;
@import '@needless-ui/css';

所有樣式都位於 @layer nui 中。如果你的應用程式有 a { color: inherit } 這類全域重設樣式,請把它們放進一個在 nui 之前宣告的層中,以免覆寫元件樣式。

使用 Tailwind CSS 時,請把 nui 宣告在 Tailwind 的 base 層之後、utilities 層之前:這樣 Tailwind 的重設樣式就無法抵銷元件樣式,而 utility class 依然優先於元件樣式。ng add 偵測到 Tailwind 時會自動這樣做。

styles-tailwind.css
/* src/styles.css */
@layer theme, base, nui, components, utilities;
@import '@needless-ui/css';
@import 'tailwindcss';

使用元件

從各自的進入點匯入所需的指令,並將它們加入元件的 imports 中。

usage.ts
import { Component } from '@angular/core';
import { NuiButton } from '@needless-ui/angular/button';

@Component({
selector: 'app-root',
imports: [NuiButton],
template: `<button nuiButton (click)="save()">Save changes</button>`,
})
export class App {
save() {}
}

後續步驟

瀏覽元件查看互動範例,或閱讀主題設定指南,讓介面符合你的品牌。