@aurodesignsystem-dev/auro-flightline 0.0.0-pr140.0 → 0.0.0-pr141.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/demo/api.md CHANGED
@@ -3,384 +3,384 @@
3
3
 
4
4
  # auro-flight-segment
5
5
 
6
- The auro-flight-segment component is a standard for indicating stopovers and layovers.
7
- Stopovers do not have duration information and are indicated differently.
8
- Layovers contain duration information and are indicated with a solid fill.
9
- For more information about the difference between a layover and a stopover,
10
- [please see this article.](https://www.turkishairlines.com/en-int/any-questions/what-is-the-difference-between-a-layover-and-a-stopover/).
11
-
12
- ## Properties
13
-
14
- | Property | Attribute | Type | Default | Description |
15
- |-----------------------|-----------------------|-----------|---------|--------------------------------------------------|
16
- | [canceled](#canceled) | `canceled` | `Boolean` | false | Whether the segment is canceled. The line leading to the segment will be red. |
17
- | [destinationCanceled](#destinationCanceled) | `destinationCanceled` | `Boolean` | false | Whether the following segment is canceled, will only affect the last segment in a flightline. The line after the segment will be red. |
18
- | [duration](#duration) | `duration` | `String` | | Indicates time duration of a stop |
19
- | [iata](#iata) | `iata` | `String` | | Text to display, typically a station code (SEA, PVD, AVP) |
20
- | [nextDay](#nextDay) | `nextDay` | `Boolean` | | Indicates time is on the following calendar day. |
21
- | [stopover](#stopover) | `stopover` | `Boolean` | false | Indicates a stopover. Do not provide duration. |
6
+ Marks one stop on a flight as a layover or a stopover.
7
+
8
+ **Key capabilities**
9
+ - **Layover**: A stop with a duration, shown as a filled marker. Set `duration` to show how long it lasts.
10
+ - **Stopover**: A stop with no duration, shown as an outlined marker. Set `stopover` to turn it on.
11
+ - **Cancellation**: `canceled` and `destinationCanceled` show the lines around the segment as canceled.
12
+
13
+ **Example**
14
+ <pre class="language-html"><code class="language-html">&lt;auro-flight-segment iata="ORD" duration="3h 40m"&gt;&lt;/auro-flight-segment&gt;</code></pre>
15
+ Read about [the difference between a layover and a stopover](https://www.turkishairlines.com/en-int/any-questions/what-is-the-difference-between-a-layover-and-a-stopover/).
22
16
 
17
+ ### Properties and attributes
18
+
19
+ | Properties | Attributes | Modifiers | Type | Default | Description |
20
+ | ------------------- | ------------------- | --------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
21
+ | canceled | canceled | | boolean | | Marks the segment as canceled. The line leading to the segment is red and dashed, and the segment's marker is red. |
22
+ | destinationCanceled | destinationCanceled | | boolean | | Marks the final leg after the last segment as canceled. Use it on the last segment in a flightline, where it turns the line after the segment red and dashed and the duration text red. |
23
+ | duration | duration | | string | | Sets the layover length shown under the station code, such as `3h 40m`. Don't set it on a stopover, because stopover durations can't be predicted. |
24
+ | iata | iata | | string | | Sets the text shown under the segment's marker, typically a station code such as `SEA`. |
25
+ | nextDay | nextDay | | boolean | | Marks a layover that extends into the next calendar day by showing its duration in red. |
26
+ | stopover | stopover | | boolean | | Marks the segment as a stopover and shows its marker as an outlined circle. Don't set `duration` on a stopover, because stopover durations can't be predicted. |
27
+
28
+ ### Methods
29
+
30
+ | Name | Parameters | Return | Description |
31
+ | -------- | ------------------------------------------------------------- | ------ | -------------------------------------------------------- |
32
+ | register | `name` (string) - The tag name to register the element under. | | Registers the element with the browser under a tag name. |
33
+
23
34
  # auro-flightline
24
35
 
25
- The auro-flightline component provides a responsive flight timeline experience by placing dots indicating stopovers and layovers on a timeline.
36
+ Shows a flight's layovers and stopovers as dots on a timeline that adapts to its width.
37
+
38
+ **Key capabilities**
39
+ - **Shows each stop**: Each `<auro-flight-segment>` in the default slot adds a dot to the timeline.
40
+ - **Adapts to narrow spaces**: When it has two or more segments and is `320px` wide or narrower, it shows the number of stops instead of the dots.
41
+ - **Shows cancellations**: `canceled` shows the whole flight as canceled.
42
+
43
+ **Example**
44
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;
45
+ &lt;auro-flight-segment iata="SEA" duration="1h 40m"&gt;&lt;/auro-flight-segment&gt;
46
+ &lt;/auro-flightline&gt;</code></pre>
26
47
 
27
- ## Properties
48
+ ### Properties and attributes
49
+
50
+ | Properties | Attributes | Modifiers | Type | Default | Description |
51
+ | ---------- | ---------- | --------- | ------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
52
+ | canceled | canceled | | boolean | | Sets the whole flightline to canceled. The line turns red and dashed, and every segment inside it is shown as canceled. |
28
53
 
29
- | Property | Attribute | Type | Default | Description |
30
- |------------|------------|-----------|---------|-------------------------------------|
31
- | [canceled](#canceled) | `canceled` | `Boolean` | false | Whether the flightline is canceled. |
54
+ ### Methods
32
55
 
33
- ## Slots
56
+ | Name | Parameters | Return | Description |
57
+ | -------- | ------------------------------------------------------------- | ------ | -------------------------------------------------------- |
58
+ | register | `name` (string) - The tag name to register the element under. | | Registers the element with the browser under a tag name. |
34
59
 
35
- | Name | Description |
36
- |------|--------------------------------------------------|
37
- | | fill in with `<auro-flight-segment>` components of a given leg. |
60
+ ### Slots
61
+
62
+ | Name | Description |
63
+ | --------- | -------------------------------------------------------------------------------- |
64
+ | (default) | The `<auro-flight-segment>` elements that make up the flight, one for each stop. |
38
65
  <!-- AURO-GENERATED-CONTENT:END -->
39
66
 
40
67
  ## Basic
41
68
 
42
69
  <div class="exampleWrapper">
43
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
44
- <!-- The below content is automatically added from ./../apiExamples/basic.html -->
45
- <auro-flightline></auro-flightline>
46
- <!-- AURO-GENERATED-CONTENT:END -->
70
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
71
+ <!-- The below content is automatically added from ./../apiExamples/basic.html -->
72
+ <auro-flightline></auro-flightline>
73
+ <!-- AURO-GENERATED-CONTENT:END -->
47
74
  </div>
48
75
  <auro-accordion alignRight>
49
- <span slot="trigger">See code</span>
76
+ <span slot="trigger">See code</span>
50
77
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic.html) -->
51
78
  <!-- The below code snippet is automatically added from ./../apiExamples/basic.html -->
52
79
 
53
- ```html
54
- <auro-flightline></auro-flightline>
55
- ```
80
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;&lt;/auro-flightline&gt;</code></pre>
56
81
  <!-- AURO-GENERATED-CONTENT:END -->
57
82
  </auro-accordion>
58
83
 
59
- ## Property & Attribute Examples
84
+ ## Property and attribute examples
60
85
 
61
86
  ### Canceled
62
87
 
63
- #### Canceled Flight
88
+ #### Canceled flight
64
89
 
65
- The following illustrates a `canceled` flight with no layovers or stopovers, for example, SEA to EWR is canceled.
90
+ Use `canceled` on a flightline with no segments to show a canceled nonstop flight, such as SEA to EWR.
66
91
 
67
92
  <div class="exampleWrapper">
68
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/canceled.html) -->
69
- <!-- The below content is automatically added from ../apiExamples/canceled.html -->
70
- <auro-flightline canceled></auro-flightline>
71
- <!-- AURO-GENERATED-CONTENT:END -->
93
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/canceled.html) -->
94
+ <!-- The below content is automatically added from ../apiExamples/canceled.html -->
95
+ <auro-flightline canceled></auro-flightline>
96
+ <!-- AURO-GENERATED-CONTENT:END -->
72
97
  </div>
73
98
  <auro-accordion alignRight>
74
- <span slot="trigger">See code</span>
99
+ <span slot="trigger">See code</span>
75
100
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/canceled.html) -->
76
101
  <!-- The below code snippet is automatically added from ../apiExamples/canceled.html -->
77
102
 
78
- ```html
79
- <auro-flightline canceled></auro-flightline>
80
- ```
103
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline canceled&gt;&lt;/auro-flightline&gt;</code></pre>
81
104
  <!-- AURO-GENERATED-CONTENT:END -->
82
105
  </auro-accordion>
83
106
 
84
- #### Canceled Segment
107
+ #### Canceled segment
85
108
 
86
- If the `canceled` flightline has segments, they will all be shown as canceled. To cancel individual segments, see complex examples below.
109
+ When the `canceled` flightline has segments, it shows all of them as canceled. To cancel only some segments, set `canceled` on those segments, as in the canceled flight with multiple stopovers and layovers example.
87
110
 
88
111
  <div class="exampleWrapper">
89
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/canceled-segment.html) -->
90
- <!-- The below content is automatically added from ../apiExamples/canceled-segment.html -->
91
- <auro-flightline>
92
- <auro-flight-segment iata="EWR" duration="3h 40m" canceled></auro-flight-segment>
93
- </auro-flightline>
94
- <!-- AURO-GENERATED-CONTENT:END -->
112
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/canceled-segment.html) -->
113
+ <!-- The below content is automatically added from ../apiExamples/canceled-segment.html -->
114
+ <auro-flightline canceled>
115
+ <auro-flight-segment iata="EWR" duration="3h 40m"></auro-flight-segment>
116
+ </auro-flightline>
117
+ <!-- AURO-GENERATED-CONTENT:END -->
95
118
  </div>
96
119
  <auro-accordion alignRight>
97
- <span slot="trigger">See code</span>
120
+ <span slot="trigger">See code</span>
98
121
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/canceled-segment.html) -->
99
122
  <!-- The below code snippet is automatically added from ../apiExamples/canceled-segment.html -->
100
123
 
101
- ```html
102
- <auro-flightline>
103
- <auro-flight-segment iata="EWR" duration="3h 40m" canceled></auro-flight-segment>
104
- </auro-flightline>
105
- ```
124
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline canceled&gt;
125
+ &lt;auro-flight-segment iata="EWR" duration="3h 40m"&gt;&lt;/auro-flight-segment&gt;
126
+ &lt;/auro-flightline&gt;</code></pre>
106
127
  <!-- AURO-GENERATED-CONTENT:END -->
107
128
  </auro-accordion>
108
129
 
109
- #### Canceled Destination
130
+ #### Canceled destination
110
131
 
111
- The following illustrates the use of the `destinationCanceled` attribute, which demonstrates a canceled final destination segment.
132
+ Use `destinationCanceled` on the last segment to show a canceled final leg.
112
133
 
113
134
  <div class="exampleWrapper">
114
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/canceled-destination.html) -->
115
- <!-- The below content is automatically added from ../apiExamples/canceled-destination.html -->
116
- <auro-flightline>
117
- <auro-flight-segment iata="EWR" duration="3h 40m" destinationCanceled></auro-flight-segment>
118
- </auro-flightline>
119
- <!-- AURO-GENERATED-CONTENT:END -->
135
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/canceled-destination.html) -->
136
+ <!-- The below content is automatically added from ../apiExamples/canceled-destination.html -->
137
+ <auro-flightline>
138
+ <auro-flight-segment iata="EWR" duration="3h 40m" destinationCanceled></auro-flight-segment>
139
+ </auro-flightline>
140
+ <!-- AURO-GENERATED-CONTENT:END -->
120
141
  </div>
