Skip to content

Commit

Permalink
picker: also mention formulas
Browse files Browse the repository at this point in the history
  • Loading branch information
iJungleboy committed Sep 30, 2024
1 parent 2f4bdce commit 24c6dfd
Show file tree
Hide file tree
Showing 12 changed files with 217 additions and 4 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
uid: Basics.Data.Fields.Pickers.Formulas.Index
---
# Picker Formulas (new v18)

Formulas are a powerful way to create dynamic sources for pickers.

👉🏾 see also [Formulas](xref:Basics.Edit.Formulas.Index)

With Pickers, formulas are a bit more complex, since they can be used for:

1. Changing what is selected
1. Changing what the options are
1. Changing additional aspects of options, such as tooltips, disabled-state and more.

This is still WIP and will be documented as it's developed.

---

## History

1. Picker Formulas introduced as beta in v18.01
4 changes: 3 additions & 1 deletion 2sxc Docs Generator/pages/basics/data/fields/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -97,4 +97,6 @@
- name: Picker Fields
topicUid: Basics.Data.Fields.Pickers.Fields.Index
- name: Picker UIs
topicUid: Basics.Data.Fields.Pickers.Ui.Index
topicUid: Basics.Data.Fields.Pickers.Ui.Index
- name: Picker Formulas
topicUid: Basics.Data.Fields.Pickers.Formulas.Index
162 changes: 162 additions & 0 deletions docs/basics/data/fields/pickers/formulas/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,162 @@
<!DOCTYPE html>
<html>
<!-- 2sxc docs -->
<head>
<meta charset="utf-8">
<title>Picker Formulas (new v18) | 2sxc 18 for Dnn and Oqtane </title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="title" content="Picker Formulas (new v18) | 2sxc 18 for Dnn and Oqtane ">

<link rel="icon" href="../../../../../assets/favicon.ico">
<link rel="stylesheet" href="../../../../../public/docfx.min.css">
<link rel="stylesheet" href="../../../../../public/main.css">
<meta name="docfx:navrel" content="../../../../../toc.html">
<meta name="docfx:tocrel" content="../../../../toc.html">

<meta name="docfx:rel" content="../../../../../">


<meta name="docfx:docurl" content="https://github.com/2sic/2sxc-docs/blob/master/2sxc Docs Generator/pages/basics/data/fields/pickers/formulas/index.md/#L1">
<meta name="loc:inThisArticle" content="In this article">
<meta name="loc:searchResultsCount" content="{count} results for &quot;{query}&quot;">
<meta name="loc:searchNoResults" content="No results for &quot;{query}&quot;">
<meta name="loc:tocFilter" content="Filter by title">
<meta name="loc:nextArticle" content="Next">
<meta name="loc:prevArticle" content="Previous">
<meta name="loc:themeLight" content="Light">
<meta name="loc:themeDark" content="Dark">
<meta name="loc:themeAuto" content="Auto">
<meta name="loc:changeTheme" content="Change theme">
<meta name="loc:copy" content="Copy">
<meta name="loc:downloadPdf" content="Download PDF">

<script src="https://cdn.jsdelivr.net/npm/@fancyapps/[email protected]/dist/fancybox/fancybox.umd.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fancyapps/[email protected]/dist/fancybox/fancybox.css">


</head>

<script type="module" src="./../../../../../public/docfx.min.js"></script>

<script>
const theme = localStorage.getItem('theme') || 'auto'
document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light') : theme)
</script>

<script async="" src="https://www.googletagmanager.com/gtag/js?id=GTM-PH2TVNW"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag() { dataLayer.push(arguments); }
gtag('js', new Date());
gtag('config', 'GTM-PH2TVNW');
</script>

<body class="tex2jax_ignore" data-layout="" data-yaml-mime="">
<header class="bg-body border-bottom">
<nav id="autocollapse" class="navbar navbar-expand-md" role="navigation">
<div class="container-xxl flex-nowrap">
<a class="navbar-brand" href="../../../../../index.html">
<img id="logo" class="svg" src="../../../../../assets/logos/vcurrent/50.png" alt="">

