Deployed f0c7229 with MkDocs version: 1.5.3

col-refs/index.html

@@ -365,6 +365,11 @@
                 Understanding reference columns
               </a>
             </li>
+            <li class="wm-toc-li">
+              <a class="wm-article-link wm-page-toc-text" href="#filtering-reference-choices-in-dropdown">
+                Filtering Reference choices in dropdown
+              </a>
+            </li>
 
       </ul>
     </li>
@@ -1186,6 +1191,21 @@ <h2 id="understanding-reference-columns">Understanding reference columns<a class
 <p><em><img alt="columns-reference-explanation-rowid" src="../images/columns/columns-reference-explanation-rowid.png" /></em></p>
 <p>We can see that the value in the Full Name column for the record with Row ID =<code>2</code> is <code>Dowbakin, Daniella</code>. If we revert back to our original settings for the Instructor column of the Classes table, where <code>Full Name</code> was selected under Show Column, we see that the Full Name value associated with <code>Staff[2]</code> is <code>Dowbakin, Daniella</code>.</p>
 <p><em><img alt="columns-reference-explanation-fullname" src="../images/columns/columns-reference-explanation-fullname.png" /></em></p>
+<h2 id="filtering-reference-choices-in-dropdown">Filtering Reference choices in dropdown<a class="headerlink" href="#filtering-reference-choices-in-dropdown" title="Permanent link">#</a></h2>
+<p>When entering data into a reference column you will see a dropdown list of all available values to choose from. Sometimes the list can get long, and in some cases confusing. For example, say you’re tracking population changes in the 1,000 most populous world cities. When entering a city into the reference column for city selection, the dropdown lists all 1,000 cities. </p>
+<p class="screenshot-half"><em><img alt="Unfiltered reference dropdown list" src="/images/filter-reference-columns/unfiltered-cities.png" /></em></p>
+<p>It would be useful if the dropdown list of city choices were filtered based on the country selected in the <code>Country</code> column.</p>
+<p>To filter a reference column’s dropdown list, select the reference column then set a “Dropdown Condition“ in the Creator Panel under the &ldquo;Column&rdquo; tab. </p>
+<p class="screenshot-half"><em><img alt="Set dropdown condition" src="/images/filter-reference-columns/set-dropdown-condition.png" /></em></p>
+<p>You can filter a dropdown’s choice by writing a condition as a formula. The attribute <code>choice</code> refers to choices in the dropdown. In this case the formula is <code>choice.Country == $Country</code>. </p>
+<p class="screenshot-half"><em><img alt="Reference dropdown filter condition" src="/images/filter-reference-columns/city-filter-condition.png" /></em></p>
+<p class="screenshot-half"><em><img alt="Filtered reference dropdown list" src="/images/filter-reference-columns/filtered-cities.png" /></em></p>
+<p>Why did that work? The city column is a reference column pointing to a <code>Cities</code> table that matches countries and cities. That table looks like this.</p>
+<p class="screenshot-half"><em><img alt="Cities reference table" src="/images/filter-reference-columns/cities-tables.png" /></em></p>
+<p>The formula condition <code>choice.Country == $Country</code> is looking up each choice’s country in the <code>Cities</code> table using a <a href="https://support.getgrist.com/references-lookups/#reference-columns-and-dot-notation">reference lookup</a>, then it compares those countries to the value entered in the <code>Country</code> column of the <code>Population Rankings</code> table. </p>
+<p class="screenshot-half"><em><img alt="Filtered reference dropdown list" src="/images/filter-reference-columns/filtered-cities-highlight.png" /></em></p>
+<p>The dropdown now lists only choices (aka cities) whose country equals the country entered in <code>Country</code> column. </p>
+<p>Note that because reference dropdown filtering is written as formulas, filtering can be very flexible and granular. Users experienced with <a href="https://support.getgrist.com/access-rules/">access rules</a> may notice similarities in how to think about writing these formulas.</p>
 
   <br>
 </div>

fr/col-refs/index.html

@@ -365,6 +365,11 @@
                 Understanding reference columns
               </a>
             </li>