121
142
  <auro-accordion alignRight>
122
- <span slot="trigger">See code</span>
143
+ <span slot="trigger">See code</span>
123
144
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/canceled-destination.html) -->
124
145
  <!-- The below code snippet is automatically added from ../apiExamples/canceled-destination.html -->
125
146
 
126
- ```html
127
- <auro-flightline>
128
- <auro-flight-segment iata="EWR" duration="3h 40m" destinationCanceled></auro-flight-segment>
129
- </auro-flightline>
130
- ```
147
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;
148
+ &lt;auro-flight-segment iata="EWR" duration="3h 40m" destinationCanceled&gt;&lt;/auro-flight-segment&gt;
149
+ &lt;/auro-flightline&gt;</code></pre>
131
150
  <!-- AURO-GENERATED-CONTENT:END -->
132
151
  </auro-accordion>
133
152
 
134
153
  ### Layover
135
154
 
136
- This example illustrates the use of the `duration` and `iata` attributes to display station codes with the layover duration.
155
+ Use `iata` and `duration` to show a station code with the layover duration.
137
156
 
138
157
  <div class="exampleWrapper">
139
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/iata.html) -->
140
- <!-- The below content is automatically added from ../apiExamples/iata.html -->
141
- <auro-flightline>
142
- <auro-flight-segment iata="ORD" duration="3h 40m"></auro-flight-segment>
143
- </auro-flightline>
144
- <!-- AURO-GENERATED-CONTENT:END -->
158
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/iata.html) -->
159
+ <!-- The below content is automatically added from ../apiExamples/iata.html -->
160
+ <auro-flightline>
161
+ <auro-flight-segment iata="ORD" duration="3h 40m"></auro-flight-segment>
162
+ </auro-flightline>
163
+ <!-- AURO-GENERATED-CONTENT:END -->
145
164
  </div>
