Files
XRLib/Assets/Sample/UIToolkit/UTKStyleGuideSample.Input.cs
2026-02-02 19:33:27 +09:00

689 lines
20 KiB
C#

#nullable enable
using System;
using System.Collections.Generic;
using Cysharp.Threading.Tasks;
using UnityEngine;
using UnityEngine.UIElements;
using UVC.UIToolkit;
/// <summary>
/// UTKStyleGuideSample의 Input 카테고리 Initialize 메서드들
/// </summary>
public partial class UTKStyleGuideSample
{
#region Input Initializers
private void InitializeInputFieldSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 입력 필드
var input = new UTKInputField();
input.label = ""이름""; // Unity TextField의 label 프로퍼티 (소문자)
input.Placeholder = ""이름을 입력하세요"";
input.OnValueChanged += (value) => Debug.Log($""입력값: {value}"");
// 비밀번호 입력 필드
var password = new UTKInputField();
password.label = ""비밀번호"";
password.isPasswordField = true;
// 검증 오류 표시
input.ErrorMessage = ""이름은 필수입니다."";
input.ErrorMessage = """"; // 오류 제거
// 변형 스타일
input.Variant = UTKInputField.InputFieldVariant.Outlined;
// 이벤트
input.OnFocused += () => Debug.Log(""포커스"");
input.OnBlurred += () => Debug.Log(""포커스 해제"");
input.OnSubmit += (value) => Debug.Log($""제출: {value}"");
// 비활성화
input.IsEnabled = false;
// 읽기 전용
input.isReadOnly = true;
// 여러 줄 입력
input.multiline = true;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 입력 필드 -->
<utk:UTKInputField label=""이름"" />
<!-- 플레이스홀더 -->
<utk:UTKInputField label=""이메일"" placeholder=""example@email.com"" />
<!-- 비밀번호 필드 -->
<utk:UTKInputField label=""비밀번호"" is-password-field=""true"" />
<!-- 여러 줄 입력 -->
<utk:UTKInputField label=""설명"" multiline=""true"" />
<!-- 비활성화 -->
<utk:UTKInputField label=""읽기전용"" is-enabled=""false"" value=""수정 불가"" />
</ui:UXML>");
}
private void InitializeIntegerFieldSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 정수 필드
var intField = new UTKIntegerField(""나이"");
intField.Value = 25;
intField.OnValueChanged += (value) => Debug.Log($""나이: {value}"");
// 범위 제한 (이벤트로 처리)
intField.OnValueChanged += (value) =>
{
if (value < 0) intField.Value = 0;
if (value > 150) intField.Value = 150;
};
// 비활성화
intField.IsEnabled = false;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 정수 필드 -->
<utk:UTKIntegerField label=""나이"" />
<!-- 기본값 설정 -->
<utk:UTKIntegerField label=""점수"" value=""100"" />
<!-- 비활성화 -->
<utk:UTKIntegerField label=""읽기전용"" is-enabled=""false"" value=""50"" />
</ui:UXML>");
}
private void InitializeLongFieldSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 Long 필드
var longField = new UTKLongField(""파일 크기"");
longField.Value = 1073741824; // 1GB
longField.OnValueChanged += (value) => Debug.Log($""크기: {value} bytes"");
// 비활성화
longField.IsEnabled = false;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 Long 필드 -->
<utk:UTKLongField label=""파일 크기"" />
<!-- 기본값 설정 -->
<utk:UTKLongField label=""큰 숫자"" value=""9223372036854775807"" />
<!-- 비활성화 -->
<utk:UTKLongField label=""읽기전용"" is-enabled=""false"" />
</ui:UXML>");
}
private void InitializeFloatFieldSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 Float 필드
var floatField = new UTKFloatField(""속도"");
floatField.Value = 9.8f;
floatField.OnValueChanged += (value) => Debug.Log($""속도: {value}"");
// 범위 제한 (이벤트로 처리)
floatField.OnValueChanged += (value) =>
{
if (value < 0f) floatField.Value = 0f;
if (value > 100f) floatField.Value = 100f;
};
// 비활성화
floatField.IsEnabled = false;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 Float 필드 -->
<utk:UTKFloatField label=""속도"" />
<!-- 기본값 설정 -->
<utk:UTKFloatField label=""중력"" value=""9.8"" />
<!-- 비활성화 -->
<utk:UTKFloatField label=""읽기전용"" is-enabled=""false"" value=""3.14"" />
</ui:UXML>");
}
private void InitializeDoubleFieldSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 Double 필드
var doubleField = new UTKDoubleField(""정밀도"");
doubleField.Value = 3.141592653589793;
doubleField.OnValueChanged += (value) => Debug.Log($""값: {value}"");
// 비활성화
doubleField.IsEnabled = false;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 Double 필드 -->
<utk:UTKDoubleField label=""정밀도"" />
<!-- 기본값 설정 -->
<utk:UTKDoubleField label=""파이"" value=""3.141592653589793"" />
<!-- 비활성화 -->
<utk:UTKDoubleField label=""읽기전용"" is-enabled=""false"" />
</ui:UXML>");
}
private void InitializeNumberStepperSample(VisualElement root)
{
var disabledRow = root.Q<VisualElement>("stepper-disabled-row");
if (disabledRow != null)
{
var stepper = new UTKNumberStepper(0, 100, 30, 1);
stepper.style.width = 150;
stepper.SetEnabled(false);
disabledRow.Add(stepper);
}
SetCodeSamples(root,
csharpCode: @"// 기본 사용법
var stepper = new UTKNumberStepper(minValue: 0, maxValue: 100, value: 50, step: 1);
stepper.OnValueChanged += (newValue) => Debug.Log($""Value: {newValue}"");
// Step 설정
var stepper5 = new UTKNumberStepper(0, 100, 25, 5); // Step 5씩 증감
// Wrap Around (최소/최대값에서 순환)
var wrapStepper = new UTKNumberStepper(0, 100, 0, 10);
wrapStepper.WrapAround = true; // 0 -> -10 시 100으로 순환
// 비활성화
var disabledStepper = new UTKNumberStepper(0, 100, 30, 1);
disabledStepper.SetEnabled(false);
// 속성 변경
stepper.Value = 75;
stepper.MinValue = 10;
stepper.MaxValue = 90;
stepper.Step = 2;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- Step 1 -->
<utk:UTKNumberStepper min-value=""0"" max-value=""100"" value=""50"" step=""1"" />
<!-- Step 5 -->
<utk:UTKNumberStepper min-value=""0"" max-value=""100"" value=""25"" step=""5"" />
<!-- Wrap Around -->
<utk:UTKNumberStepper min-value=""0"" max-value=""100"" value=""0"" step=""10"" wrap-around=""true"" />
<!-- 비활성화 -->
<utk:UTKNumberStepper min-value=""0"" max-value=""100"" value=""30"" step=""1"" is-enabled=""false"" />
<!-- 커스텀 스타일 -->
<utk:UTKNumberStepper class=""custom-stepper"" style=""width: 150px;"" />
</ui:UXML>");
}
private void InitializeVector2FieldSample(VisualElement root)
{
var field = root.Q<UTKVector2Field>("vec2-position");
if (field != null)
{
field.Value = new Vector2(100, 200);
}
SetCodeSamples(root,
csharpCode: @"// 기본 사용법
var positionField = new UTKVector2Field(""Position"");
positionField.Value = new Vector2(100, 200);
positionField.OnValueChanged += (newValue) => Debug.Log($""Position: {newValue}"");
// 라벨 없이
var field = new UTKVector2Field();
field.label = """";
// 읽기 전용
var readOnlyField = new UTKVector2Field(""ReadOnly"");
readOnlyField.SetEnabled(false);",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 사용 -->
<utk:UTKVector2Field label=""Position"" />
<!-- 라벨 없이 -->
<utk:UTKVector2Field />
<!-- 비활성화 -->
<utk:UTKVector2Field label=""ReadOnly"" is-enabled=""false"" />
</ui:UXML>");
}
private void InitializeVector3FieldSample(VisualElement root)
{
var field = root.Q<UTKVector3Field>("vec3-position");
if (field != null)
{
field.Value = new Vector3(10, 20, 30);
}
SetCodeSamples(root,
csharpCode: @"// 기본 사용법
var positionField = new UTKVector3Field(""Position"");
positionField.Value = new Vector3(10, 20, 30);
positionField.OnValueChanged += (newValue) => Debug.Log($""Position: {newValue}"");
// 회전 벡터
var rotationField = new UTKVector3Field(""Rotation"");
rotationField.Value = new Vector3(0, 90, 0);
// 비활성화
var disabledField = new UTKVector3Field(""Disabled"");
disabledField.SetEnabled(false);",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 사용 -->
<utk:UTKVector3Field label=""Position"" />
<!-- 라벨 없이 -->
<utk:UTKVector3Field />
<!-- 비활성화 -->
<utk:UTKVector3Field label=""Disabled"" is-enabled=""false"" />
</ui:UXML>");
}
private void InitializeVector4FieldSample(VisualElement root)
{
var field = root.Q<UTKVector4Field>("vec4-color");
if (field != null)
{
field.Value = new Vector4(1, 0.5f, 0.25f, 1);
}
SetCodeSamples(root,
csharpCode: @"// 기본 사용법
var colorField = new UTKVector4Field(""Color"");
colorField.Value = new Vector4(1, 0.5f, 0.25f, 1); // RGBA
colorField.OnValueChanged += (newValue) => Debug.Log($""Color: {newValue}"");
// 쿼터니언 값
var quaternionField = new UTKVector4Field(""Quaternion"");
var quat = Quaternion.identity;
quaternionField.Value = new Vector4(quat.x, quat.y, quat.z, quat.w);
// 비활성화
var disabledField = new UTKVector4Field(""Disabled"");
disabledField.SetEnabled(false);",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 사용 -->
<utk:UTKVector4Field label=""Color"" />
<!-- 라벨 없이 -->
<utk:UTKVector4Field />
<!-- 비활성화 -->
<utk:UTKVector4Field label=""Disabled"" is-enabled=""false"" />
</ui:UXML>");
}
private void InitializeRectFieldSample(VisualElement root)
{
var field = root.Q<UTKRectField>("rect-area");
if (field != null)
{
field.Value = new Rect(10, 20, 100, 50);
}
SetCodeSamples(root,
csharpCode: @"// 기본 사용법
var areaField = new UTKRectField(""Area"");
areaField.Value = new Rect(10, 20, 100, 50); // x, y, width, height
areaField.OnValueChanged += (newValue) => Debug.Log($""Rect: {newValue}"");
// 화면 영역 설정
var screenArea = new UTKRectField(""Screen Area"");
screenArea.Value = new Rect(0, 0, Screen.width, Screen.height);
// 비활성화
var disabledField = new UTKRectField(""Disabled"");
disabledField.SetEnabled(false);",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 사용 -->
<utk:UTKRectField label=""Area"" />
<!-- 라벨 없이 -->
<utk:UTKRectField />
<!-- 비활성화 -->
<utk:UTKRectField label=""Disabled"" is-enabled=""false"" />
</ui:UXML>");
}
private void InitializeBoundsFieldSample(VisualElement root)
{
var field = root.Q<UTKBoundsField>("bounds-collision");
if (field != null)
{
field.Value = new Bounds(new Vector3(0, 1, 0), new Vector3(2, 2, 2));
}
SetCodeSamples(root,
csharpCode: @"// 기본 사용법
var boundsField = new UTKBoundsField(""Bounds"");
var center = new Vector3(0, 1, 0);
var size = new Vector3(2, 2, 2);
boundsField.Value = new Bounds(center, size);
boundsField.OnValueChanged += (newValue) => Debug.Log($""Bounds: {newValue}"");
// 콜라이더 범위 설정
var collisionField = new UTKBoundsField(""Collision Bounds"");
collisionField.Value = new Bounds(Vector3.zero, Vector3.one * 5);
// 비활성화
var disabledField = new UTKBoundsField(""Disabled"");
disabledField.SetEnabled(false);",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 사용 -->
<utk:UTKBoundsField label=""Bounds"" />
<!-- 라벨 없이 -->
<utk:UTKBoundsField />
<!-- 비활성화 -->
<utk:UTKBoundsField label=""Disabled"" is-enabled=""false"" />
</ui:UXML>");
}
#endregion
#region Dropdown Initializers
private void InitializeDropdownSample(VisualElement root)
{
var normalRow = root.Q<VisualElement>("dropdown-normal-row");
if (normalRow != null)
{
var dropdown = new UTKDropdown("Select Option");
dropdown.SetOptions(new List<string> { "Option 1", "Option 2", "Option 3", "Option 4" });
dropdown.SelectedIndex = 0;
normalRow.Add(dropdown);
}
var disabledRow = root.Q<VisualElement>("dropdown-disabled-row");
if (disabledRow != null)
{
var dropdown = new UTKDropdown("Disabled");
dropdown.SetOptions(new List<string> { "Option 1", "Option 2" });
dropdown.SelectedIndex = 0;
dropdown.IsEnabled = false;
disabledRow.Add(dropdown);
}
SetCodeSamples(root,
csharpCode: @"// 기본 사용법
var dropdown = new UTKDropdown(""Select Option"");
dropdown.SetOptions(new List<string> { ""Option 1"", ""Option 2"", ""Option 3"", ""Option 4"" });
dropdown.SelectedIndex = 0;
// 선택 이벤트
dropdown.OnSelectionChanged += (index) =>
{
Debug.Log($""선택된 인덱스: {index}"");
};
// 선택된 값 가져오기
var selectedIndex = dropdown.SelectedIndex;
var selectedValue = dropdown.SelectedValue;
// 옵션 동적 변경
dropdown.SetOptions(new List<string> { ""New 1"", ""New 2"", ""New 3"" });
// 프로그램으로 선택
dropdown.SelectedIndex = 2;
// Disabled
var disabledDropdown = new UTKDropdown(""Disabled"");
disabledDropdown.SetOptions(new List<string> { ""Option 1"", ""Option 2"" });
disabledDropdown.SelectedIndex = 0;
disabledDropdown.IsEnabled = false;",
uxmlCode: @"<!-- UTKDropdown은 동적 생성 권장 -->
<!-- C# 코드에서 SetOptions로 옵션 설정 -->
<!-- 기본 드롭다운 -->
<utk:UTKDropdown name=""dropdown-1"" text=""Select Option"" />
<!-- Disabled -->
<utk:UTKDropdown name=""dropdown-2"" text=""Disabled"" is-enabled=""false"" />");
}
private enum SampleEnum { Option1, Option2, Option3 }
private void InitializeEnumDropDownSample(VisualElement root)
{
var enumRow = root.Q<VisualElement>("enum-dropdown-row");
if (enumRow != null)
{
var field = new UTKEnumDropDown("Choice", SampleEnum.Option1);
enumRow.Add(field);
}
SetCodeSamples(root,
csharpCode: @"// Enum 정의
public enum SampleEnum { Option1, Option2, Option3 }
// 기본 사용법
var enumField = new UTKEnumDropDown(""Choice"", SampleEnum.Option1);
// 값 변경 이벤트
enumField.OnValueChanged += (newValue) =>
{
Debug.Log($""선택된 값: {newValue}"");
};
// 현재 선택된 값 가져오기
var currentValue = enumField.Value;
// 프로그램으로 값 변경
enumField.Value = SampleEnum.Option2;
// Disabled
enumField.IsEnabled = false;",
uxmlCode: @"<!-- UTKEnumDropDown은 동적 생성 권장 -->
<!-- C# 코드에서 enum 타입과 초기값 지정 -->
<!-- 기본 Enum 드롭다운 -->
<utk:UTKEnumDropDown name=""enum-dropdown-1"" label=""Choice"" />
<!-- Disabled -->
<utk:UTKEnumDropDown name=""enum-dropdown-2"" label=""Choice"" is-enabled=""false"" />");
}
#region Slider Initializers
private void InitializeSliderSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 슬라이더
var slider = new UTKSlider();
slider.label = ""볼륨""; // Unity Slider의 label 프로퍼티 (소문자)
slider.lowValue = 0;
slider.highValue = 100;
slider.value = 50;
slider.OnValueChanged += (value) => Debug.Log($""볼륨: {value}"");
// 생성자로 생성
var volumeSlider = new UTKSlider(""볼륨"", 0, 100, 75);
// 정수만 허용
slider.showInputField = true;
// 비활성화
slider.IsEnabled = false;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 슬라이더 -->
<utk:UTKSlider label=""볼륨"" low-value=""0"" high-value=""100"" value=""50"" />
<!-- 정수만 -->
<utk:UTKSlider label=""레벨"" low-value=""1"" high-value=""10"" value=""5"" whole-numbers=""true"" />
<!-- 비활성화 -->
<utk:UTKSlider label=""잠금"" is-enabled=""false"" value=""30"" />
</ui:UXML>");
}
private void InitializeSliderIntSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 정수 슬라이더
var slider = new UTKSliderInt();
slider.label = ""레벨""; // Unity SliderInt의 label 프로퍼티 (소문자)
slider.lowValue = 1;
slider.highValue = 10;
slider.value = 5;
slider.OnValueChanged += (value) => Debug.Log($""레벨: {value}"");
// 생성자로 생성
var levelSlider = new UTKSliderInt(""레벨"", 1, 10, 5);
// 수량 슬라이더
var quantitySlider = new UTKSliderInt(""수량"", 0, 100, 25);
quantitySlider.OnValueChanged += (value) => Debug.Log($""수량: {value}"");
// 페이지 선택
var pageSlider = new UTKSliderInt(""페이지"", 1, 100, 1);
pageSlider.OnValueChanged += (page) => LoadPage(page);
// 비활성화
slider.IsEnabled = false;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 정수 슬라이더 -->
<utk:UTKSliderInt label=""레벨"" low-value=""1"" high-value=""10"" value=""5"" />
<!-- 큰 범위 -->
<utk:UTKSliderInt label=""수량"" low-value=""0"" high-value=""100"" value=""25"" />
<!-- 비활성화 -->
<utk:UTKSliderInt label=""잠금"" is-enabled=""false"" value=""30"" />
</ui:UXML>");
}
private void InitializeMinMaxSliderSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 MinMax 슬라이더
var minMaxSlider = new UTKMinMaxSlider();
minMaxSlider.label = ""가격 범위""; // Unity MinMaxSlider의 label 프로퍼티
minMaxSlider.lowLimit = 0; // 전체 범위 최소값
minMaxSlider.highLimit = 1000; // 전체 범위 최대값
minMaxSlider.MinValue = 100; // 선택 범위 최소값
minMaxSlider.MaxValue = 500; // 선택 범위 최대값
// 값 변경 이벤트 (Vector2로 반환됨)
minMaxSlider.OnValueChanged += (range) =>
{
Debug.Log($""범위: {range.x} ~ {range.y}"");
};
// 생성자로 생성 (label, lowLimit, highLimit, minValue, maxValue)
var rangeSlider = new UTKMinMaxSlider(""범위"", 0, 100, 20, 80);
// 비활성화
minMaxSlider.IsEnabled = false;",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 MinMax 슬라이더 -->
<utk:UTKMinMaxSlider label=""가격 범위"" min-limit=""0"" max-limit=""1000"" min-value=""100"" max-value=""500"" />
<!-- 비활성화 -->
<utk:UTKMinMaxSlider label=""잠금"" is-enabled=""false"" />
</ui:UXML>");
}
private void InitializeProgressBarSample(VisualElement root)
{
SetCodeSamples(root,
csharpCode: @"// 기본 프로그레스 바
var progressBar = new UTKProgressBar();
progressBar.title = ""다운로드""; // ProgressBar의 title 프로퍼티
progressBar.MinValue = 0; // 또는 lowValue 직접 사용
progressBar.MaxValue = 100; // 또는 highValue 직접 사용
progressBar.Value = 45;
// 생성자로 생성 (title, minValue, maxValue, defaultValue)
var downloadBar = new UTKProgressBar(""다운로드"", 0, 100, 75);
// 진행률 업데이트
progressBar.Value = 75;
// 퍼센트 표시
progressBar.ShowPercentage = true;
// 색상 변형
progressBar.Variant = UTKProgressBar.ProgressBarVariant.Success;
progressBar.Variant = UTKProgressBar.ProgressBarVariant.Warning;
progressBar.Variant = UTKProgressBar.ProgressBarVariant.Danger;
// 비동기 작업 진행률 표시
async UniTask LoadDataAsync()
{
for (int i = 0; i <= 100; i += 10)
{
progressBar.Value = i;
await UniTask.Delay(100);
}
}",
uxmlCode: @"<!-- 네임스페이스 선언 -->
<ui:UXML xmlns:utk=""UVC.UIToolkit"">
<!-- 기본 프로그레스 바 -->
<utk:UTKProgressBar label=""로딩"" low-value=""0"" high-value=""100"" value=""45"" />
<!-- 성공 스타일 -->
<utk:UTKProgressBar label=""완료"" value=""100"" variant=""Success"" />
<!-- 경고 스타일 -->
<utk:UTKProgressBar label=""주의"" value=""75"" variant=""Warning"" />
<!-- 위험 스타일 -->
<utk:UTKProgressBar label=""오류"" value=""30"" variant=""Danger"" />
</ui:UXML>");
}
#endregion
#endregion
}