</a>
<button class="btn btn-lg d-md-none border-0" type="button" data-bs-toggle="collapse" data-bs-target="#navpanel" aria-controls="navpanel" aria-expanded="false" aria-label="Toggle navigation">
<i class="bi bi-three-dots"></i>
</button>
<div class="collapse navbar-collapse" id="navpanel">
<div id="navbar">



<form class="search" role="search" id="search">
<i class="bi bi-search"></i>
<input class="form-control" id="search-query" type="search" disabled="" placeholder="Search" autocomplete="off" aria-label="Search">

<a class="btn btn-sm border-0 text-nowrap version-button" xstyle="padding: 10px 0 0 0; width: 25px" href="https://go.2sxc.org/docs-versions" target="_blank">
&nbsp; v18 <i class="bi bi-caret-down-fill fs-6"></i>
</a>
</form>


</div>
</div>
</div>
</nav>
</header>

<main class="container-xxl">
<div class="toc-offcanvas">
<div class="offcanvas-md offcanvas-start" tabindex="-1" id="tocOffcanvas" aria-labelledby="tocOffcanvasLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="tocOffcanvasLabel">Table of Contents</h5>
<button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#tocOffcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
<nav class="toc" id="toc"></nav>
</div>
</div>
</div>

<div class="content">
<div class="actionbar">
<button class="btn btn-lg border-0 d-md-none" style="margin-top: -.65em; margin-left: -.8em" type="button" data-bs-toggle="offcanvas" data-bs-target="#tocOffcanvas" aria-controls="tocOffcanvas" aria-expanded="false" aria-label="Show table of contents">
<i class="bi bi-list"></i>
</button>

<nav id="breadcrumb"></nav>
</div>

<article data-uid="Basics.Data.Fields.Pickers.Formulas.Index">
<h1 id="picker-formulas-new-v18">Picker Formulas (new v18)</h1>

<p>Formulas are a powerful way to create dynamic sources for pickers.</p>
<p>👉🏾 see also <a class="xref" href="../../../../edit/formulas/index.html">Formulas</a></p>
<p>With Pickers, formulas are a bit more complex, since they can be used for:</p>
<ol>
<li>Changing what is selected</li>
<li>Changing what the options are</li>
<li>Changing additional aspects of options, such as tooltips, disabled-state and more.</li>
</ol>
<p>This is still WIP and will be documented as it's developed.</p>
<hr>
<h2 id="history">History</h2>
<ol>
<li>Picker Formulas introduced as beta in v18.01</li>
</ol>

</article>

<div class="contribution d-print-none">
<a href="https://github.com/2sic/2sxc-docs/blob/master/2sxc Docs Generator/pages/basics/data/fields/pickers/formulas/index.md/#L1" class="edit-link">Edit this page</a>
</div>

<div class="next-article d-print-none border-top" id="nextArticle"></div>

</div>

<div class="affix">
<nav id="affix"></nav>
</div>
</main>

<div class="container-xxl search-results" id="search-results"></div>

<footer class="border-top text-secondary">
<div class="container-xxl">
<div class="flex-fill">

<span>
Made by <a href="https://www.2sic.com">2sic</a>
with 💖 and
<a href="https://dotnet.github.io/docfx">docfx</a>
for <a href="https://2sxc.org">2sxc</a>,
<a href="https://dnncommunity.org/">Dnn</a>
and <a href="https://www.oqtane.org/">Oqtane</a>
see also <a href="">2sxc Github</a> and <a href="https://blazor-cms.org">Blazor CMS</a>
</span>
</div>
</div>
</footer>
</body>
</html>
3 changes: 3 additions & 0 deletions docs/basics/data/fields/toc.html
Original file line number Diff line number Diff line change
Expand Up @@ -148,6 +148,9 @@
<li>
<a href="pickers/ui/index.html" name="" title="Picker UIs">Picker UIs</a>
</li>
<li>
<a href="pickers/formulas/index.html" name="" title="Picker Formulas">Picker Formulas</a>
</li>
</ul>
</li>
</ul>
Expand Down
2 changes: 1 addition & 1 deletion docs/basics/data/fields/toc.json
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@