146
165
  <auro-accordion alignRight>
147
- <span slot="trigger">See code</span>
166
+ <span slot="trigger">See code</span>
148
167
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/iata.html) -->
149
168
  <!-- The below code snippet is automatically added from ../apiExamples/iata.html -->
150
169
 
151
- ```html
152
- <auro-flightline>
153
- <auro-flight-segment iata="ORD" duration="3h 40m"></auro-flight-segment>
154
- </auro-flightline>
155
- ```
170
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;
171
+ &lt;auro-flight-segment iata="ORD" duration="3h 40m"&gt;&lt;/auro-flight-segment&gt;
172
+ &lt;/auro-flightline&gt;</code></pre>
156
173
  <!-- AURO-GENERATED-CONTENT:END -->
157
174
  </auro-accordion>
158
175
 
159
- #### Next Day Layover
176
+ #### Next day layover
160
177
 
161
- The following illustrates the use of the `nextDay` attribute to indicate a layover that extends into the next day.
178
+ Use `nextDay` to show a layover that extends into the next day.
162
179
 
163
180
  <div class="exampleWrapper">
164
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/next-day.html) -->
165
- <!-- The below content is automatically added from ../apiExamples/next-day.html -->
166
- <auro-flightline>
167
- <auro-flight-segment nextDay iata="ORD" duration="3h 40m"></auro-flight-segment>
168
- </auro-flightline>
169
- <!-- AURO-GENERATED-CONTENT:END -->
181
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/next-day.html) -->
182
+ <!-- The below content is automatically added from ../apiExamples/next-day.html -->
183
+ <auro-flightline>
184
+ <auro-flight-segment nextDay iata="ORD" duration="3h 40m"></auro-flight-segment>
185
+ </auro-flightline>
186
+ <!-- AURO-GENERATED-CONTENT:END -->
170
187
  </div>
