Properties · Content
적은 글과 안내 문구입니다. 컴포넌트는 값을 갖지 않으므로 value는 대화 화면이 쥡니다.
Value 없음 · 안내 문구
value가 빈 문자열이면 placeholder가 보입니다.
Value 있음
적은 글이 그대로 보입니다.
Value · 긴 글
입력 자리는 두 줄 높이를 유지하고 그 안에서 스크롤됩니다.
className
Container에 덧붙습니다. 위쪽 선과 바깥 여백은 지워지지 않습니다.
대화 화면 맨 아래에서 메시지를 적어 보내는 한 줄입니다. 입력 자리와 첨부·보내기 버튼을 한 덩어리로 소유하고 값은 갖지 않습니다.
적은 글과 안내 문구를 바꿔 입력 줄을 검수합니다. 보내기는 빈 글에서 꺼지고, 두 button 을 누르면 아래 「마지막 동작」에 어느 callback 이 불렸는지 표시합니다.
아직 누르지 않았습니다.
Message Composer를 구성하는 실제 요소와 문서에서 사용하는 명칭입니다. Container가 위쪽 선과 바깥 여백을, Field가 경계와 Focus 표시를 소유합니다. Input은 공용 Textarea이고 두 button은 공용 Button입니다.
Message Composer structure
Message Composer
└─ Field
├─ Input
└─ Action row
├─ Attach button
└─ Send button적은 글과 안내 문구입니다. 컴포넌트는 값을 갖지 않으므로 value는 대화 화면이 쥡니다.
Value 없음 · 안내 문구
value가 빈 문자열이면 placeholder가 보입니다.
Value 있음
적은 글이 그대로 보입니다.
Value · 긴 글
입력 자리는 두 줄 높이를 유지하고 그 안에서 스크롤됩니다.
className
Container에 덧붙습니다. 위쪽 선과 바깥 여백은 지워지지 않습니다.
보내기 button의 켜짐과 꺼짐, 그리고 Field의 Focus입니다. Focus는 입력 자리든 button이든 안쪽 어디에 들어와도 Field 하나에 걸립니다.
보내기 꺼짐 · Default
빈 글과 공백만인 글에서 꺼집니다.
보내기 켜짐
앞뒤 공백을 떼고 남은 글이 있으면 켜집니다.
Field Focus
입력 자리를 누르거나 Tab으로 들어가면 Field 전체에 걸립니다. 안쪽 입력 자리는 자기 경계를 그리지 않습니다.
상위 Property와 현재 허용하는 값을 한 번에 확인합니다.
| Property | Values | Default | Status |
|---|---|---|---|
| value | string | required | Confirmed |
| onValueChange | (value: string) => void | required | Confirmed |
| onSubmit | (event: FormEvent) => void | required | Confirmed |
| placeholder | string | required | Confirmed |
| attachLabel | string | required | Confirmed |
| sendLabel | string | required | Confirmed |
| onAttach | () => void | none | Optional |
packages/ui/src/message-composer.tsx
대화 화면 맨 아래에서 메시지를 적어 보내는 한 줄이다. 입력 자리와 첨부·보내기 button 을 한 덩어리로 소유하고 값은 갖지 않는다.
MessageComposer 는 한 대화의 입력 줄이다. 대화 목록, 날짜 구분선과 메시지 하나의 표시는 message-bubble.md가 소유한다.value 로 쥐고 onValueChange 로 받는다. 보낸 뒤에 무엇을 할지(목록에 더하기, 비우기, 읽음 처리)도 대화 화면이 정한다.Button 이고 입력 자리는 공용 Textarea 다. 자기 button 이나 자기 입력 자리를 따로 만들지 않는다.onAttach 를 부르기만 하고, 고른 파일을 메시지에 붙여 보이는 것은 message-attachment.md가 소유한다.placeholder 가 담당한다.Textarea 다Button 의 Ghost · Neutral 이다Button 의 기본 Style 이다Message Composer
└─ Field
├─ Input
└─ Action row
├─ Attach button
└─ Send button
value: 필수 문자열이다. 입력 자리에 그려지는 지금 값이다onValueChange: 값이 바뀔 때 새 값을 넘겨 부른다. 필수다onSubmit: 필수다. native form 의 submit event 를 그대로 받는다. 화면이 옮겨 가지 않게 쓰는 쪽이 preventDefault() 를 부른다placeholder: 필수다. 입력 자리의 안내 문구이자 접근 가능한 이름이다attachLabel: 필수다. 첨부 button 의 문구이자 접근 가능한 이름이다sendLabel: 필수다. 보내기 button 의 문구이자 접근 가능한 이름이다onAttach: 첨부 button 을 눌렀을 때다. 파일을 고르는 길은 대화 화면이 갖는다oe-border-secondaryoe-background-primary, 경계 oe-border-secondaryoe-focus-ring, 그 바깥의 겹은 oe-focus-ring 의 20% 알파oe-foreground-primary. 안내 문구는 oe-foreground-tertiaryoe-background-disabled 와 글자 oe-foreground-disabled 도 button.md가 소유한다Textarea 는 Container 의 경계·면·Focus 를 지우고 들어간다. 둘이 모두 그리면 입력 자리에 테두리가 두 줄로 선다.Textarea 의 Container 를 가리키는 class 는 containerClassName, 안쪽 field 를 가리키는 class 는 className 이다(textarea.md의 「Layout」). 위의 지우기는 그 두 자리에서 일어난다.value 의 앞뒤 공백을 떼고 남은 것이 없으면 꺼진다. 빈 메시지와 공백만인 메시지를 보내지 않는다.type="button", 보내기는 type="submit" 이다. 첨부를 누른 것이 메시지를 보내지 않는다.placeholder 다. Field 없이 홀로 서는 자리라 Label 이 없다.aria-hidden 이고 뜻은 attachLabel 과 sendLabel 이 담당한다.disabled 다. interaction.md의 「Disabled」를 따른다.<form> 이고 data-slot="message-composer" 를 갖는다. Field 와 Action row 는 message-composer-field 와 message-composer-actions 다.className 은 Container 에 붙는다. 위쪽 선과 바깥 여백을 지우지 않고 덧붙으며, 같은 축의 값만 덮는다.sticky 를 갖지 않는다.onAttach 를 넘기지 않으면 누를 수 있지만 아무 일도 하지 않으므로, 파일을 받는 대화 화면만 이 컴포넌트를 쓴다.MessageFileAttachment 가 맡는다. 입력 줄 안에 고른 파일을 미리 보이지 않는다.value 를 컴포넌트에 맡기지 않는다. 보낸 뒤에 입력 자리를 비우는 것도 대화 화면이 onValueChange 로 한다.onSubmit 에서 preventDefault() 를 부른다. 부르지 않으면 form 이 화면을 옮긴다.| 자리 | 값 |
|---|---|
| Container 바깥 여백 | 12px, sm 이상 16px |
| Container 위쪽 선 | 1px |
| Field 모서리 | 14px |
| Field 경계 | 1px |
| Field 의 Focus 겹 | 3px |
| 입력 자리 높이 | 80px, 최소 64px |
| 입력 자리 안쪽 여백 | 좌우 12px, 위아래 8px |
| 입력 자리 글자 | 14px, line-height 20px |
| 입력 자리 줄 수 | 2줄 |
| Action row 여백 | 좌우 10px, 아래 8px |
| 두 button | 공통 Control Height 의 Small 32px |
onAttach 하나를 부르고, 고른 파일의 개수와 목록은 대화 화면이 갖는다.Field 와 함께 쓰지 않는다.attachLabel 은 필수이고 button 은 언제나 선다.