diff --git a/docs/source/styles/positioning.blade.md b/docs/source/styles/positioning.blade.md new file mode 100644 index 000000000..291aaeeba --- /dev/null +++ b/docs/source/styles/positioning.blade.md @@ -0,0 +1,176 @@ +--- +extends: _layouts.markdown +title: "Positioning" +--- + +# Positioning + +
+ Utilities for controlling how an element is positioned in the DOM. +
+ +
+ Responsive +
+ +### Static Default + +Use `.static` to position an element according to the normal flow of the document. + +Any offsets will be ignored and the element will not act as a position reference for absolutely positioned children. + +@component('_partials.code-sample') +
+
+

Static parent

+
+

Absolute child

+
+
+
+ +@slot('code') +
+ Static parent +
+ Absolute child +
+
+@endslot +@endcomponent + +### Relative + +Use `.relative` to position an element according to the normal flow of the document. + +Offsets are calculated relative to the element's normal position and the element *will* act as a position reference for absolutely positioned children. + +@component('_partials.code-sample') +
+
+

Relative parent

+
+

Absolute child

+
+
+
+ +@slot('code') +
+ Relative parent +
+ Absolute child +
+
+@endslot +@endcomponent + +### Absolute + +Use `.absolute` to position an element *outside* of the normal flow of the document, causing neighboring elements to act as if the element doesn't exist. + +Offsets are calculated relative to the nearest parent that has a position other than `static`, and the element *will* act as a position reference for other absolutely positioned children. + +@component('_partials.code-sample') +
+

Relative parent

+
+

Static parent

+
+

Absolute child

+
+
+

Static sibling

+
+
+
+ +@slot('code') +
+ Relative parent +
+ Static parent +
+ Absolute child +
+
+ Static sibling +
+
+
+@endslot +@endcomponent + +### Fixed + +Use `.fixed` to position an element relative to the browser window. + +Offsets are calculated relative to the viewport and the element *will* act as a position reference for absolutely positioned children. + +@component('_partials.code-sample') +
+
+ Fixed child +
+ Absolute child +
+
+
+

Scroll me!

+ +

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet. Duis sagittis ipsum. Praesent mauris. Fusce nec tellus sed augue semper porta. Mauris massa. Vestibulum lacinia arcu eget nulla. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Curabitur sodales ligula in libero.

+ +

Sed dignissim lacinia nunc. Curabitur tortor. Pellentesque nibh. Aenean quam. In scelerisque sem at dolor. Maecenas mattis. Sed convallis tristique sem. Proin ut ligula vel nunc egestas porttitor. Morbi lectus risus, iaculis vel, suscipit quis, luctus non, massa. Fusce ac turpis quis ligula lacinia aliquet. Mauris ipsum. Nulla metus metus, ullamcorper vel, tincidunt sed, euismod in, nibh. Quisque volutpat condimentum velit. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.

+ +

Nam nec ante. Sed lacinia, urna non tincidunt mattis, tortor neque adipiscing diam, a cursus ipsum ante quis turpis. Nulla facilisi. Ut fringilla. Suspendisse potenti. Nunc feugiat mi a tellus consequat imperdiet. Vestibulum sapien. Proin quam. Etiam ultrices. Suspendisse in justo eu magna luctus suscipit. Sed lectus. Integer euismod lacus luctus magna.

+ +

Quisque cursus, metus vitae pharetra auctor, sem massa mattis sem, at interdum magna augue eget diam. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Morbi lacinia molestie dui. Praesent blandit dolor. Sed non quam. In vel mi sit amet augue congue elementum. Morbi in ipsum sit amet pede facilisis laoreet. Donec lacus nunc, viverra nec, blandit vel, egestas et, augue. Vestibulum tincidunt malesuada tellus. Ut ultrices ultrices enim. Curabitur sit amet mauris. Morbi in dui quis est pulvinar ullamcorper. Nulla facilisi.

+ +

Integer lacinia sollicitudin massa. Cras metus. Sed aliquet risus a tortor. Integer id quam. Morbi mi. Quisque nisl felis, venenatis tristique, dignissim in, ultrices sit amet, augue. Proin sodales libero eget ante. Nulla quam. Aenean laoreet. Vestibulum nisi lectus, commodo ac, facilisis ac, ultricies eu, pede. Ut orci risus, accumsan porttitor, cursus quis, aliquet eget, justo. Sed pretium blandit orci. Ut eu diam at pede suscipit sodales. Aenean lectus elit, fermentum non, convallis id, sagittis at, neque.

+ +

Nullam mauris orci, aliquet et, iaculis et, viverra vitae, ligula. Nulla ut felis in purus aliquam imperdiet. Maecenas aliquet mollis lectus. Vivamus consectetuer risus et tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet. Duis sagittis ipsum. Praesent mauris. Fusce nec tellus sed augue semper porta. Mauris massa.

+ +

Vestibulum lacinia arcu eget nulla. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Curabitur sodales ligula in libero. Sed dignissim lacinia nunc. Curabitur tortor. Pellentesque nibh. Aenean quam. In scelerisque sem at dolor. Maecenas mattis. Sed convallis tristique sem. Proin ut ligula vel nunc egestas porttitor. Morbi lectus risus, iaculis vel, suscipit quis, luctus non, massa. Fusce ac turpis quis ligula lacinia aliquet.

+ +

Mauris ipsum. Nulla metus metus, ullamcorper vel, tincidunt sed, euismod in, nibh. Quisque volutpat condimentum velit. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Nam nec ante. Sed lacinia, urna non tincidunt mattis, tortor neque adipiscing diam, a cursus ipsum ante quis turpis. Nulla facilisi. Ut fringilla. Suspendisse potenti. Nunc feugiat mi a tellus consequat imperdiet. Vestibulum sapien. Proin quam.

+
+
+ +@slot('code') +
+
+ Fixed child +
+ Absolute child +
+
+ Scroll me! + + Lorem ipsum... +
+@endslot +@endcomponent + + +## Responsive + +To apply an overflow utility only at a specific breakpoint, add a `{breakpoint}:` prefix to the existing class name. For example, adding the class `md:overflow-scroll` to an element would apply the `overflow-scroll` utility at medium screen sizes and above. + +For more information about Tailwind's responsive design features, check out the [Responsive Design](/workflow/responsive-design) documentation. + +@component('_partials.responsive-code-sample') +@slot('none') +@endslot + +@slot('sm') +@endslot + +@slot('md') +@endslot + +@slot('xl') +@endslot + +@slot('code') +@endslot +@endcomponent diff --git a/docs/source/styles/positioning.md b/docs/source/styles/positioning.md deleted file mode 100644 index e613e546f..000000000 --- a/docs/source/styles/positioning.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -extends: _layouts.markdown -title: "Positioning" ---- - -# Positioning - -
- Usage - Responsive - Customizing -
- -The position utilities are primarily `position` property helpers. - -```html - - -
-
-
-``` - -```less -// Using the utilities in Less: - -div { - .fixed; - .absolute; - .relative; -} -``` - -## Pinning absolute content - -Tailwind also provides pin utilties, useful for "pinning" absolutely positioned elements using the `top`, `right`, `bottom` and `left` properties. - -```html - - -
-
-
-``` - -```less -// Using the utilities in Less: - -div { - .pin; - .pin-t; - .pin-r; - .pin-b; - .pin-l; - .pin-x; - .pin-y; -} -``` - -## Responsive - -The position utitlies can also be used with responsive prefixes: - -```html - - -
-``` - -```less -// Using the utilities in Less: - -div { - .screen(md, { - .relative; - }); -} -```