);
};
export default App;
```
컴포넌트에서 아이콘을 사용하려면, 다음과 같은 방법으로 아이콘을 가져올 수 있습니다.
```tsx
import React from 'react';
import { IconButton } from '@lotte-innovate/lui';
import { MagnifyingGlassIcon } from '@radix-ui/react-icons';
const App = () => {
return (
);
};
export default App;
```
## Components
컴포넌트 목록
| 구분 | 종류 |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Typography 컴포넌트 | Header, Text |
| 기본 컴포넌트 | Avatar, Badge, Button, IconButton, Label |
| 입력 컴포넌트 | DatePicker, DatetimePicker, Editor, Slider, TextArea, TextField |
| 선택 컴포넌트 | Checkbox, CheckboxCards, CheckboxGroup, Radio, RadioCards, RadioGroup, Select, Toggle, ToggleGroup, ToggleSwitch |
| 네비게이션 컴포넌트 | Breadcrumb, DynamicTabs, GNB, Menubar, NavigationMenu, SNB, Tab Nav, Tabs |
| 레이아웃 컴포넌트 | AspectRatio, Box, Card, Collapsible, Container, Flex, Footer, Grid, GridLayout, Inset, ScrollArea, Separator, Table, Timeline |
| 피드백 컴포넌트 | AlertDialog, Dialog, HoverCard, Modal, Popover, Toast, Tooltip |
| 로딩 컴포넌트 | Progress, Skeleton, Spinner |
| 메뉴 선택 컴포넌트 | ContextMenu, DropdownMenu, SegmentedControl |
| 그 외 컴포넌트 | Accordian, Callout, DataList, SearchBar |
차트 목록
| 구분 | 종류 |
| --------- | ------------- |
| 비교 차트 | Bar, Line |
| 구성 차트 | Pie, Doughnut |
| 분포 차트 | Bubble |
| 관계 차트 | Radar |
공통 Props 목록
| name | description | 단계 | option | 테마적용여부 |
| ---------- | ------------------------------------------------- | -------- | --------------------------------------------- | ------------ |
| Color | 27가지 색상을 라이트/다크/알파/알파다크 모드 제공 | 1~12단계 | blue, crimson, teal, orange, purple, amber... | O |
| Radius | 컴포넌트의 둥글기 적용 | 5단계 | none, small, medium, large, full | O |
| Scaling | 컴포넌트의 비율 | 5단계 | 90%, 95%, 100%, 105%, 110% | O |
| Weight | 컴포넌트의 텍스트 굵기 | 4단계 | regular, medium, semibold, bold | O |
| Appearance | 컴포넌트의 디자인 스타일 | 6단계 | classic, ghost, outline, soft, solid, surface | X |
| Size | 컴포넌트의 크기 | 5단계 | x-small, small, medium, large, x-large | X |
## Theme
각 컴포넌트들은 공통 Props를 개별적으로 적용할 수도 있고, 테마를 통해 컴포넌트의 스타일을 한번에 변경할 수도 있습니다.
L-UI는 테마 컨텍스트를 제공하여 `Color`, `Radius`, `Scaling`, `Weight` 를 모든 컴포넌트에 동일한 스타일을 지정할 수 있습니다.
먼저 App 최상단에 `LuiThemeProvider`를 추가하여 테마 컨텍스트를 제공합니다.
> Next.js와 같은 프레임워크를 사용하는 프로젝트에서 사용 예시
```tsx
import { LuiThemeProvider } from '@lotte-innovate/lui';
export default function RootLayout({
children,
}: Readonly<{
children: React.ReactNode;
}>) {
return (
{children}
);
}
```
> Next.js App router 에서 Layout.tsx 을 사용하는 예시 코드
`ThemeProvider`를 프로젝트의 가장 가까운 `layout.tsx` 파일에 추가해야 합니다.
이렇게 하면 `ThemeProvider`가 해당 레이아웃 내의 모든 컴포넌트에 테마 상태를 제공할 수 있습니다.
```tsx
import React from 'react';
import { LuiThemeProvider } from '@lotte-innovate/lui';
const Layout = ({ children }: { children: React.ReactNode }) => {
return {children};
};
export default Layout;
```
> 클라이언트 사이드 프로젝트에서 사용 예시
```tsx
import { LuiThemeProvider } from '@lotte-innovate/lui';
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(
,
);
```
테마를 변경하려면 `useTheme`훅을 사용합니다.
`useTheme`훅은 현재 테마와 테마를 업데이트할 수 있는 함수를 제공합니다.
```tsx
import { useTheme, Button } from '@lotte-innovate/lui';
const ThemeChanger = () => {
const { theme, updateTheme } = useTheme();
// 초기 값 설정 시
theme.themeRadius = 'none';
theme.themeColor = 'olive';
theme.themeScaling = '90%';
theme.themeWeight = 'regular';
// 테마 변경 시
useEffect(() => {
updateTheme({ themeRadius: 'full', themeColor: 'amber', themeScaling: '110%' });
}, []);
return (
);
};
```
테마가 적용되었지만 일부 컴포넌트는 스타일을 다르게 하고 싶은 경우, 각 컴포넌트에 직접 Props를 전달하여 스타일을 재정의할 수 있습니다.
```tsx
import { useTheme, Button } from '@lotte-innovate/lui';
const ThemeChanger = () => {
const { theme } = useTheme();
theme.themeRadius: 'full';
theme.themeColor: 'blue';
return (
);
};
```
## License
@lotte-innovate
---
_Source: https://npm.io/package/@lotte-innovate/ui-component-test · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._