sass-site/source/documentation/at-rules/debug.html.md.erb

41 lines
1.3 KiB
Plaintext
Raw Normal View History

2018-09-01 22:35:20 +02:00
---
title: "@debug"
2019-03-05 01:24:31 +01:00
introduction: >
Sometimes its useful to see the value of a [variable](../variables) or
[expression](../syntax/structure#expressions) while youre developing your
stylesheet. Thats what the `@debug` rule is for: its written
`@debug <expression>`, and it prints the value of that expression, along with
the filename and line number.
2018-09-01 22:35:20 +02:00
---
<% example(autogen_css: false) do %>
@mixin inset-divider-offset($offset, $padding) {
$divider-offset: (2 * $padding) + $offset;
@debug "divider offset: #{$divider-offset}";
margin-left: $divider-offset;
width: calc(100% - #{$divider-offset});
}
===
@mixin inset-divider-offset($offset, $padding)
$divider-offset: (2 * $padding) + $offset
@debug "divider offset: #{$divider-offset}"
margin-left: $divider-offset
width: calc(100% - #{$divider-offset})
2018-09-01 22:35:20 +02:00
<% end %>
The exact format of the debug message varies from implementation to
implementation. This is what it looks like in Dart Sass:
```
test.scss:3 Debug: divider offset: 132px
```
<% fun_fact do %>
You can pass any value to `@debug`, not just a string! It prints the same
representation of that value as the [`meta.inspect()` function][].
2018-09-01 22:35:20 +02:00
[`meta.inspect()` function]: ../modules/meta#inspect
2018-09-01 22:35:20 +02:00
<% end %>