playbook_ui 14.17.0.pre.alpha.play1906overlaykitaddopacityandgradient7232 → 14.17.0.pre.alpha.play1964tablekitheadertextstylefix7164

data/lib/playbook/version.rb

@@ -2,5 +2,5 @@
 
 module Playbook
   PREVIOUS_VERSION = "14.17.0"
-  VERSION = "14.17.0.pre.alpha.play1906overlaykitaddopacityandgradient7232"
+  VERSION = "14.17.0.pre.alpha.play1964tablekitheadertextstylefix7164"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: playbook_ui
 version: !ruby/object:Gem::Version
-  version: 14.17.0.pre.alpha.play1906overlaykitaddopacityandgradient7232
+  version: 14.17.0.pre.alpha.play1964tablekitheadertextstylefix7164
 platform: ruby
 authors:
 - Power UX
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-16 00:00:00.000000000 Z
+date: 2025-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -421,8 +421,6 @@ files:
 - app/pb_kits/playbook/pb_background/docs/_background_image.md
 - app/pb_kits/playbook/pb_background/docs/_background_light.html.erb
 - app/pb_kits/playbook/pb_background/docs/_background_light.jsx
-- app/pb_kits/playbook/pb_background/docs/_background_overlay.jsx
-- app/pb_kits/playbook/pb_background/docs/_background_overlay.md
 - app/pb_kits/playbook/pb_background/docs/_background_size.html.erb
 - app/pb_kits/playbook/pb_background/docs/_background_size.jsx
 - app/pb_kits/playbook/pb_background/docs/_background_size.md
@@ -1186,35 +1184,33 @@ files:
 - app/pb_kits/playbook/pb_draggable/_draggable.tsx
 - app/pb_kits/playbook/pb_draggable/context/index.tsx
 - app/pb_kits/playbook/pb_draggable/context/types.ts
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_default.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_default.jsx
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_default.md
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_default_rails.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_default_rails.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_default_react.md
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_drop_zones.jsx
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_drop_zones.md
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_drop_zones_colors.jsx
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_drop_zones_colors.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_drop_zones_line.jsx
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_drop_zones_line.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_multiple_containers.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_multiple_containers.jsx
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_multiple_containers.md
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_multiple_containers_rails.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_multiple_containers_rails.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_multiple_containers_react.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_cards.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_with_cards.jsx
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_cards.md
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_cards_rails.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_with_cards_rails.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_cards_react.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_list.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_with_list.jsx
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_list.md
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_list_rails.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_with_list_rails.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_list_react.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_selectable_list.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_with_selectable_list.jsx
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_selectable_list.md
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_selectable_list_rails.html.erb
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_with_selectable_list_rails.md
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_selectable_list_react.md
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_with_table.html.erb
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_table.jsx
-- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_table_rails.md
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_table.md
+- app/pb_kits/playbook/pb_draggable/docs/_draggable_with_table_react.jsx
 - app/pb_kits/playbook/pb_draggable/docs/_draggable_with_table_react.md
 - app/pb_kits/playbook/pb_draggable/docs/example.yml
 - app/pb_kits/playbook/pb_draggable/docs/index.js
@@ -2195,19 +2191,13 @@ files:
 - app/pb_kits/playbook/pb_online_status/online_status.test.js
 - app/pb_kits/playbook/pb_overlay/_overlay.scss
 - app/pb_kits/playbook/pb_overlay/_overlay.tsx
-- app/pb_kits/playbook/pb_overlay/docs/_overlay_color.jsx
-- app/pb_kits/playbook/pb_overlay/docs/_overlay_color.md
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_default.html.erb
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_default.jsx
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_default.md
-- app/pb_kits/playbook/pb_overlay/docs/_overlay_gradient_opacity.jsx
-- app/pb_kits/playbook/pb_overlay/docs/_overlay_gradient_opacity.md
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_hide_scroll_bar.html.erb
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_hide_scroll_bar.jsx
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_hide_scroll_bar_rails.md
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_hide_scroll_bar_react.md
-- app/pb_kits/playbook/pb_overlay/docs/_overlay_layout.jsx
-- app/pb_kits/playbook/pb_overlay/docs/_overlay_layout.md
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_multi_directional.html.erb
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_multi_directional.jsx
 - app/pb_kits/playbook/pb_overlay/docs/_overlay_multi_directional.md
