261007_01_ENH: 카카오 알림톡 미리보기 추가

This commit is contained in:
2026-10-07 15:46:46 +09:00
parent 7c4dba52ef
commit 4bcc339c51
8 changed files with 99 additions and 5 deletions

View File

@@ -254,3 +254,21 @@ import { KriScatterChart } from '@/components/chart'
- `htmlSanitizer`로 서비스의 서버 정책에 맞는 정제 함수를 주입할 수 있습니다.
- `getWysiwygCompatibility`가 `compatible: false`를 반환하면 HTML 원문을 유지하고 WYSIWYG 전환을 비활성화합니다.
- `smsPreviewSuffix`는 저장 본문에는 포함하지 않고 SMS 미리보기와 바이트 계산에만 반영합니다.
### 알림톡(KKO) 미리보기
```tsx
<KriEditor
mode="kko"
value={templateBody}
onChange={() => {}}
kkoTitle={templateTitle}
kkoSenderName="코리아리서치"
/>
```
- 편집할 수 없는 읽기 전용 미리보기입니다. `onChange`는 타입상 필수라서 빈 함수를 전달합니다.
- 본문과 제목은 텍스트로만 렌더링하며 공백·개행을 유지합니다. HTML 문자열도 글자 그대로 표시합니다.
- `#{name}`, `[$name]` 같은 변수는 원문 그대로 표시합니다. 값으로 바꿔야 하면 치환한 문자열을 `value`로 전달합니다.
- `kkoHeaderLabel` 기본값은 `알림톡 도착`이고, 본문이 비어 있으면 `placeholder`(기본값 `미리볼 내용이 없습니다.`)를 표시합니다.
- 버튼, 바로연결, 이미지, 아이템 리스트는 표시하지 않습니다.

4
package-lock.json generated
View File

