TextOptions interface
SymbolLayer에서 텍스트를 사용자 지정하는 데 사용되는 옵션
- Extends
속성
| allow |
텍스트가 다른 기호와 충돌하는 경우 텍스트가 표시되는지 지정합니다.
true이면 이전에 그린 다른 기호와 충돌하더라도 텍스트가 표시됩니다.
기본값은 |
| anchor | 아이콘이 지도의 아이콘 앵커 위치에 가장 가깝게 배치되는 부분을 지정합니다. '"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다. '"left"': 아이콘의 왼쪽은 앵커에 가장 가깝게 배치됩니다. '"오른쪽"': 아이콘의 오른쪽은 앵커에 가장 가깝게 배치됩니다. '"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다. '"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다. '"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. 기본값 '"center"'. |
| color | 텍스트의 색입니다.
기본값은 |
| font | 텍스트를 표시하는 데 사용할 글꼴 스택입니다.
가능한 값: |
| halo |
바깥쪽을 향한 후광의 페이드아웃 거리(픽셀)입니다.
0보다 크거나 같은 숫자여야 합니다.
기본값은 |
| halo |
배경에서 눈에 띄는 데 도움이 되는 텍스트 후광의 색입니다.
기본값은 |
| halo |
후광에서 글꼴 윤곽선까지의 거리(픽셀)입니다.
0보다 크거나 같은 숫자여야 합니다.
최대 텍스트 후광 너비는 글꼴 크기의 1/4입니다.
기본값은 |
| ignore |
다른 기호가 텍스트와 충돌할 수 있는지를 지정합니다.
true이면 다른 기호가 텍스트와 충돌하더라도 표시될 수 있습니다.
기본값은 |
| justify | 텍스트 근거 옵션입니다. '"auto"': 텍스트가 앵커 위치에 맞춰집니다. '"left"': 텍스트가 왼쪽에 맞춰집니다. '"center"': 텍스트가 가운데에 배치됩니다. '"right"': 텍스트가 오른쪽에 맞춰집니다. 기본값 '"center"'. |
| offset | 아이콘의 앵커에서 ems의 오프셋 거리를 지정합니다.
양수 값은 오른쪽과 아래쪽을 나타내고 음수 값은 왼쪽과 위쪽을 나타냅니다.
기본값은 |
| opacity | 텍스트를 그릴 불투명도를 나타내는 0에서 1 사이의 숫자입니다.
기본값은 |
| optional | 텍스트를 다른 기호와 겹치는 경우 숨길 수 있는지를 지정합니다.
true이면 텍스트가 다른 기호와 충돌하고 아이콘이 충돌하지 않으면 해당 텍스트 없이 아이콘이 표시됩니다.
기본값은 |
| padding | 기호 충돌을 감지하는 데 사용되는 텍스트 경계 상자 주위의 추가 영역 크기입니다.
기본값은 |
| pitch |
지도가 투구될 때 텍스트의 방향을 지정합니다. '"auto"': 'rotationAlignment'의 값과 자동으로 일치합니다. '"map"': 텍스트가 지도의 평면에 맞춰집니다. '"viewport"': 텍스트가 뷰포트의 평면에 맞춰집니다. 기본값: '"auto"' |
| radial |
기호 앵커 방향으로 텍스트의 방사형 오프셋입니다. 2차원(있는 경우)을 사용하는 기본값인 2차원 |
| rotation | 텍스트를 시계 방향으로 회전할 각도입니다.
기본 |
| rotation |
속성 '"auto"': 'placement'가 '"point"'로 설정된 경우 이는 '"map"'에 해당합니다. 'placement'를 'line'으로 설정하면 '"map"'에 해당합니다. '"map"': 'placement'가 'point'로 설정된 경우 텍스트를 동서로 맞춥니다. 'placement'가 'line'으로 설정된 경우 텍스트 x축을 선에 맞춥니다. '"viewport"': 'placement' 값에 관계없이 x축이 뷰포트의 x축과 정렬되는 문자 모양을 생성합니다. 기본값: '"auto"' |
| size | 글꼴의 크기(픽셀)입니다.
0보다 크거나 같은 숫자여야 합니다.
기본값은 |
| text |
텍스트 레이블에 사용할 기능의 속성 이름을 지정합니다. |
| variable |
지도에 우선 순위가 높은 레이블을 배치할 가능성을 높이기 위한 잠재적 앵커 위치 목록입니다. 렌더러는 다음 레이블로 이동하기 전에 순서대로 각 위치에 레이블을 배치하려고 시도합니다. 앵커 위치에 따라 텍스트 근거를 선택하는 데 사용합니다 '"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다. '"left"': 아이콘의 왼쪽은 앵커에 가장 가깝게 배치됩니다. '"오른쪽"': 아이콘의 오른쪽은 앵커에 가장 가깝게 배치됩니다. '"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다. '"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다. '"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. 기본값: 'undefined' |
속성 세부 정보
allowOverlap
텍스트가 다른 기호와 충돌하는 경우 텍스트가 표시되는지 지정합니다.
true이면 이전에 그린 다른 기호와 충돌하더라도 텍스트가 표시됩니다.
기본값은 false입니다.
allowOverlap?: boolean속성 값
boolean
anchor
아이콘이 지도의 아이콘 앵커 위치에 가장 가깝게 배치되는 부분을 지정합니다.
'"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다.
'"left"': 아이콘의 왼쪽은 앵커에 가장 가깝게 배치됩니다.
'"오른쪽"': 아이콘의 오른쪽은 앵커에 가장 가깝게 배치됩니다.
'"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다.
'"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다.
'"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.
'"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.
'"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.
'"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.
기본값 '"center"'.anchor?: PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>속성 값
PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>
color
텍스트의 색입니다.
기본값은 "#000000"입니다.
color?: string | DataDrivenPropertyValueSpecification<string>속성 값
string | DataDrivenPropertyValueSpecification<string>
font
텍스트를 표시하는 데 사용할 글꼴 스택입니다.
가능한 값: "SegoeFrutigerHelveticaMYingHei-Bold", "SegoeFrutigerHelveticaMYingHei-Medium", "SegoeFrutigerHelveticaMYingHei-Regular", "SegoeUi-Bold", "SegoeUi-Light", , "SegoeUi-SemiBold""SegoeUi-Regular", "SegoeUi-SemiLight", "SegoeUi-SymbolRegular""StandardCondensedSegoeUi-Black", "StandardCondensedSegoeUi-Bold", "StandardCondensedSegoeUi-Light", "StandardCondensedSegoeUi-Regular", "StandardFont-Black", "StandardFont-Bold", "StandardFont-Light", "StandardFont-Regular""StandardFontCondensed-Black", "StandardFontCondensed-Bold", , . "StandardFontCondensed-Regular""StandardFontCondensed-Light"
기본값은 ["StandardFont-Regular"]입니다.
font?: string[] | DataDrivenPropertyValueSpecification<string[]>속성 값
string[] | DataDrivenPropertyValueSpecification<string[]>
haloBlur
바깥쪽을 향한 후광의 페이드아웃 거리(픽셀)입니다.
0보다 크거나 같은 숫자여야 합니다.
기본값은 0입니다.
haloBlur?: number | DataDrivenPropertyValueSpecification<number>속성 값
number | DataDrivenPropertyValueSpecification<number>
haloColor
배경에서 눈에 띄는 데 도움이 되는 텍스트 후광의 색입니다.
기본값은 "rgba(0,0,0,0)"입니다.
haloColor?: string | DataDrivenPropertyValueSpecification<string>속성 값
string | DataDrivenPropertyValueSpecification<string>
haloWidth
후광에서 글꼴 윤곽선까지의 거리(픽셀)입니다.
0보다 크거나 같은 숫자여야 합니다.
최대 텍스트 후광 너비는 글꼴 크기의 1/4입니다.
기본값은 0입니다.
haloWidth?: number | DataDrivenPropertyValueSpecification<number>속성 값
number | DataDrivenPropertyValueSpecification<number>
ignorePlacement
다른 기호가 텍스트와 충돌할 수 있는지를 지정합니다.
true이면 다른 기호가 텍스트와 충돌하더라도 표시될 수 있습니다.
기본값은 false입니다.
ignorePlacement?: boolean속성 값
boolean
justify
텍스트 근거 옵션입니다.
'"auto"': 텍스트가 앵커 위치에 맞춰집니다.
'"left"': 텍스트가 왼쪽에 맞춰집니다.
'"center"': 텍스트가 가운데에 배치됩니다.
'"right"': 텍스트가 오른쪽에 맞춰집니다. 기본값 '"center"'.
justify?: "auto" | "left" | "center" | "right"속성 값
"auto" | "left" | "center" | "right"
offset
아이콘의 앵커에서 ems의 오프셋 거리를 지정합니다.
양수 값은 오른쪽과 아래쪽을 나타내고 음수 값은 왼쪽과 위쪽을 나타냅니다.
기본값은 [0, 0]입니다.
offset?: Pixel | DataDrivenPropertyValueSpecification<Pixel>속성 값
opacity
텍스트를 그릴 불투명도를 나타내는 0에서 1 사이의 숫자입니다.
기본값은 1입니다.
opacity?: number | DataDrivenPropertyValueSpecification<number>속성 값
number | DataDrivenPropertyValueSpecification<number>
optional
텍스트를 다른 기호와 겹치는 경우 숨길 수 있는지를 지정합니다.
true이면 텍스트가 다른 기호와 충돌하고 아이콘이 충돌하지 않으면 해당 텍스트 없이 아이콘이 표시됩니다.
기본값은 false입니다.
optional?: boolean속성 값
boolean
padding
기호 충돌을 감지하는 데 사용되는 텍스트 경계 상자 주위의 추가 영역 크기입니다.
기본값은 2입니다.
padding?: number | PropertyValueSpecification<number>속성 값
number | PropertyValueSpecification<number>
pitchAlignment
지도가 투구될 때 텍스트의 방향을 지정합니다.
'"auto"': 'rotationAlignment'의 값과 자동으로 일치합니다.
'"map"': 텍스트가 지도의 평면에 맞춰집니다.
'"viewport"': 텍스트가 뷰포트의 평면에 맞춰집니다.
기본값: '"auto"'pitchAlignment?: "auto" | "map" | "viewport"속성 값
"auto" | "map" | "viewport"
radialOffset
기호 앵커 방향으로 텍스트의 방사형 오프셋입니다. 2차원(있는 경우)을 사용하는 기본값인 2차원 offset 과 variableAnchor함께 사용할 수 있습니다.
기본값: 0
radialOffset?: number | DataDrivenPropertyValueSpecification<number>속성 값
number | DataDrivenPropertyValueSpecification<number>
rotation
텍스트를 시계 방향으로 회전할 각도입니다.
기본 0
rotation?: number | DataDrivenPropertyValueSpecification<number>속성 값
number | DataDrivenPropertyValueSpecification<number>
rotationAlignment
속성SymbolLayerOptions과 함께 placement 텍스트를 형성하는 개별 문자 모양의 회전 동작을 지정합니다.
'"auto"': 'placement'가 '"point"'로 설정된 경우 이는 '"map"'에 해당합니다. 'placement'를 'line'으로 설정하면 '"map"'에 해당합니다.
'"map"': 'placement'가 'point'로 설정된 경우 텍스트를 동서로 맞춥니다. 'placement'가 'line'으로 설정된 경우 텍스트 x축을 선에 맞춥니다.
'"viewport"': 'placement' 값에 관계없이 x축이 뷰포트의 x축과 정렬되는 문자 모양을 생성합니다.
기본값: '"auto"'rotationAlignment?: "auto" | "map" | "viewport"속성 값
"auto" | "map" | "viewport"
size
글꼴의 크기(픽셀)입니다.
0보다 크거나 같은 숫자여야 합니다.
기본값은 16입니다.
size?: number | DataDrivenPropertyValueSpecification<number>속성 값
number | DataDrivenPropertyValueSpecification<number>
textField
텍스트 레이블에 사용할 기능의 속성 이름을 지정합니다.
textField?: string | DataDrivenPropertyValueSpecification<string>속성 값
string | DataDrivenPropertyValueSpecification<string>
variableAnchor
지도에 우선 순위가 높은 레이블을 배치할 가능성을 높이기 위한 잠재적 앵커 위치 목록입니다. 렌더러는 다음 레이블로 이동하기 전에 순서대로 각 위치에 레이블을 배치하려고 시도합니다. 앵커 위치에 따라 텍스트 근거를 선택하는 데 사용합니다 justify: "auto" . 오프셋을 적용하려면 2차원 offset 옵션을 사용합니다radialOffset.
'"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다.
'"left"': 아이콘의 왼쪽은 앵커에 가장 가깝게 배치됩니다.
'"오른쪽"': 아이콘의 오른쪽은 앵커에 가장 가깝게 배치됩니다.
'"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다.
'"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다.
'"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.
'"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.
'"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.
'"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.
기본값: 'undefined'variableAnchor?: PositionAnchor[]