{"order":100,"items":[{"name":"General Field Settings","href":"all.html","topicHref":"all.html","topicUid":"Basics.Data.Fields.GeneralSettings"},{"name":"Boolean Fields","href":"boolean.html","topicHref":"boolean.html","topicUid":"Basics.Data.Fields.Boolean","items":[{"name":"Boolean Default","href":"boolean-default.html","topicHref":"boolean-default.html","topicUid":"Basics.Data.Fields.Boolean-Default"},{"name":"Boolean Tristate","href":"boolean-tristate.html","topicHref":"boolean-tristate.html","topicUid":"Basics.Data.Fields.Boolean-Tristate"}]},{"name":"Date/Time Fields","href":"datetime.html","topicHref":"datetime.html","topicUid":"Basics.Data.Fields.DateTime","items":[{"name":"DateTime Default","href":"datetime-default.html","topicHref":"datetime-default.html","topicUid":"Basics.Data.Fields.DateTime-Default"}]},{"name":"Custom Fields / GPS","href":"custom.html","topicHref":"custom.html","topicUid":"Basics.Data.Fields.Custom","items":[{"name":"Custom GPS","href":"custom-gps.html","topicHref":"custom-gps.html","topicUid":"Basics.Data.Fields.CustomGps"}]},{"name":"Empty Fields (Groups)","href":"empty.html","topicHref":"empty.html","topicUid":"Basics.Data.Fields.Empty","items":[{"name":"Empty Default (new Group)","href":"empty-default.html","topicHref":"empty-default.html","topicUid":"Basics.Data.Fields.Empty-Default"},{"name":"Empty End (close a Group)","href":"empty-end.html","topicHref":"empty-end.html","topicUid":"Basics.Data.Fields.Empty-End"},{"name":"Empty Message","href":"empty-message.html","topicHref":"empty-message.html","topicUid":"Basics.Data.Fields.Empty-Message"}]},{"name":"Entity Fields (Relationships)","href":"entity.html","topicHref":"entity.html","topicUid":"Basics.Data.Fields.Entity","items":[{"name":"Entity Default","href":"entity-default.html","topicHref":"entity-default.html","topicUid":"Basics.Data.Fields.Entity-Default"},{"name":"Entity from Query","href":"entity-query.html","topicHref":"entity-query.html","topicUid":"Basics.Data.Fields.Entity-Query"}]},{"name":"Hyperlink Fields / Files","href":"hyperlink.html","topicHref":"hyperlink.html","topicUid":"Basics.Data.Fields.Hyperlink","items":[{"name":"Hyperlink Default (single item)","href":"hyperlink-default.html","topicHref":"hyperlink-default.html","topicUid":"Basics.Data.Fields.Hyperlink-Default"},{"name":"Hyperlink Library (file lists)","href":"hyperlink-library.html","topicHref":"hyperlink-library.html","topicUid":"Basics.Data.Fields.Hyperlink-Library"}]},{"name":"Number Fields","href":"number.html","topicHref":"number.html","topicUid":"Basics.Data.Fields.Number","items":[{"name":"Number Default","href":"number-default.html","topicHref":"number-default.html","topicUid":"Basics.Data.Fields.Number-Default"},{"name":"Number Dropdown","href":"number-dropdown.html","topicHref":"number-dropdown.html","topicUid":"Basics.Data.Fields.Number-Dropdown"}]},{"name":"String / Text / WYSIWYG Fields","href":"string.html","topicHref":"string.html","topicUid":"Basics.Data.Fields.String","items":[{"name":"String Default","href":"string-default.html","topicHref":"string-default.html","topicUid":"Basics.Data.Fields.String-Default"},{"name":"String Dropdown","href":"string-dropdown.html","topicHref":"string-dropdown.html","topicUid":"Basics.Data.Fields.String-Dropdown"},{"name":"String Dropdown Query","href":"string-dropdown-query.html","topicHref":"string-dropdown-query.html","topicUid":"Basics.Data.Fields.String-Dropdown-Query"},{"name":"String WYSIWYG ✨","href":"string-wysiwyg/index.html","topicHref":"string-wysiwyg/index.html","topicUid":"Basics.Data.Fields.String-Wysiwyg"},{"name":"String WYSIWYG Rich ✨","href":"string-wysiwyg/rich.html","topicHref":"string-wysiwyg/rich.html","topicUid":"Basics.Data.Fields.String-Wysiwyg-Rich"},{"name":"String Font Icon Picker","href":"string-font-icon-picker.html","topicHref":"string-font-icon-picker.html","topicUid":"Basics.Data.Fields.String-Font-Icon-Picker"},{"name":"String Url Path","href":"string-url-path.html","topicHref":"string-url-path.html","topicUid":"Basics.Data.Fields.String-Url-Path"}]},{"name":"Ephemeral / Temporary Fields","href":"ephemeral.html","topicHref":"ephemeral.html","topicUid":"Basics.Data.Fields.Ephemeral"},{"name":"Pickers (BETA v18 🌟)","href":"pickers/index.html","topicHref":"pickers/index.html","topicUid":"Basics.Data.Fields.Pickers.Index","items":[{"name":"Picker Sources","href":"pickers/sources/index.html","topicHref":"pickers/sources/index.html","topicUid":"Basics.Data.Fields.Pickers.Sources.Index"},{"name":"Picker Fields","href":"pickers/fields/index.html","topicHref":"pickers/fields/index.html","topicUid":"Basics.Data.Fields.Pickers.Fields.Index"},{"name":"Picker UIs","href":"pickers/ui/index.html","topicHref":"pickers/ui/index.html","topicUid":"Basics.Data.Fields.Pickers.Ui.Index"}]}]}
{"order":100,"items":[{"name":"General Field Settings","href":"all.html","topicHref":"all.html","topicUid":"Basics.Data.Fields.GeneralSettings"},{"name":"Boolean Fields","href":"boolean.html","topicHref":"boolean.html","topicUid":"Basics.Data.Fields.Boolean","items":[{"name":"Boolean Default","href":"boolean-default.html","topicHref":"boolean-default.html","topicUid":"Basics.Data.Fields.Boolean-Default"},{"name":"Boolean Tristate","href":"boolean-tristate.html","topicHref":"boolean-tristate.html","topicUid":"Basics.Data.Fields.Boolean-Tristate"}]},{"name":"Date/Time Fields","href":"datetime.html","topicHref":"datetime.html","topicUid":"Basics.Data.Fields.DateTime","items":[{"name":"DateTime Default","href":"datetime-default.html","topicHref":"datetime-default.html","topicUid":"Basics.Data.Fields.DateTime-Default"}]},{"name":"Custom Fields / GPS","href":"custom.html","topicHref":"custom.html","topicUid":"Basics.Data.Fields.Custom","items":[{"name":"Custom GPS","href":"custom-gps.html","topicHref":"custom-gps.html","topicUid":"Basics.Data.Fields.CustomGps"}]},{"name":"Empty Fields (Groups)","href":"empty.html","topicHref":"empty.html","topicUid":"Basics.Data.Fields.Empty","items":[{"name":"Empty Default (new Group)","href":"empty-default.html","topicHref":"empty-default.html","topicUid":"Basics.Data.Fields.Empty-Default"},{"name":"Empty End (close a Group)","href":"empty-end.html","topicHref":"empty-end.html","topicUid":"Basics.Data.Fields.Empty-End"},{"name":"Empty Message","href":"empty-message.html","topicHref":"empty-message.html","topicUid":"Basics.Data.Fields.Empty-Message"}]},{"name":"Entity Fields (Relationships)","href":"entity.html","topicHref":"entity.html","topicUid":"Basics.Data.Fields.Entity","items":[{"name":"Entity Default","href":"entity-default.html","topicHref":"entity-default.html","topicUid":"Basics.Data.Fields.Entity-Default"},{"name":"Entity from Query","href":"entity-query.html","topicHref":"entity-query.html","topicUid":"Basics.Data.Fields.Entity-Query"}]},{"name":"Hyperlink Fields / Files","href":"hyperlink.html","topicHref":"hyperlink.html","topicUid":"Basics.Data.Fields.Hyperlink","items":[{"name":"Hyperlink Default (single item)","href":"hyperlink-default.html","topicHref":"hyperlink-default.html","topicUid":"Basics.Data.Fields.Hyperlink-Default"},{"name":"Hyperlink Library (file lists)","href":"hyperlink-library.html","topicHref":"hyperlink-library.html","topicUid":"Basics.Data.Fields.Hyperlink-Library"}]},{"name":"Number Fields","href":"number.html","topicHref":"number.html","topicUid":"Basics.Data.Fields.Number","items":[{"name":"Number Default","href":"number-default.html","topicHref":"number-default.html","topicUid":"Basics.Data.Fields.Number-Default"},{"name":"Number Dropdown","href":"number-dropdown.html","topicHref":"number-dropdown.html","topicUid":"Basics.Data.Fields.Number-Dropdown"}]},{"name":"String / Text / WYSIWYG Fields","href":"string.html","topicHref":"string.html","topicUid":"Basics.Data.Fields.String","items":[{"name":"String Default","href":"string-default.html","topicHref":"string-default.html","topicUid":"Basics.Data.Fields.String-Default"},{"name":"String Dropdown","href":"string-dropdown.html","topicHref":"string-dropdown.html","topicUid":"Basics.Data.Fields.String-Dropdown"},{"name":"String Dropdown Query","href":"string-dropdown-query.html","topicHref":"string-dropdown-query.html","topicUid":"Basics.Data.Fields.String-Dropdown-Query"},{"name":"String WYSIWYG ✨","href":"string-wysiwyg/index.html","topicHref":"string-wysiwyg/index.html","topicUid":"Basics.Data.Fields.String-Wysiwyg"},{"name":"String WYSIWYG Rich ✨","href":"string-wysiwyg/rich.html","topicHref":"string-wysiwyg/rich.html","topicUid":"Basics.Data.Fields.String-Wysiwyg-Rich"},{"name":"String Font Icon Picker","href":"string-font-icon-picker.html","topicHref":"string-font-icon-picker.html","topicUid":"Basics.Data.Fields.String-Font-Icon-Picker"},{"name":"String Url Path","href":"string-url-path.html","topicHref":"string-url-path.html","topicUid":"Basics.Data.Fields.String-Url-Path"}]},{"name":"Ephemeral / Temporary Fields","href":"ephemeral.html","topicHref":"ephemeral.html","topicUid":"Basics.Data.Fields.Ephemeral"},{"name":"Pickers (BETA v18 🌟)","href":"pickers/index.html","topicHref":"pickers/index.html","topicUid":"Basics.Data.Fields.Pickers.Index","items":[{"name":"Picker Sources","href":"pickers/sources/index.html","topicHref":"pickers/sources/index.html","topicUid":"Basics.Data.Fields.Pickers.Sources.Index"},{"name":"Picker Fields","href":"pickers/fields/index.html","topicHref":"pickers/fields/index.html","topicUid":"Basics.Data.Fields.Pickers.Fields.Index"},{"name":"Picker UIs","href":"pickers/ui/index.html","topicHref":"pickers/ui/index.html","topicUid":"Basics.Data.Fields.Pickers.Ui.Index"},{"name":"Picker Formulas","href":"pickers/formulas/index.html","topicHref":"pickers/formulas/index.html","topicUid":"Basics.Data.Fields.Pickers.Formulas.Index"}]}]}
3 changes: 3 additions & 0 deletions docs/basics/data/toc.html
Original file line number Diff line number Diff line change
Expand Up @@ -194,6 +194,9 @@
<li>
<a href="fields/pickers/ui/index.html" name="" title="Picker UIs">Picker UIs</a>
</li>
<li>
<a href="fields/pickers/formulas/index.html" name="" title="Picker Formulas">Picker Formulas</a>
</li>
</ul>
</li>
</ul>
Expand Down
Loading

0 comments on commit 24c6dfd

Please sign in to comment.