locomotivecms 3.1.2 → 3.2.0.rc1

data/vendor/assets/components/locomotive_sources/select2/docs/_includes/options-old/dropdown.html

@@ -0,0 +1,308 @@
+<section>
+  <div class="page-header">
+    <h1 id="dropdown">Dropdown</h1>
+  </div>
+
+  <p>
+    Select2 allows you to change the way that the dropdown works, allowing you
+    to do anything from attach it to a different location in the document or
+    add a search box.
+  </p>
+
+  <h2 id="dropdownParent">
+    Attached to body
+  </h2>
+
+  <p>
+    By default, Select2 will attach the dropdown to the end of the body and
+    will absolutely position it to appear below the selection container.
+  </p>
+
+  <div class="row">
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Key</dt>
+        <dd><code>dropdownParent</code></dd>
+
+        <dt>Value</dt>
+        <dd>jQuery element or DOM node</dd>
+
+        <hr />
+
+        <dt>Adapter</dt>
+        <dd>
+          <code title="select2/dropdown">DropdownAdapter</code>
+        </dd>
+
+        <dt>Decorator</dt>
+        <dd>
+          <code title="select2/dropdown/attachBody">AttachBody</code>
+        </dd>
+      </dl>
+    </div>
+
+    <div class="col-sm-6">
+      <div class="alert alert-warning">
+        <strong>Heads up!</strong>
+        This will cause DOM events to be raised outside of the standard
+        Select2 DOM container. This can cause issues with
+        third-party components such as modals.
+      </div>
+    </div>
+  </div>
+
+  <p>
+    When the dropdown is attached to the body, you are not limited to just
+    displaying the dropdown below the container. Select2 will display above
+    the container if there is not enough space below the container, but there
+    is enough space above it. You are also not limited to displaying the
+    dropdown within the parent container, which means Select2 will render
+    correctly inside of modals and other small containers.
+  </p>
+
+  <h2 id="dropdown-attachContainer">
+    Attached below the container
+  </h2>
+
+  <p>
+    Select2 can place the dropdown directly after the selection container, so
+    it will appear in the same location within the DOM as the rest of Select2.
+  </p>
+
+  <div class="row">
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Adapter</dt>
+        <dd>
+          <code title="select2/dropdown">DropdownAdapter</code>
+        </dd>
+
+        <dt>Decorator</dt>
+        <dd>
+          <code title="select2/dropdown/attachContainer">AttachContainer</code>
+        </dd>
+      </dl>
+    </div>
+
+    <div class="col-sm-6">
+      <div class="alert alert-warning">
+        <strong>Check your build.</strong> This module is only included in the
+        <a href="index.html#builds-full" class="alert-link">full builds</a> of
+        Select2.
+      </div>
+    </div>
+  </div>
+
+  <div class="alert alert-info">
+    <strong>
+      <a href="https://harvesthq.github.io/chosen/">Harvest Chosen</a>
+      migrators!
+    </strong>
+    If you are migrating to Select2 from Chosen, this option will cause
+    Select2 to position the dropdown in a similar way.
+  </div>
+
+  <h2 id="dropdown-search">
+    Search
+  </h2>
+
+  <p>
+    Users can filter down the results by typing a search term into a box that
+    is displayed at the top of the dropdown.
+  </p>
+
+  <dl class="dl-horizontal">
+    <dt>Adapter</dt>
+    <dd>
+      <code title="select2/dropdown">DropdownAdapter</code>
+    </dd>
+
+    <dt>Decorator</dt>
+    <dd>
+      <code title="select2/dropdown/search">DropdownSearch</code>
+    </dd>
+  </dl>
+
+  <p>
+    A search box is added to the top of the dropdown automatically for select
+    boxes where only a single option can be selected.
+  </p>
+
+  <h3 id="dropdown-minimumInputLength">
+    Minimum search term length to filter results
+  </h3>
+
+  <p>
+    Sometimes when working with large data sets, it is more efficient to start
+    filtering the results when the search term is a certain length. This is
+    very common when working with remote data sets, as allows for only
+    significant search terms to be used.
+  </p>
+
+  <div class="row">
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Key</dt>
+        <dd><code>minimumInputLength</code></dd>
+
+        <dt>Value</dt>
+        <dd>integer</dd>
+      </dl>
+    </div>
+
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Adapter</dt>
+        <dd>
+          <code title="select2/data/base">DataAdapter</code>
+        </dd>
+
+        <dt>Decorator</dt>
+        <dd>
+          <code title="select2/data/minimumInputLength">MinimumInputLength</code>
+        </dd>
+      </dl>
+    </div>
+  </div>
+
+  <h3 id="dropdown-maximumInputLength">
+    Maximum search term length to filter results
+  </h3>
+
+  <p>
+    In some cases, search terms need to be limited to a certain range. Select2
+    allows you to limit the length of the search term such that it does not
+    exceed a certain length.
+  </p>
+
+  <div class="row">
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Key</dt>
+        <dd><code>maximumInputLength</code></dd>
+
+        <dt>Value</dt>
+        <dd>integer</dd>
+      </dl>
+    </div>
+
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Adapter</dt>
+        <dd>
+          <code title="select2/data/base">DataAdapter</code>
+        </dd>
+
+        <dt>Decorator</dt>
+        <dd>
+          <code title="select2/data/maximumInputLength">MaximumInputLength</code>
+        </dd>
+      </dl>
+    </div>
+  </div>
+
+  <h3 id="dropdown-maximumInputLength">
+    Minimum results to display the search box
+  </h3>
+
+  <p>
+    When working with smaller data sets, the search box can take up more space
+    that is necessary, as there are not enough results for filtering to be
+    effective. Select2 allows you to only display the search box when the
+    number of search results reaches a certain threshold.
+  </p>
+
+  <div class="row">
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Key</dt>
+        <dd><code>minimumResultsForSearch</code></dd>
+
+        <dt>Value</dt>
+        <dd>integer</dd>
+      </dl>
+    </div>
+
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Adapter</dt>
+        <dd>
+          <code title="select2/dropdown">DropdownAdapter</code>
+        </dd>
+
+        <dt>Decorator</dt>
+        <dd>
+          <code title="select2/dropdown/minimumResultsForSearch">MinimumResultsForSearch</code>
+        </dd>
+      </dl>
+    </div>
+  </div>
+
+  <h2 id="dropdown-select-on-close">
+    Select the highlighted option on close
+  </h2>
+
+  <p>
+    When users close the dropdown, the last highlighted option can be
+    automatically selected. This is commonly used in combination with
+    <a href="#tags">tagging</a> and <a href="#placeholder">placeholders</a>
+    and other situations where the user is required to select an option, or
+    they need to be able to quickly select multiple options.
+  </p>
+
+  <dl class="dl-horizontal">
+    <dt>Adapter</dt>
+    <dd>
+      <code title="select2/results">ResultsAdapter</code>
+    </dd>
+
+    <dt>Decorator</dt>
+    <dd>
+      <code title="select2/dropdown/selectOnClose">SelectOnClose</code>
+    </dd>
+  </dl>
+
+  <h2 id="closeOnSelect">
+    Close the dropdown when a result is selected
+  </h2>
+
+  <p>
+    Select2 will automatically close the dropdown when an element is selected,
+    similar to what is done with a normal select box.  This behavior can be
+    changed though to keep the dropdown open when results are selected,
+    allowing for multiple options to be selected quickly.
+  </p>
+
+  <div class="row">
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Key</dt>
+        <dd><code>closeOnSelect</code></dd>
+
+        <dt>Default</dt>
+        <dd><code>true</code></dd>
+      </dl>
+    </div>
+
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Adapter</dt>
+        <dd>
+          <code title="select2/dropdown">DropdownAdapter</code>
+        </dd>
+
+        <dt>Decorator</dt>
+        <dd>
+          <code title="select2/dropdown/closeOnSelect">CloseOnSelect</code>
+        </dd>
+      </dl>
+    </div>
+  </div>
+
+  <p>
+    If this decorator is not used (or <code>closeOnSelect</code> is set to
+    <code>false</code>), the dropdown will not automatically close when a
+    result is selected.  The dropdown will also never close if the
+    <kbd>ctrl</kbd> key is held down when the result is selected.
+  </p>
+</section>

