Daylight

ESM:
Use dark colors for code blocksCopy
1
import "@arcgis/map-components/components/arcgis-daylight";
CDN:
No specific import is needed for this component.

The Daylight component can be used to manipulate the lighting conditions of a Scene.

Known limitations

Daylight is only supported in a 3D Scene component.

See also

Demo

Properties

PropertyAttributeType
auto-destroy-disabled
boolean
current-season
"fall" | "spring" | "summer" | "winter"
date-or-season
"date" | "season"
day-playing
boolean
heading-level
number
hide-date-picker
boolean
hide-header
boolean
hide-play-buttons
boolean
hide-shadows-toggle
boolean
hide-sun-lighting-toggle
boolean
hide-timezone
boolean
icon
string
label
string
play-speed-multiplier
number
position
"bottom-leading" | "bottom-left" | "bottom-right" | "bottom-trailing" | "manual" | "top-leading" | "top-left" | "top-right" | "top-trailing"
reference-element
time-slider-steps
Array<number> | number
year-playing
boolean

autoDestroyDisabled

Property
autoDestroyDisabled: boolean

If true, the component will not be destroyed automatically when it is disconnected from the document. This is useful when you want to move the component to a different place on the page, or temporarily hide it. If this is set, make sure to call the destroy method when you are done to prevent memory leaks.

Attribute
auto-destroy-disabled
Default value
false

currentSeason

Property
currentSeason: "fall" | "spring" | "summer" | "winter"

A season can be set instead of a date.

Read more...

Attribute
current-season

dateOrSeason

Property
dateOrSeason: "date" | "season"

Controls whether the component displays a date or a season picker.

Read more

Attribute
date-or-season
Default value
"date"

dayPlaying

Property
dayPlaying: boolean

Starts or pauses the daytime animation cycling through the minutes of the day.

Read more...

Attribute
day-playing
Default value
false

headingLevel

Property
headingLevel: number

Indicates the heading level to use for the component title.

Attribute
heading-level
Default value
3

hideDatePicker

Property
hideDatePicker: boolean
Attribute
hide-date-picker
Default value
false

hideHeader

Property
hideHeader: boolean
Attribute
hide-header
Default value
false

hidePlayButtons

Property
hidePlayButtons: boolean
Attribute
hide-play-buttons
Default value
false

hideShadowsToggle

Property
hideShadowsToggle: boolean
Attribute
hide-shadows-toggle
Default value
false

hideSunLightingToggle

Property
hideSunLightingToggle: boolean
Attribute
hide-sun-lighting-toggle
Default value
false

hideTimezone

Property
hideTimezone: boolean
Attribute
hide-timezone
Default value
false

icon

Property
icon: string

Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).

See also: Calcite Icons

Attribute
icon
Default value
"brightness"

label

Property
label: string

The component's default label.

Attribute
label

playSpeedMultiplier

Property
playSpeedMultiplier: number

Controls the speed of the daytime and date animation.

Attribute
play-speed-multiplier
Default value
1.0

position

Property
position: "bottom-leading" | "bottom-left" | "bottom-right" | "bottom-trailing" | "manual" | "top-leading" | "top-left" | "top-right" | "top-trailing"
Attribute
position
Default value
"bottom-left"

referenceElement

Property

By assigning the id attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.

See also
Attribute
reference-element

timeSliderSteps

Property
timeSliderSteps: Array<number> | number

Sets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb.

Read more

Attribute
time-slider-steps
Default value
5

yearPlaying

Property
yearPlaying: boolean

Starts or pauses the date animation cycling through the months of the year.

Read more...

Attribute
year-playing
Default value
false

Slots

No slots to display.

Events

arcgisReady

Event
arcgisReady: CustomEvent<void>

Emitted when the component associated with a map or scene view is is ready to be interacted with.

bubbles

Events triggered on this element will be propagated to their outermost elements.

composed

The event is composable and will propagate across the shadow DOM into the standard DOM.

cancelable

The event's default behavior can be canceled, allowing for custom behavior to be implemented instead.

arcgisUserDateTimeChange

Event
arcgisUserDateTimeChange: CustomEvent<void>

Fires when the user changes the date or time in the component by interacting with the slider, the date picker, the season selector or the play buttons.

bubbles

Events triggered on this element will be propagated to their outermost elements.

composed

The event is composable and will propagate across the shadow DOM into the standard DOM.

cancelable

The event's default behavior can be canceled, allowing for custom behavior to be implemented instead.

Methods

MethodSignature
componentOnReady(): Promise<void>
destroy(): Promise<void>

componentOnReady

Method
componentOnReady(): Promise<void>

Create a promise that resolves once component is fully loaded.

Example
Use dark colors for code blocksCopy
1
2
3
4
const arcgisDaylight = document.querySelector("arcgis-daylight");
document.body.append(arcgisDaylight);
await arcgisDaylight.componentOnReady();
console.log("arcgis-daylight is ready to go!");
Returns
Promise<void>

destroy

Method
destroy(): Promise<void>

Permanently destroy the component.

Returns
Promise<void>

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.