171
188
  <auro-accordion alignRight>
172
- <span slot="trigger">See code</span>
189
+ <span slot="trigger">See code</span>
173
190
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/next-day.html) -->
174
191
  <!-- The below code snippet is automatically added from ../apiExamples/next-day.html -->
175
192
 
176
- ```html
177
- <auro-flightline>
178
- <auro-flight-segment nextDay iata="ORD" duration="3h 40m"></auro-flight-segment>
179
- </auro-flightline>
180
- ```
193
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;
194
+ &lt;auro-flight-segment nextDay iata="ORD" duration="3h 40m"&gt;&lt;/auro-flight-segment&gt;
195
+ &lt;/auro-flightline&gt;</code></pre>
181
196
  <!-- AURO-GENERATED-CONTENT:END -->
182
197
  </auro-accordion>
183
198
 
184
199
  ### Stopover
185
200
 
186
- The following illustrates a flight with one `stopover`.
201
+ Use `stopover` to show a stop with no duration.
187
202
 
188
203
  <div class="exampleWrapper">
189
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/stopover.html) -->
190
- <!-- The below content is automatically added from ../apiExamples/stopover.html -->
191
- <auro-flightline>
192
- <auro-flight-segment stopover iata="CDB"></auro-flight-segment>
193
- </auro-flightline>
194
- <!-- AURO-GENERATED-CONTENT:END -->
204
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/stopover.html) -->
205
+ <!-- The below content is automatically added from ../apiExamples/stopover.html -->
206
+ <auro-flightline>
207
+ <auro-flight-segment stopover iata="CDB"></auro-flight-segment>
208
+ </auro-flightline>
209
+ <!-- AURO-GENERATED-CONTENT:END -->
195
210
  </div>
