hugo-theme-relearn/exampleSite/content/shortcodes/expand.en.md

94 lines
2 KiB
Markdown
Raw Normal View History

+++
description = "Displays an expandable/collapsible section of text on your page"
title = "Expand"
+++
2017-08-20 15:10:29 +00:00
The Expand shortcode displays an expandable/collapsible section of text on your page.
2021-07-16 20:35:20 +00:00
## Usage
````go
{{%/* expand [ <string> [ "true" | "false" ] ] */%}}
2021-07-16 20:35:20 +00:00
Yes!
{{%/* /expand */%}}
2021-07-16 20:35:20 +00:00
````
The first optional parameter defines the text that appears next to the expand/collapse icon. The default text is `"Expand me..."`.
2021-07-16 20:35:20 +00:00
The second optional parameter controls if the block is initially shown as expanded (`"true"`) or collapsed (`"false"`). The default ist `"false"`.
2021-07-16 20:35:20 +00:00
## Examples
{{% expand "I'll tell you a secret..." %}}
...maybe the next time you'll open this expander!
{{% /expand %}}
### All defaults
2017-08-20 15:10:29 +00:00
{{% expand %}}
Yes, you did it!
{{% /expand %}}
2021-07-16 20:35:20 +00:00
{{% expand "Show markup" "true" %}}
````go
2021-07-16 20:35:20 +00:00
{{%/* expand */%}}
Yes, you did it!
2021-07-16 20:35:20 +00:00
{{%/* /expand */%}}
````
{{% /expand %}}
### Initially expanded
{{% expand "Expand me..." "true" %}}
No need to press you!
{{% /expand %}}
{{% expand "Show markup" "true" %}}
````go
{{%/* expand "Expand me..." "true" */%}}
No need to press you!
{{%/* /expand */%}}
````
{{% /expand %}}
2017-08-20 15:10:29 +00:00
2021-07-16 20:35:20 +00:00
### Arbitrary text
2017-08-20 15:10:29 +00:00
{{% expand "Show me almost endless possibilities" %}}
2021-07-16 20:35:20 +00:00
Some expandable text.
2017-08-20 15:10:29 +00:00
You can add standard markdown syntax:
2017-08-20 15:10:29 +00:00
2021-07-16 20:35:20 +00:00
- multiple paragraphs
- bullet point lists
- _emphasized_, **bold** and even **_bold emphasized_** text
2021-07-16 20:35:20 +00:00
- [links](https://example.com)
- etc.
2017-08-20 15:10:29 +00:00
```plaintext
2021-07-16 20:35:20 +00:00
...and even source code
```
2017-08-20 15:10:29 +00:00
> the possiblities are endless (almost - including other shortcodes may or may not work)
{{% /expand %}}
2017-08-20 15:10:29 +00:00
2021-07-16 20:35:20 +00:00
{{% expand "Show markup" %}}
````go
{{%/* expand "Show me almost endless possibilities" */%}}
2021-07-16 20:35:20 +00:00
Some expandable text.
2017-08-20 15:10:29 +00:00
You can add standard markdown syntax:
2017-08-20 15:10:29 +00:00
2021-07-16 20:35:20 +00:00
- multiple paragraphs
- bullet point lists
- _emphasized_, **bold** and even **_bold emphasized_** text
2021-07-16 20:35:20 +00:00
- [links](https://example.com)
- etc.
```plaintext
2021-07-16 20:35:20 +00:00
...and even source code
```
> the possiblities are endless (almost - including other shortcodes may or may not work)
2021-07-16 20:35:20 +00:00
{{%/* /expand */%}}
````
{{% /expand %}}