@@ -2877,13 +2867,9 @@ files:
 - app/pb_kits/playbook/pb_table/docs/_table_with_collapsible_with_nested_table.md
 - app/pb_kits/playbook/pb_table/docs/_table_with_collapsible_with_nested_table_rails.html.erb
 - app/pb_kits/playbook/pb_table/docs/_table_with_collapsible_with_nested_table_rails.md
-- app/pb_kits/playbook/pb_table/docs/_table_with_header_style_borderless.html.erb
 - app/pb_kits/playbook/pb_table/docs/_table_with_header_style_borderless.jsx
-- app/pb_kits/playbook/pb_table/docs/_table_with_header_style_borderless_rails.md
 - app/pb_kits/playbook/pb_table/docs/_table_with_header_style_borderless_react.md
-- app/pb_kits/playbook/pb_table/docs/_table_with_header_style_floating.html.erb
 - app/pb_kits/playbook/pb_table/docs/_table_with_header_style_floating.jsx
-- app/pb_kits/playbook/pb_table/docs/_table_with_header_style_floating_rails.md
 - app/pb_kits/playbook/pb_table/docs/_table_with_header_style_floating_react.md
 - app/pb_kits/playbook/pb_table/docs/_table_with_selectable_rows.html.erb
 - app/pb_kits/playbook/pb_table/docs/_table_with_selectable_rows.jsx
@@ -3481,8 +3467,8 @@ files:
 - app/pb_kits/playbook/utilities/test/globalProps/truncate.test.js
 - app/pb_kits/playbook/utilities/text.ts
 - app/pb_kits/playbook/utilities/validEmojiChecker.ts
-- dist/chunks/_typeahead-C2GOKWtm.js
-- dist/chunks/_weekday_stacked-Cw9LuHnt.js
+- dist/chunks/_typeahead-7W5Ha5Td.js
+- dist/chunks/_weekday_stacked-DSKatW3m.js
 - dist/chunks/lazysizes-B7xYodB-.js
 - dist/chunks/lib-BGzBzFZX.js
 - dist/chunks/pb_form_validation-BvNy9Bd6.js

data/app/pb_kits/playbook/pb_background/docs/_background_overlay.jsx

@@ -1,35 +0,0 @@
-import React from 'react'
-import Background from "../../pb_background/_background"
-import Flex from "../../pb_flex/_flex"
-import FlexItem from "../../pb_flex/_flex_item"
-import Title from "../../pb_title/_title"
-
-const BackgroundOverlay = (props) => {
-  return (
-    <Background
-        alt="colorful background"
-        backgroundColor="category_21"
-        className="background lazyload"
-        imageOverlay="opacity_2"
-        imageUrl="https://unsplash.it/500/400/?image=633"
-        {...props}
-      >
-        <Flex
-            orientation="column"
-            vertical="center"
-            {...props}
-        >
-          <FlexItem>
-            <Title
-                dark
-                padding="lg"
-                size={1}
-                text="Background Kit Image"
-            />
-          </FlexItem>
-        </Flex>
-      </Background>
-  )
-}
-
-export default BackgroundOverlay

data/app/pb_kits/playbook/pb_background/docs/_background_overlay.md

@@ -1 +0,0 @@
-An overlay can be added to the background image by setting the `imageOverlay` prop and adding a `backgroundColor`. The `imageOverlay` prop can be set to any opacity ranging from `opacity_1` to `opacity_10`.

data/app/pb_kits/playbook/pb_draggable/docs/_draggable_drop_zones_line.jsx