196
211
  <auro-accordion alignRight>
197
- <span slot="trigger">See code</span>
212
+ <span slot="trigger">See code</span>
198
213
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/stopover.html) -->
199
214
  <!-- The below code snippet is automatically added from ../apiExamples/stopover.html -->
200
215
 
201
- ```html
202
- <auro-flightline>
203
- <auro-flight-segment stopover iata="CDB"></auro-flight-segment>
204
- </auro-flightline>
205
- ```
216
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;
217
+ &lt;auro-flight-segment stopover iata="CDB"&gt;&lt;/auro-flight-segment&gt;
218
+ &lt;/auro-flightline&gt;</code></pre>
206
219
  <!-- AURO-GENERATED-CONTENT:END -->
207
220
  </auro-accordion>
208
221
 
209
- ## Common Usage Patterns & Functional Examples
222
+ ## Common usage patterns
210
223
 
211
- ### Container Query
212
-
213
- The `auro-flightline` element is reactive to its parent container's `width` value versus a `@media` query based on the device `width`. This allows for greater control over the shape of the element when in constrained spaces.
224
+ ### Container query
214
225
 
215
- The default container query is a min-width of `320px`, or `var(--ds-grid-breakpoint-xs)`.
226
+ The `auro-flightline` element responds to its own width instead of the device width, so you can control its shape in narrow spaces. When a flightline with two or more segments is `320px` wide or narrower (the `xs` grid breakpoint), it shows the number of stops instead of the individual segments.
216
227
 
217
- The first example illustrates a `auro-flightline` element with a container width of `300px`. The next `auro-flightline` element is within a container set at `100%` for context. Notice when the container reaches a width of < `320px`, the container query switches the UI.
228
+ The first example sets the width to `300px`, the second uses the full width of its container, and the third sets `75%` so you can resize the window and watch it switch.
218
229
 
219
230
  <div class="exampleWrapper">