data/vendor/assets/components/locomotive_sources/select2/docs/_includes/options-old/events.html

@@ -0,0 +1,50 @@
+<section>
+  <div id="events" class="page-header">
+    <h1>Events</h1>
+  </div>
+
+  <p>
+    Select2 has an internal event system that is used to notify parts of the
+    component that state has changed, as well as an adapter that allows some
+    of these events to be relayed to the outside word.
+  </p>
+
+  <dl class="dl-horizontal">
+    <dt>Adapter</dt>
+    <dd>
+      <code title="select2/selection">SelectionAdapter</code>
+    </dd>
+
+    <dt>Decorator</dt>
+    <dd>
+      <code title="select2/selection/eventRelay">EventRelay</code>
+    </dd>
+  </dl>
+
+  <h2 id="events-public">
+    Public events
+  </h2>
+
+  <p>
+    All public events are relayed using the jQuery event system, and they are
+    triggered on the <code>&lt;select&gt;</code> element that Select2 is
+    attached to. You can attach to them using the
+    <a href="https://api.jquery.com/on/"><code>.on</code> method</a> provided
+    by jQuery.
+  </p>
+
+  <h2 id="events-internal">
+    Internal events
+  </h2>
+
+  <p>
+    Select2 triggers internal events using its own internal event system,
+    which allows adapters to communicate with each other. These events are not
+    accessible through the jQuery event system.
+  </p>
+
+  <p>
+    You can find more information on the public events triggered by individual
+    adapters in <a href="#adapters">the individual adapter documentation</a>.
+  </p>
+</section>