@@ -1,110 +0,0 @@
-import React, { useState } from "react";
-import Flex from '../../pb_flex/_flex'
-import Caption from '../../pb_caption/_caption'
-import Draggable from '../_draggable'
-import { DraggableProvider } from '../context'
-import Image from '../../pb_image/_image'
-
-
-
-const dataLineVertical = [
-  {
-    id: "211",
-    url: "https://unsplash.it/500/400/?image=633",
-  },
-  {
-    id: "212",
-    url: "https://unsplash.it/500/400/?image=634",
-  },
-  {
-    id: "213",
-    url: "https://unsplash.it/500/400/?image=637",
-  },
-];
-
-const dataLineHorizontal = [
-  {
-    id: "2111",
-    url: "https://unsplash.it/500/400/?image=633",
-  },
-  {
-    id: "2122",
-    url: "https://unsplash.it/500/400/?image=634",
-  },
-  {
-    id: "2133",
-    url: "https://unsplash.it/500/400/?image=637",
-  },
-];
-
-const DraggableDropZones = (props) => {
-  const [initialLineVerticalState, setInitialLineVerticalState] = useState(dataLineVertical);
-  const [initialLineHorizontalState, setInitialLineHorizontalState] = useState(dataLineHorizontal);
-
-  return (
-    <>
-      <Caption marginBottom="xs" 
-          marginTop="xl"
-          text="Vertical"
-      />
-      <DraggableProvider
-          dropZone={{ type: "line", color: "purple" }}
-          initialItems={dataLineVertical}
-          onReorder={(items) => setInitialLineVerticalState(items)}
-      >
-        <Draggable.Container {...props}>
-          <Flex flexDirection="column"
-              height="367px"
-          >
-              {initialLineVerticalState.map(({ id, url }) => (
-                <Draggable.Item dragId={id}
-                    key={id}
-                    marginBottom="sm"
-                >
-                  <Image alt={id}
-                      size="md"
-                      url={url}
-                  />
-                </Draggable.Item>
-              ))}
-          </Flex>
-        </Draggable.Container>
-      </DraggableProvider>
-      <Caption marginBottom="xs" 
-          marginTop="xl"
-          text="Horizontal"
-      />
-      <Flex>
-        <DraggableProvider
-            dropZone={{ type: "line", direction: "horizontal" }}
-            initialItems={dataLineHorizontal}
-            onReorder={(items) => setInitialLineHorizontalState(items)}
-        >
-          <Draggable.Container
-              htmlOptions={{style:{ width: "285px"}}}
-              {...props}
-          >
-            <Flex alignItems="stretch"
-                flexDirection="row"
-                height="110px"
-            > 
-              {initialLineHorizontalState.map(({ id, url }) => (
-                <Draggable.Item dragId={id}
-                    key={id}
-                    marginRight="sm"
-                >
-                  <Image alt={id}
-                      size="md"
-                      url={url}
-                  />
-                </Draggable.Item>
-              ))}
-            </Flex>
-          </Draggable.Container>
-        </DraggableProvider>
-      </Flex>
-    </>
-  );
-};
-
-export default DraggableDropZones;

data/app/pb_kits/playbook/pb_draggable/docs/_draggable_drop_zones_line.md