220
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/container-query.html) -->
221
- <!-- The below content is automatically added from ../apiExamples/container-query.html -->
222
- <auro-flightline style="width: 300px">
223
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
224
- <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
225
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
226
- <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
227
- <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
228
- </auro-flightline>
229
- <auro-flightline>
230
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
231
- <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
232
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
233
- <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
234
- <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
235
- </auro-flightline>
236
- <auro-flightline style="width: 75%">
237
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
238
- <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
239
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
240
- <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
241
- <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
242
- </auro-flightline>
243
- <!-- AURO-GENERATED-CONTENT:END -->
244
- </div>
245
- <auro-accordion alignRight>
246
- <span slot="trigger">See code</span>
247
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/container-query.html) -->
248
- <!-- The below code snippet is automatically added from ../apiExamples/container-query.html -->
249
-
250
- ```html
231
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/container-query.html) -->
232
+ <!-- The below content is automatically added from ../apiExamples/container-query.html -->
251
233
  <auro-flightline style="width: 300px">
252
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
253
- <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
254
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
255
- <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
256
- <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
234
+ <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
235
+ <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
236
+ <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
237
+ <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
238
+ <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
257
239
  </auro-flightline>
258
240
  <auro-flightline>
259
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
260
- <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
261
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
262
- <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
263
- <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
241
+ <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
242
+ <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
243
+ <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
244
+ <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
245
+ <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
264
246
  </auro-flightline>
265
247
  <auro-flightline style="width: 75%">
266
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
267
- <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
268
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
269
- <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
270
- <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
271
- </auro-flightline>
272
- ```
248
+ <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
249
+ <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
250
+ <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
251
+ <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
252
+ <auro-flight-segment iata="DUB" duration="13h 40m"></auro-flight-segment>
253
+ </auro-flightline>
254
+ <!-- AURO-GENERATED-CONTENT:END -->
255
+ </div>
256
+ <auro-accordion alignRight>
257
+ <span slot="trigger">See code</span>
258
+ <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/container-query.html) -->
259
+ <!-- The below code snippet is automatically added from ../apiExamples/container-query.html -->
260
+
261
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline style="width: 300px"&gt;
262
+ &lt;auro-flight-segment stopover iata="YAK"&gt;&lt;/auro-flight-segment&gt;
263
+ &lt;auro-flight-segment stopover iata="WRG"&gt;&lt;/auro-flight-segment&gt;
264
+ &lt;auro-flight-segment iata="SEA" duration="0h 40m"&gt;&lt;/auro-flight-segment&gt;
265
+ &lt;auro-flight-segment iata="BOS" duration="1h 40m"&gt;&lt;/auro-flight-segment&gt;
266
+ &lt;auro-flight-segment iata="DUB" duration="13h 40m"&gt;&lt;/auro-flight-segment&gt;
267
+ &lt;/auro-flightline&gt;
268
+ &#10;&lt;auro-flightline&gt;
269
+ &lt;auro-flight-segment stopover iata="YAK"&gt;&lt;/auro-flight-segment&gt;
270
+ &lt;auro-flight-segment stopover iata="WRG"&gt;&lt;/auro-flight-segment&gt;
271
+ &lt;auro-flight-segment iata="SEA" duration="0h 40m"&gt;&lt;/auro-flight-segment&gt;
272
+ &lt;auro-flight-segment iata="BOS" duration="1h 40m"&gt;&lt;/auro-flight-segment&gt;
273
+ &lt;auro-flight-segment iata="DUB" duration="13h 40m"&gt;&lt;/auro-flight-segment&gt;
274
+ &lt;/auro-flightline&gt;
275
+ &#10;&lt;auro-flightline style="width: 75%"&gt;
276
+ &lt;auro-flight-segment stopover iata="YAK"&gt;&lt;/auro-flight-segment&gt;
277
+ &lt;auro-flight-segment stopover iata="WRG"&gt;&lt;/auro-flight-segment&gt;
278
+ &lt;auro-flight-segment iata="SEA" duration="0h 40m"&gt;&lt;/auro-flight-segment&gt;
279
+ &lt;auro-flight-segment iata="BOS" duration="1h 40m"&gt;&lt;/auro-flight-segment&gt;
280
+ &lt;auro-flight-segment iata="DUB" duration="13h 40m"&gt;&lt;/auro-flight-segment&gt;
281
+ &lt;/auro-flightline&gt;</code></pre>
273
282
  <!-- AURO-GENERATED-CONTENT:END -->
274
283
  </auro-accordion>
275
284
 
276
- ### Stopover and Layover
285
+ ### Stopover and layover
277
286
 
278
- The following illustrates a flight with a stopover and a layover.
287
+ Mix stopover and layover segments in one flightline, as in this flight with one of each.
279
288
 
280
289
  <div class="exampleWrapper">
281
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/stopover-and-layover.html) -->
282
- <!-- The below content is automatically added from ../apiExamples/stopover-and-layover.html -->
283
- <auro-flightline>
284
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
285
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
286
- </auro-flightline>
287
- <!-- AURO-GENERATED-CONTENT:END -->
290
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/stopover-and-layover.html) -->
291
+ <!-- The below content is automatically added from ../apiExamples/stopover-and-layover.html -->
292
+ <auro-flightline>
293
+ <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
294
+ <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
295
+ </auro-flightline>
296
+ <!-- AURO-GENERATED-CONTENT:END -->
288
297
  </div>
289
298
  <auro-accordion alignRight>
290
- <span slot="trigger">See code</span>
299
+ <span slot="trigger">See code</span>
291
300
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/stopover-and-layover.html) -->
292
301
  <!-- The below code snippet is automatically added from ../apiExamples/stopover-and-layover.html -->
293
302
 
294
- ```html
295
- <auro-flightline>
296
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
297
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
298
- </auro-flightline>
299
- ```
303
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;
304
+ &lt;auro-flight-segment stopover iata="YAK"&gt;&lt;/auro-flight-segment&gt;
305
+ &lt;auro-flight-segment iata="SEA" duration="0h 40m"&gt;&lt;/auro-flight-segment&gt;
306
+ &lt;/auro-flightline&gt;</code></pre>
300
307
  <!-- AURO-GENERATED-CONTENT:END -->
