Skip to content

3. Complication

Jungho Song edited this page Jul 24, 2017 · 18 revisions

워치의 시계화면과 함께 구성되는 요소로 다양한 종류가 있고 시계 유형에 사용할 수 있는 형태가 다릅니다.

Apple HIG 가이드의 Complications를 기준으로 구현되었습니다.


상수

RingStyle

Ring Image와 Ring Text의 링스타일

https://developer.apple.com/reference/clockkit/clkcomplicationringstyle

RingStyle.Closed

닫힌 원을 만들기 위해 12시 방향에서 값이 시계 방향으로 증가하는 스타일입니다. 전체의 백분율 값을 전달하려는 경우 이 스타일을 사용하십시오.
일부 작업의 완료율을 나타낼 수 있습니다.

RingStyle.Open

값이 시계 방향으로 약 7 시부 터 시작하여 말굽 모양을 채우고 원의 아래쪽에 개구부를 남기는 스타일입니다.
절대 최소 또는 최대를 나타내지 않는 다른 두 값 사이에있는 값을 전달하려는 경우 이 스타일을 사용하십시오.
온도계 또는 속도계에 이 스타일을 사용할 수 있습니다.

ColumnAlignment

Circular, Utilitarian 컴플리케이션 열의 텍스트 전/후(좌/우) 정렬

https://developer.apple.com/reference/clockkit/clkcomplicationcolumnalignment

ColumnAlignment.Leading

전행

ColumnAlignment.Trailing

후행


속성

Comlplication.columnAlignment

[ColumnAlignment] 컴플리케이션 정렬 (WatchOS 컴플리케이션 정보의 배열 순서에 따라 자동으로 설정됨)

Complication.tintColor

[Color] 컴플리케이션 색조 (기본값 : "white")


객체

textProvider

https://developer.apple.com/reference/clockkit/clktextprovider

  • label [String] : 레이블
  • tintColor [Color] : 색조

imageProvider

https://developer.apple.com/reference/clockkit/clkimageprovider

  • onePieceImage [String] : 첫번째 이미지 경로
  • tintColor [Color] : 색조

함수

Family

https://developer.apple.com/reference/clockkit/clkcomplicationfamily

modularSmall()

Modular 에 사용되는 작은 사각형 영역
modularSmall

modularLarge()

Modular 에 사용되는 큰 직사각형 영역
modularLarge

utilitarianSmall()

Utility, Mickey, Chronograph 및 Simple 에 사용되는 작은 정사각형 또는 직사각형 영역
utilitarianSmall

utilitarianSmallFlat(options)

Utilitarian small family 의 하위 집합
Utilitarian small flat 을 사용하여 Utility, Mickey, Chronograph 및 Simple 에 한 줄에 이미지와 텍스트를 표시
utilitarianSmallFlat utilitarianSmallFlat

Options
  • imageProvider [imageProvider] : 이미지
  • textProvider [textProvider] : 텍스트

utilitarianLarge(options)

Utility와 Mickey 에서 화면의 너비에 걸쳐있는 큰 직사각형 영역
utilitarianLarge

Options
  • imageProvider [imageProvider] : 이미지
  • textProvider [textProvider] : 텍스트

circularSmall()

Color clock face 에 사용되는 작은 원형 영역
circularSmall

extraLarge()

X-Large 에 사용되는 큰 정사각형 영역
extraLarge

Template

simpleImage(options)

CircularSmallSimpleImage ModularSmallSimpleImage ExtraLargeSimpleImage
CircularSmallSimpleImage ModularSmallSimpleImage ExtraLargeSimpleImage
Options
  • imageProvider [imageProvider] : 이미지

simpleText(options)

CircularSmallSimpleText ModularSmallSimpleText ExtraLargeSimpleText
CircularSmallSimpleText ModularSmallSimpleText ExtraLargeSimpleText
Options
  • textProvider [textProvider] : 텍스트

ringImage(options)

CircularSmallRingImage ModularSmallRingImage UtilitarianSmallRingImage ExtraLargeRingImage
CircularSmallRingImage ModularSmallRingImage UtilitarianSmallRingImage ExtraLargeRingImage
Options
  • imageProvider [imageProvider] : 이미지
  • ringStyle [RingStyle] : 링스타일 (기본값 : RingStyle.Closed)
  • fillFraction [Number] : 채우기 비율 (범위 : 0.0 ~ 1.0)

ringText(options)

구현예정

CircularSmallRingText ModularSmallRingText UtilitarianSmallRingText ExtraLargeRingText
CircularSmallRingText ModularSmallRingText UtilitarianSmallRingText ExtraLargeRingText

stackText(options)

CircularSmallStackText ModularSmallStackText ExtraLargeStackText
CircularSmallStackText ModularSmallStackText ExtraLargeStackText
Options
  • line1TextProvider [textProvider] : 위 라인 텍스트
  • line2TextProvider [textProvider] : 아래 라인 텍스트
  • highlightLine2 [Boolean] : 밝은 선으로 그려야하는 선을 나타내는 값

stackImage(options)

구현예정

CircularSmallStackImage ModularSmallStackImage ExtraLargeStackImage
CircularSmallStackImage ModularSmallStackImage ExtraLargeStackImage

columnText(options)

구현예정

ModularSmallColumnText ModularLargeColumnText
ModularSmallColumnText ModularLargeColumnText

standardBody(options)

구현예정

ModularLargeStandardBody
ModularLargeStandardBody

table(options)

구현예정

ModularLargeTable
ModularLargeTable

tallBody(options)

ModularLargeTallBody
ModularLargeTallBody
Options

smallFlat(options)

UtilitarianSmallFlat
UtilitarianSmallFlat
Options

square(options)

UtilitarianSmallSquare
UtilitarianSmallSquare
Options