@@ -1,5 +0,0 @@
-When using the "line" style, make sure to set the appropriate `direction` attribute within the `dropZone` prop based on the orientation of your draggable view. By default, this is set to "vertical," but it can also be adjusted to "horizontal." Note that the direction attribute only applies to the "line" style and does not affect other drop zone styles. The default `color` for "line" is "primary" and "purple" is the only alternative color option.
-
-The length of the line is calculated based off of the width (for "vertical") or height (for "horizontal") of the parent container holding the draggable items. 
-
-Additionally, if the parent container of the `DraggableProvider`/`DraggableContainer` (or a subcontainer within) does not have a set height (for "vertical") or width (for "horizontal"), like the [Draggable Drop Zones doc example](https://playbook.powerapp.cloud/kits/draggable/react#draggable-drop-zones) does, elements on the page may jump up (for "vertical") or to the left (for "horizontal") when an item is actively being dragged. To prevent this, give a parent element a fixed height (for "vertical") or width (for "horizontal") as demonstrated in this doc example.

data/app/pb_kits/playbook/pb_overlay/docs/_overlay_color.jsx

@@ -1,63 +0,0 @@
-import React from 'react'
-
-import Overlay from '../../pb_overlay/_overlay'
-import Image from '../../pb_image/_image'
-import Flex from '../../pb_flex/_flex'
-
-const OverlayColor = () => (
-    <Flex
-        justify="around"
-        wrap
-    >
-        <Overlay
-            color="black"
-            marginBottom="xxs"
-        >
-          <Image
-              alt="picture of a misty forest"
-              display="block"
-              size="xl"
-              url="https://unsplash.it/500/400/?image=634"
-          />
-        </Overlay>
-        <Overlay
-            color="black"
-            gradient={false}
-            marginBottom="xxs"
-            opacity="opacity_4"
-        >
-          <Image
-              alt="picture of a misty forest"
-              display="block"
-              size="xl"
-              url="https://unsplash.it/500/400/?image=634"
-          />
-        </Overlay>
-        <Overlay
-            color="error"
-            marginBottom="xxs"
-        >
-          <Image
-              alt="picture of a misty forest"
-              display="block"
-              size="xl"
-              url="https://unsplash.it/500/400/?image=634"
-          />
-        </Overlay>
-        <Overlay
-            color="error"
-            gradient={false}
-            marginBottom="xxs"
-            opacity="opacity_4"
-        >
-          <Image
-              alt="picture of a misty forest"
-              display="block"
-              size="xl"
-              url="https://unsplash.it/500/400/?image=634"
-          />
-        </Overlay>
-    </Flex>
-)
-
-export default OverlayColor

data/app/pb_kits/playbook/pb_overlay/docs/_overlay_color.md

@@ -1,3 +0,0 @@
-The `color` prop is used to change the color of the solid or gradient mask. Gradient overlays always start opaque and fade to transparent.
-
-NOTE: Images are set to `display: block` to remove the default inline spacing caused by line height. This ensures the image fully fills the container without unexpected gaps.

data/app/pb_kits/playbook/pb_overlay/docs/_overlay_gradient_opacity.jsx

@@ -1,39 +0,0 @@
-import React from 'react'
-
-import Overlay from '../../pb_overlay/_overlay'
-import Image from '../../pb_image/_image'
-import Flex from '../../pb_flex/_flex'
-
-const OverlayGradientOpacity = () => (
-    <Flex
-        justify="around"
-        wrap
-    >
-        <Overlay
-            gradient={false}
-            marginBottom="xxs"
-            opacity="opacity_2"
-        >
-          <Image
-              alt="picture of a misty forest"
-              display="block"
-              maxWidth="100%"
-              url="https://unsplash.it/500/400/?image=634"
-          />
-        </Overlay>
-        <Overlay
-            gradient={false}
-            marginBottom="xxs"
-            opacity="opacity_8"
-        >
-          <Image
-              alt="picture of a misty forest"
-              display="block"
-              maxWidth="100%"
-              url="https://unsplash.it/500/400/?image=634"
-          />
-        </Overlay>
-    </Flex>
-)
-
-export default OverlayGradientOpacity

data/app/pb_kits/playbook/pb_overlay/docs/_overlay_gradient_opacity.md

@@ -1 +0,0 @@
-By default, the overlay is rendered as a gradient. Setting the `gradient` prop to `false` renders the overlay as a solid color. You can adjust the transparency of the solid overlay by using the `opacity` prop.

data/app/pb_kits/playbook/pb_overlay/docs/_overlay_layout.jsx

@@ -1,40 +0,0 @@
-import React from 'react'
-
-import Overlay from '../../pb_overlay/_overlay'
-import Table from '../../pb_table/_table'
-
-
-const TableExample = () => {
-    return (
-        <Table size="sm">
-            <thead>
-                <tr>
-                    <th>{'Column 1'}</th>
-                    <th>{'Column 2'}</th>
-                    <th>{'Column 3'}</th>
-                    <th>{'Column 4'}</th>
-                    <th>{'Column 5'}</th>
-                </tr>
-            </thead>
-            <tbody>
-                {Array.from({ length: 7 }, (_, index) => (
-                    <tr key={index}>
-                        {Array.from({ length: 5 }, (_, columnIndex) => (
-                            <td key={columnIndex}>{`Value ${columnIndex + 1}`}</td>
-                        ))}
-                    </tr>
-                ))}
-            </tbody>
-        </Table>
-    )
-}
-
-const OverlayLayout = () => (
-    <>
-        <Overlay layout={{ y: "xl" }}>
-            <TableExample />
-        </Overlay>
-    </>
-)
-
-export default OverlayLayout

data/app/pb_kits/playbook/pb_overlay/docs/_overlay_layout.md

@@ -1,5 +0,0 @@
-The optional `layout` prop accepts the `position` and `size` of the overlay as a key:value pair.
-
-The `position` key accepts `bottom` (default), `top`, `y` (for both top and bottom) `right`, `left`, or `x` (for both left and right), which sets the side(s) where the `color` overlay starts. The direction of the overlay is always toward the opposite side of the position. For example, the default position of `bottom` starts the overlay on the bottom edge of your container and extends it toward the opposite side: the top.
-
-The `size` value is `full` (100%) by default, but accepts our [spacing tokens](https://playbook.powerapp.cloud/visual_guidelines/spacing) or a percentage value as a string, and literally translates to how much of the container is covered by the overlay(s).

data/app/pb_kits/playbook/pb_table/docs/_table_with_header_style_borderless.html.erb

@@ -1,34 +0,0 @@
-<%= pb_rails("table", props: { size: "sm", header_style: "borderless" }) do %>
-    <thead>
-        <tr>
-            <th>Column 1</th>
-            <th>Column 2</th>
-            <th>Column 3</th>
-            <th>Column 4</th>
-            <th>Column 5</th>
-        </tr>
-    </thead>
-    <tbody>
-        <tr>
-            <td>Value 1</td>
-            <td>Value 2</td>
-            <td>Value 3</td>
-            <td>Value 4</td>
-            <td>Value 5</td>
-        </tr>
-        <tr>
-            <td>Value 1</td>
-            <td>Value 2</td>
-            <td>Value 3</td>
-            <td>Value 4</td>
-            <td>Value 5</td>
-        </tr>
-        <tr>
-            <td>Value 1</td>
-            <td>Value 2</td>
-            <td>Value 3</td>
-            <td>Value 4</td>
-            <td>Value 5</td>
-        </tr>
-    </tbody>
-<% end %>

data/app/pb_kits/playbook/pb_table/docs/_table_with_header_style_borderless_rails.md

@@ -1 +0,0 @@
-Customize your header by removing the header borders with the `header_style: "borderless"` prop.

data/app/pb_kits/playbook/pb_table/docs/_table_with_header_style_floating.html.erb

@@ -1,36 +0,0 @@
-<%= pb_rails("card", props: { background: "light" })  do %>
-    <%= pb_rails("table", props: { size: "sm", header_style: "floating" }) do %>
-        <%= pb_rails("table/table_head") do %>
-            <%= pb_rails("background", props: { background_color: "light", tag: "tr" }) do %>
-                <%= pb_rails("table/table_header", props: { text: "Column 1"}) %>
-                <%= pb_rails("table/table_header", props: { text: "Column 2"}) %>
-                <%= pb_rails("table/table_header", props: { text: "Column 3"}) %>
-                <%= pb_rails("table/table_header", props: { text: "Column 4"}) %>
-                <%= pb_rails("table/table_header", props: { text: "Column 5"}) %>       
-            <% end %>
-        <% end %>
-        <%= pb_rails("table/table_body") do %>
-            <%= pb_rails("table/table_row") do %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 1"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 2"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 3"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 4"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 5"}) %>
-            <% end %>
-            <%= pb_rails("table/table_row") do %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 1"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 2"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 3"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 4"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 5"}) %>
-            <% end %>
-            <%= pb_rails("table/table_row") do %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 1"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 2"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 3"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 4"}) %>
-                <%= pb_rails("table/table_cell", props: { text: "Value 5"}) %>
-            <% end %>
-        <% end %>
-    <% end %>
-<% end %>

data/app/pb_kits/playbook/pb_table/docs/_table_with_header_style_floating_rails.md

@@ -1 +0,0 @@
-Further customize your header by using the [table with background kit](https://playbook.powerapp.cloud/kits/table/rails#table-with-background-kit) logic to give your table header a custom background color. Use the `header_style: "floating"` prop to visually nest the borderless table within a card or collapsible with a matching background color (the `background_color` passed to Background kit should match the `background` or `background_color` for the element in which it is nested).