Label

입력 항목의 이름과 필수 여부를 표시하고 입력란과 연결합니다.

Live preview
컴포넌트를 조작하면 여기에 결과가 표시됩니다.
코드 보기
HTML
<div style="display:grid;gap:16px;width:100%">
  <sy-label
    value="이메일"
    requiredposition="right"
    valueposition="left"
    width="100px"
    required
    for="field"
  ></sy-label>
  <sy-input
    placeholder="name@example.com"
    required
    id="field"
    aria-label="이메일"
  ></sy-input>
</div>

사용 가이드

#

입력 필드가 어떤 값을 요구하는지 항상 보이게 설명합니다.

  1. 입력 필드와 연결

    for에 입력 요소의 id를 지정하세요. Label을 누르면 연결한 입력 요소에 포커스가 이동합니다.

  2. 폼에 맞춰 배치

    valuePosition과 width로 위치·너비를, requiredPosition으로 필수 표시 위치를 조정합니다.

기능별 예제

#

6개 주제에서 필요한 기능을 선택하세요. 속성 설정, 메서드 호출, 이벤트 결과와 슬롯 구성을 실행 화면과 코드로 확인할 수 있습니다.

사용 예제 · Overview

선택한 예제를 직접 조작해 보세요. 여러 구성이 있는 주제는 세부 예제를 바꿀 수 있습니다.

코드 보기
HTML
예제를 불러오고 있습니다.

속성 · Disabled

설정에 따라 표시와 동작이 어떻게 달라지는지 확인하세요.

코드 보기
HTML
예제를 불러오고 있습니다.

속성 · For

설정에 따라 표시와 동작이 어떻게 달라지는지 확인하세요.

코드 보기
HTML
예제를 불러오고 있습니다.

속성 · Required

설정에 따라 표시와 동작이 어떻게 달라지는지 확인하세요.

코드 보기
HTML
예제를 불러오고 있습니다.

속성 · Value

설정에 따라 표시와 동작이 어떻게 달라지는지 확인하세요.

코드 보기
HTML
예제를 불러오고 있습니다.

속성 · Width

설정에 따라 표시와 동작이 어떻게 달라지는지 확인하세요.

코드 보기
HTML
예제를 불러오고 있습니다.

API reference

#

이름에 마우스를 올리거나 키보드로 선택하면 적용 코드를 확인할 수 있습니다. 터치 화면에서는 이름을 누르세요.

<sy-label>

Properties

Attribute / PropertyTypeDefaultDescription
booleanfalse레이블을 비활성 상태로 표시합니다. 연결된 입력에도 disabled를 지정하세요.
booleanfalse필수 표시를 추가합니다. 실제 검증은 입력 컴포넌트에 required를 지정하세요.
'left' | 'right''right'필수 표시를 레이블 왼쪽 또는 오른쪽에 배치합니다.
string''연결할 입력 요소의 id입니다.
string''현재 값 또는 항목의 식별 값입니다.
'left' | 'right' | 'center''left'레이블 영역 안의 텍스트 정렬입니다.
string''레이블 영역 너비입니다. CSS 길이 값을 사용합니다.

Slots

SlotDescription
컴포넌트의 본문 또는 자식 항목입니다.