301
308
  </auro-accordion>
302
309
 
303
- ### Flight with Multiple Stopovers and Layovers
310
+ ### Flight with multiple stopovers and layovers
304
311
 
305
- The following illustrates an international flight with stopovers and layovers.
312
+ Add as many stopover and layover segments as the route needs, as in this flight with one stopover and three layovers.
306
313
 
307
314
  <div class="exampleWrapper">
308
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/multiple-stop-and-layovers.html) -->
309
- <!-- The below content is automatically added from ../apiExamples/multiple-stop-and-layovers.html -->
310
- <auro-flightline>
311
- <auro-flight-segment stopover iata="CDB"></auro-flight-segment>
312
- <auro-flight-segment iata="ANC" duration="1h 30m"></auro-flight-segment>
313
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
314
- <auro-flight-segment iata="SFO" duration="1h 40m"></auro-flight-segment>
315
- </auro-flightline>
316
- <!-- AURO-GENERATED-CONTENT:END -->
315
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/multiple-stop-and-layovers.html) -->
316
+ <!-- The below content is automatically added from ../apiExamples/multiple-stop-and-layovers.html -->
317
+ <auro-flightline>
318
+ <auro-flight-segment stopover iata="CDB"></auro-flight-segment>
319
+ <auro-flight-segment iata="ANC" duration="1h 30m"></auro-flight-segment>
320
+ <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
321
+ <auro-flight-segment iata="SFO" duration="1h 40m"></auro-flight-segment>
322
+ </auro-flightline>
323
+ <!-- AURO-GENERATED-CONTENT:END -->
317
324
  </div>
318
325
  <auro-accordion alignRight>
319
- <span slot="trigger">See code</span>
326
+ <span slot="trigger">See code</span>
320
327
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/multiple-stop-and-layovers.html) -->
321
328
  <!-- The below code snippet is automatically added from ../apiExamples/multiple-stop-and-layovers.html -->
322
329
 
323
- ```html
324
- <auro-flightline>
325
- <auro-flight-segment stopover iata="CDB"></auro-flight-segment>
326
- <auro-flight-segment iata="ANC" duration="1h 30m"></auro-flight-segment>
327
- <auro-flight-segment iata="SEA" duration="0h 40m"></auro-flight-segment>
328
- <auro-flight-segment iata="SFO" duration="1h 40m"></auro-flight-segment>
329
- </auro-flightline>
330
- ```
330
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;
331
+ &lt;auro-flight-segment stopover iata="CDB"&gt;&lt;/auro-flight-segment&gt;
332
+ &lt;auro-flight-segment iata="ANC" duration="1h 30m"&gt;&lt;/auro-flight-segment&gt;
333
+ &lt;auro-flight-segment iata="SEA" duration="0h 40m"&gt;&lt;/auro-flight-segment&gt;
334
+ &lt;auro-flight-segment iata="SFO" duration="1h 40m"&gt;&lt;/auro-flight-segment&gt;
335
+ &lt;/auro-flightline&gt;</code></pre>
331
336
  <!-- AURO-GENERATED-CONTENT:END -->
332
337
  </auro-accordion>
333
338
 
334
- ### Canceled Flight with Multiple Stopovers and Layovers
339
+ ### Canceled flight with multiple stopovers and layovers
335
340
 
336
- The following illustrates a cancellation of international flight with stopovers and layovers.
341
+ Set `canceled` on individual segments, and `destinationCanceled` on the last one, to show a canceled international flight with stopovers and layovers.
337
342
 
338
343
  <div class="exampleWrapper">
339
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/canceled-stop-and-layovers.html) -->
340
- <!-- The below content is automatically added from ../apiExamples/canceled-stop-and-layovers.html -->
341
- <auro-flightline>
342
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
343
- <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
344
- <auro-flight-segment canceled iata="SEA" duration="0h 40m"></auro-flight-segment>
345
- <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
346
- <auro-flight-segment canceled destinationCanceled iata="DUB" duration="13h 40m"></auro-flight-segment>
347
- </auro-flightline>
348
- <!-- AURO-GENERATED-CONTENT:END -->
344
+ <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/canceled-stop-and-layovers.html) -->
345
+ <!-- The below content is automatically added from ../apiExamples/canceled-stop-and-layovers.html -->
346
+ <auro-flightline>
347
+ <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
348
+ <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
349
+ <auro-flight-segment canceled iata="SEA" duration="0h 40m"></auro-flight-segment>
350
+ <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
351
+ <auro-flight-segment canceled destinationCanceled iata="DUB" duration="13h 40m"></auro-flight-segment>
352
+ </auro-flightline>
353
+ <!-- AURO-GENERATED-CONTENT:END -->
349
354
  </div>