data/vendor/assets/components/locomotive_sources/select2/docs/_includes/options-old/setting-default-options.html

@@ -0,0 +1,37 @@
+<section>
+  <h1 id="setting-default-options">Setting default options</h1>
+
+  <p>
+    In some cases, you need to set the default options for all instances of
+    Select2 in your web application. This is especially useful when you are
+    migrating from past versions of Select2, or you are using non-standard
+    options <a href="#amd">like custom AMD builds</a>. Select2 exposes the
+    default options through <code>$.fn.select2.defaults</code>, which allows
+    you to set them globally.
+  </p>
+
+  <p>
+    When setting options globally, any past defaults that have been set will
+    be overriden. Default options are only used when an option is requested
+    that has not been set during initialization.
+  </p>
+
+  <p>
+    <strong>You can set default options</strong> by calling
+    <code>$.fn.select2.defaults.set("key", "value")</code>. The key that is
+    set should take the same format as keys set using
+    <a href="#data-attributes">HTML <code>data-*</code> attributes</a> which
+    means that two dashes (<code>--</code>) will be replaced by a level of
+    nesting, and a single dash (<code>-</code>) will convert it to a camelCase
+    string.
+  </p>
+
+<pre class="prettyprint">
+$.fn.select2.defaults.set("theme", "classic");
+</pre>
+
+  <p>
+    <strong>You can reset the default options</strong> by calling
+    <code>$.fn.select2.defaults.reset()</code>.
+  </p>
+</section>

data/vendor/assets/components/locomotive_sources/select2/docs/_includes/options/compatibility.html

@@ -0,0 +1,10 @@
+<section>
+  <h1>
+    Backwards compatibility
+  </h1>
+
+  {% include options/compatibility/matcher.html %}
+  {% include options/compatibility/initial-selection.html %}
+  {% include options/compatibility/query-function.html %}
+  {% include options/compatibility/text-input.html %}
+</section>

data/vendor/assets/components/locomotive_sources/select2/docs/_includes/options/compatibility/initial-selection.html

@@ -0,0 +1,50 @@
+<section>
+  <h2 id="initSelection">
+    Old initial selections with <code>initSelection</code>
+  </h2>
+
+  <p class="alert alert-warning">
+    <a href="announcements-4.0.html#removed-initselection" class="alert-link">Deprecated in Select2 4.0.</a>
+    This has been replaced by another option and is only available in the
+    <a href="index.html#builds-full" class="alert-link">full builds</a> of
+    Select2.
+  </p>
+
+  <p>
+    In the past, Select2 required an option called <code>initSelection</code>
+    that was defined whenever a custom data source was being used, allowing
+    for the initial selection for the component to be determined. This has
+    been replaced by the <code>current</code> method on the
+    <a href="#dataAdapter">data adapter</a>.
+  </p>
+
+  <div class="row">
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Key</dt>
+        <dd>
+          <code>initSelection</code>
+        </dd>
+
+        <dt>Value</dt>
+        <dd>
+          A function taking a <code>callback</code>
+        </dd>
+      </dl>
+    </div>
+
+    <div class="col-sm-6">
+      <dl class="dl-horizontal">
+        <dt>Adapter</dt>
+        <dd>
+          <code title="select2/data/base">DataAdapter</code>
+        </dd>
+
+        <dt>Decorator</dt>
+        <dd>
+          <code title="select2/compat/initSelection">InitSelection</code>
+        </dd>
+      </dl>
+    </div>
+  </div>
+</section>