meta.get-mixin($name, $module: null) returns a mixin value for the named mixin. Include it with @include meta.apply(). Load it with @use "sass:meta" on Dart Sass 1.69+.
Build an apply-to-all helper that receives meta.get-mixin("font-class") and calls @include meta.apply($mixin, $element) for each list item.
$module for namespaces.Pass a string matching a @use namespace, or a module value, to resolve mixins from that module.
Official docs: if $name is not a mixin, Sass errors. Guard optional names with meta.mixin-exists first.
@use "sass:meta";
meta.get-mixin($name, $module: null); //=> mixin
@mixin font-class($size) {
.font-#{$size} { font-size: $size; }
}
@include meta.apply(meta.get-mixin("font-class"), 12px);
@include meta.apply(meta.get-mixin("wrap")) {
// forwarded @content
}
// Module API — prefer meta.get-mixin after @use "sass:meta"Pattern: resolve a mixin value → @include meta.apply with args → optionally forward @content. Check meta.accepts-content when content is optional.
Same resolve idea, different member types:
| Helper | Returns | Then use |
|---|---|---|
meta.get-mixin | Mixin value | @include meta.apply(...) — emits CSS / can take @content |
meta.get-function | Function value | meta.call(...) — returns a value |
meta.mixin-exists | Boolean | Safe optional check before get-mixin |
meta.module-mixins | Map of mixin values | Pick a mixin with map.get, then apply |
$css flag.Unlike get-function, mixins are Sass-only. There is no “plain CSS mixin” mode.
Examples target Dart Sass 1.69+ with @use "sass:meta". Open View Compiled CSS for verified output (matches official Sass docs samples where shown).
Get a mixin value, then include it with one argument.
@use "sass:meta";
@mixin font-class($size) {
.font-#{$size} {
font-size: $size;
}
}
@include meta.apply(meta.get-mixin("font-class"), 12px);12px.@include font-class(12px), but dynamic.apply-to-allPass a mixin value into a helper that applies it to each list item.
@use "sass:meta";
/// Passes each element of $list to a separate invocation of $mixin.
@mixin apply-to-all($mixin, $list) {
@each $element in $list {
@include meta.apply($mixin, $element);
}
}
@mixin font-class($size) {
.font-#{$size} {
font-size: $size;
}
}
$sizes: 8px, 12px, 2rem;
@include apply-to-all(meta.get-mixin("font-class"), $sizes);font-class.@content BlockContent passed to meta.apply is forwarded into the resolved mixin.
@use "sass:meta";
@mixin with-content {
.inner {
@content;
}
}
.wrap {
@include meta.apply(meta.get-mixin("with-content")) {
color: red;
}
}meta.apply.color: red under .inner.accepts-contentForward a content block only when the resolved mixin can take one.
@use "sass:meta";
@mixin plain {
color: blue;
}
@mixin with-content {
.inner {
@content;
}
}
@mixin apply-if-content($name) {
$mixin: meta.get-mixin($name);
@if meta.accepts-content($mixin) {
@include meta.apply($mixin) {
outline: 1px solid red;
}
} @else {
@include meta.apply($mixin);
}
}
.a {
@include apply-if-content("plain");
}
.b {
@include apply-if-content("with-content");
}mixin-existsAvoid a throw when the mixin name might be missing.
@use "sass:meta";
@mixin badge {
.badge {
display: inline-block;
}
}
.exists {
@if meta.mixin-exists("badge") {
@include meta.apply(meta.get-mixin("badge"));
}
}Most get-mixin bugs are missing names, forgetting apply, or confusing functions with mixins.
Use meta.mixin-exists before resolving optional mixins.
You still need @include meta.apply($mixin, …) to emit CSS.
$moduleMatch the @use namespace string, or pass a module value.
Dynamic functions return values via meta.get-function + meta.call.
Prefer the module form with Dart Sass 1.69+.
| API | Status |
|---|---|
meta.get-mixin() | Dart Sass 1.69+ via @use "sass:meta" |
| Return type | Mixin value |
| Include with | @include meta.apply($mixin, $args...) |
| LibSass / Ruby Sass | Not available |
Compile with the Dart Sass CLI.
@use "sass:meta".One line: when you need a mixin value to pass around or include dynamically, use meta.get-mixin($name, $module: null).
Practical checklist:
1. @use "sass:meta"
2. meta.get-mixin("name") or with $module
3. @include meta.apply($mixin, $args...)
4. Optionally forward @content (guard with accepts-content)
5. Prefer mixin-exists before optional lookupsCheck whether a global variable name is defined.
8 people found this page helpful