+            <li class="wm-toc-li">
+              <a class="wm-article-link wm-page-toc-text" href="#filtering-reference-choices-in-dropdown">
+                Filtering Reference choices in dropdown
+              </a>
+            </li>
 
       </ul>
     </li>
@@ -1055,6 +1060,21 @@ <h2 id="understanding-reference-columns">Understanding reference columns<a class
 <p><em><img alt="columns-reference-explanation-rowid" src="../images/columns/columns-reference-explanation-rowid.png" /></em></p>
 <p>We can see that the value in the Full Name column for the record with Row ID =<code>2</code> is <code>Dowbakin, Daniella</code>. If we revert back to our original settings for the Instructor column of the Classes table, where <code>Full Name</code> was selected under Show Column, we see that the Full Name value associated with <code>Staff[2]</code> is <code>Dowbakin, Daniella</code>.</p>
 <p><em><img alt="columns-reference-explanation-fullname" src="../images/columns/columns-reference-explanation-fullname.png" /></em></p>
+<h2 id="filtering-reference-choices-in-dropdown">Filtering Reference choices in dropdown<a class="headerlink" href="#filtering-reference-choices-in-dropdown" title="Permanent link">#</a></h2>
+<p>When entering data into a reference column you will see a dropdown list of all available values to choose from. Sometimes the list can get long, and in some cases confusing. For example, say you’re tracking population changes in the 1,000 most populous world cities. When entering a city into the reference column for city selection, the dropdown lists all 1,000 cities. </p>
+<p class="screenshot-half"><em><img alt="Unfiltered reference dropdown list" src="/images/filter-reference-columns/unfiltered-cities.png" /></em></p>
+<p>It would be useful if the dropdown list of city choices were filtered based on the country selected in the <code>Country</code> column.</p>
+<p>To filter a reference column’s dropdown list, select the reference column then set a “Dropdown Condition“ in the Creator Panel under the &ldquo;Column&rdquo; tab. </p>
+<p class="screenshot-half"><em><img alt="Set dropdown condition" src="/images/filter-reference-columns/set-dropdown-condition.png" /></em></p>
+<p>You can filter a dropdown’s choice by writing a condition as a formula. The attribute <code>choice</code> refers to choices in the dropdown. In this case the formula is <code>choice.Country == $Country</code>. </p>
+<p class="screenshot-half"><em><img alt="Reference dropdown filter condition" src="/images/filter-reference-columns/city-filter-condition.png" /></em></p>
+<p class="screenshot-half"><em><img alt="Filtered reference dropdown list" src="/images/filter-reference-columns/filtered-cities.png" /></em></p>
+<p>Why did that work? The city column is a reference column pointing to a <code>Cities</code> table that matches countries and cities. That table looks like this.</p>
+<p class="screenshot-half"><em><img alt="Cities reference table" src="/images/filter-reference-columns/cities-tables.png" /></em></p>
+<p>The formula condition <code>choice.Country == $Country</code> is looking up each choice’s country in the <code>Cities</code> table using a <a href="https://support.getgrist.com/references-lookups/#reference-columns-and-dot-notation">reference lookup</a>, then it compares those countries to the value entered in the <code>Country</code> column of the <code>Population Rankings</code> table. </p>
+<p class="screenshot-half"><em><img alt="Filtered reference dropdown list" src="/images/filter-reference-columns/filtered-cities-highlight.png" /></em></p>
+<p>The dropdown now lists only choices (aka cities) whose country equals the country entered in <code>Country</code> column. </p>
+<p>Note that because reference dropdown filtering is written as formulas, filtering can be very flexible and granular. Users experienced with <a href="https://support.getgrist.com/access-rules/">access rules</a> may notice similarities in how to think about writing these formulas.</p>
 
   <br>
 </div>

fr/index.html

@@ -1053,5 +1053,5 @@ <h2 id="contact-us">Contact us<a class="headerlink" href="#contact-us" title="Pe
 </html>
 <!--
 MkDocs version : 1.5.3
-Build Date UTC : 2024-04-18 13:26:43.232582+00:00
+Build Date UTC : 2024-04-26 22:21:23.750802+00:00
 -->