350
355
  <auro-accordion alignRight>
351
- <span slot="trigger">See code</span>
356
+ <span slot="trigger">See code</span>
352
357
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/canceled-stop-and-layovers.html) -->
353
358
  <!-- The below code snippet is automatically added from ../apiExamples/canceled-stop-and-layovers.html -->
354
359
 
355
- ```html
356
- <auro-flightline>
357
- <auro-flight-segment stopover iata="YAK"></auro-flight-segment>
358
- <auro-flight-segment stopover iata="WRG"></auro-flight-segment>
359
- <auro-flight-segment canceled iata="SEA" duration="0h 40m"></auro-flight-segment>
360
- <auro-flight-segment iata="BOS" duration="1h 40m"></auro-flight-segment>
361
- <auro-flight-segment canceled destinationCanceled iata="DUB" duration="13h 40m"></auro-flight-segment>
362
- </auro-flightline>
363
- ```
360
+ <pre class="language-html"><code class="language-html">&lt;auro-flightline&gt;
361
+ &lt;auro-flight-segment stopover iata="YAK"&gt;&lt;/auro-flight-segment&gt;
362
+ &lt;auro-flight-segment stopover iata="WRG"&gt;&lt;/auro-flight-segment&gt;
363
+ &lt;auro-flight-segment canceled iata="SEA" duration="0h 40m"&gt;&lt;/auro-flight-segment&gt;
364
+ &lt;auro-flight-segment iata="BOS" duration="1h 40m"&gt;&lt;/auro-flight-segment&gt;
365
+ &lt;auro-flight-segment canceled destinationCanceled iata="DUB" duration="13h 40m"&gt;&lt;/auro-flight-segment&gt;
366
+ &lt;/auro-flightline&gt;</code></pre>
364
367
  <!-- AURO-GENERATED-CONTENT:END -->
365
368
  </auro-accordion>
366
369
 
367
- ## Restyle Component with CSS Variables
370
+ ## Restyle with CSS custom properties
368
371
 
369
- The component may be restyled by changing the values of the following token(s).
372
+ Restyle the component by changing the values of the following tokens.
370
373
 
371
374
  <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../src/styles/tokens.scss) -->
372
375
  <!-- The below code snippet is automatically added from ./../src/styles/tokens.scss -->
373
376
 
374
- ```scss
375
- @use "@aurodesignsystem/design-tokens/dist/themes/alaska/SCSSVariables--alaska" as v;
376
-
377
- :host {
377
+ <pre class="language-scss"><code class="language-scss">@use "@aurodesignsystem/design-tokens/dist/themes/alaska/SCSSVariables--alaska" as v;
378
+ &#10;:host {
378
379
  --ds-auro-flightline-destination-line-color: var(--ds-advanced-color-flightline-line, #{v.$ds-advanced-color-flightline-line});
379
380
  --ds-auro-flightline-segment-iata-text-color: var(--ds-basic-color-texticon-muted, #{v.$ds-basic-color-texticon-muted});
380
381
  --ds-auro-flightline-segment-line-color: var(--ds-advanced-color-flightline-line, #{v.$ds-advanced-color-flightline-line});
381
382
  --ds-auro-flightline-layover-duration-color: var(--ds-basic-color-texticon-muted, #{v.$ds-basic-color-texticon-muted});
382
383
  --ds-auro-flightline-layover-marker-border-color: var(--ds-advanced-color-flightline-indicator, #{v.$ds-advanced-color-flightline-indicator});
383
384
  --ds-auro-flightline-layover-marker-container-color: var(--ds-advanced-color-flightline-indicator, #{v.$ds-advanced-color-flightline-indicator});
384
- }
385
- ```
385
+ }</code></pre>
386
386
  <!-- AURO-GENERATED-CONTENT:END -->