@@ -1,12 +1,12 @@
{
"name": "kri-ui-registry",
"version": "0.13.1",
"version": "0.14.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "kri-ui-registry",
"version": "0.13.1",
"version": "0.14.0",
"devDependencies": {
"@tanstack/react-table": "^8.21.3",
"@tiptap/extension-color": "^3.27.1",

View File

@@ -1,6 +1,6 @@
{
"name": "kri-ui-registry",
"version": "0.13.1",
"version": "0.14.0",
"private": true,
"description": "KRI internal shadcn UI registry",
"scripts": {

View File

@@ -4,6 +4,7 @@ import type { KriEditorProps, KriEditorMode } from "./types";
import { KriEditorHtmlOnly } from "./KriEditorHtmlOnly";
import { KriEditorWysiwyg } from "./KriEditorWysiwyg";
import {KriEditorSms} from "./KriEditorSms";
import { KriEditorKko } from "./KriEditorKko";
function resolveMode(mode?: KriEditorMode, editorMode?: KriEditorMode): KriEditorMode {
return mode ?? editorMode ?? "wysiwyg";
@@ -20,5 +21,9 @@ export function KriEditor(props: KriEditorProps) {
return <KriEditorSms {...props} mode={mode} />
}
if (mode === "kko") {
return <KriEditorKko {...props} mode={mode} />;
}
return <KriEditorWysiwyg {...props} mode={mode} />;
}

View File

@@ -0,0 +1,59 @@
'use client'
import { User } from 'lucide-react'
import { cn } from '@/lib/utils'
import type { KriEditorProps } from './types'
type KkoEditorProps = Omit<KriEditorProps, 'mode'> & { mode: 'kko' }
export function KriEditorKko({
label,
value,
placeholder = '미리볼 내용이 없습니다.',
className,
kkoTitle = '',
kkoSenderName = '',
kkoHeaderLabel = '알림톡 도착',
}: KkoEditorProps) {
const body = value ?? ''
return (
<div className={cn('mx-auto w-full max-w-[320px]', className)}>
{label ? <div className="mb-2 text-sm font-semibold">{label}</div> : null}
<div className="relative h-[600px] w-full overflow-hidden rounded-[40px] border-8 border-gray-800 bg-white shadow-2xl">
<div className="absolute top-0 left-1/2 z-10 h-6 w-32 -translate-x-1/2 rounded-b-2xl bg-gray-800" />
<div className="flex h-full flex-col bg-[#d6e4f7] pt-8 pb-4">
{kkoSenderName ? (
<div className="border-b border-black/10 px-4 pb-3 text-center text-sm font-bold text-gray-900">{kkoSenderName}</div>
) : null}
<div className="flex-1 overflow-y-auto px-3 py-3">
{kkoSenderName ? (
<div className="mb-1 flex items-center gap-2">
<span aria-hidden="true" className="flex size-8 shrink-0 items-center justify-center rounded-full bg-gray-300 text-white">
<User className="size-5" />
</span>
<span className="text-xs text-gray-600">{kkoSenderName}</span>
</div>
) : null}
<div className="relative mr-3 ml-10 rounded-xl bg-white shadow-sm">
<span
aria-hidden="true"
className="absolute -top-3 -right-3 flex size-8 items-center justify-center rounded-full bg-gray-800 text-[9px] font-bold text-white"
>
kakao
</span>
<div className="rounded-t-xl bg-[#FEE500] px-4 py-3 text-sm font-bold text-gray-900">{kkoHeaderLabel}</div>
{kkoTitle ? <div className="px-4 pt-3 text-sm font-bold break-words whitespace-pre-wrap text-gray-800">{kkoTitle}</div> : null}
{body.trim() ? (
<div className="px-4 py-3 text-sm leading-relaxed break-words whitespace-pre-wrap text-gray-700">{body}</div>
) : (
<div className="px-4 py-3 text-sm text-gray-400">{placeholder}</div>
)}
</div>
</div>
</div>
<div className="absolute bottom-2 left-1/2 h-1 w-32 -translate-x-1/2 rounded-full bg-gray-800" />
</div>
</div>
)
}

View File

@@ -1,5 +1,6 @@
export { KriEditor } from './KriEditor'
export { KriEditorHtmlOnly } from './KriEditorHtmlOnly'
export { KriEditorKko } from './KriEditorKko'
export { KriEditorSms } from './KriEditorSms'
export { KriEditorWysiwyg } from './KriEditorWysiwyg'
export { ToolbarButton as KriEditorToolbarButton } from './toolbar/ToolbarButton'

View File

@@ -2,7 +2,7 @@ import type { Extensions } from '@tiptap/core'
import type { Editor } from '@tiptap/react'
import type { ReactNode } from 'react'
export type KriEditorMode = 'wysiwyg' | 'both' | 'html' | 'sms'
export type KriEditorMode = 'wysiwyg' | 'both' | 'html' | 'sms' | 'kko'
export type KriEditorUploadResult = string | { url: string }
export type KriEditorToolbarFeature =
@@ -89,6 +89,12 @@ export type KriEditorProps = {
smsHasAttachment?: boolean
/** 문자 미리보기의 제목과 본문 사이에 표시할 첨부 이미지 */
smsImages?: KriEditorSmsImage[]
/** 알림톡 미리보기의 강조 제목. 없으면 표시하지 않는다. */
kkoTitle?: string
/** 알림톡 미리보기의 채널명·발신 프로필 이름. 없으면 표시하지 않는다. */
kkoSenderName?: string
/** 알림톡 말풍선 상단 문구. 기본값 "알림톡 도착" */
kkoHeaderLabel?: string
toolbar?: KriEditorToolbarConfig | false
fontFamilyOptions?: KriEditorFontFamilyOption[]
renderToolbarEnd?: (context: KriEditorToolbarContext) => ReactNode

View File

@@ -319,7 +319,7 @@
"name": "kri-editor",
"type": "registry:component",
"title": "KRI Editor",
"description": "WYSIWYG, HTML, SMS 모드와 주입형 이미지 업로드 및 선택형 툴바를 제공하는 편집기입니다.",
"description": "WYSIWYG, HTML, SMS 모드, 알림톡(KKO) 미리보기와 주입형 이미지 업로드 및 선택형 툴바를 제공하는 편집기입니다.",
"registryDependencies": [
"button",
"dropdown-menu",
@@ -359,6 +359,11 @@
"type": "registry:component",
"target": "@components/kri-editor/KriEditorHtmlOnly.tsx"
},
{
"path": "kri-editor/KriEditorKko.tsx",
"type": "registry:component",
"target": "@components/kri-editor/KriEditorKko.tsx"
},
{
"path": "kri-editor/KriEditorSms.tsx",
"type": "registry:component",