select2/docs

DEPRECATED - Now located in docs directory of main repository

select2.org

https://select2.org

This is the repository for the documentation for Select2. It is built with the flat-file CMS Grav, using their RTFM skeleton.

Local installation

Step 1 - Install Grav

This application uses the Grav CMS. This repository does not contain a full Grav installation - rather, it just contains the contents of Grav's user directory, which is where all of our content, themes, and assets live. This was done as per the recommendation on Grav's blog, to make it easier to deploy changes to the live server.

To install this website on your computer, first install grav core in a project folder called select2-docs under your webserver's document root folder. Then, find the user folder inside of your project folder. Delete the contents of the user folder and clone this repository directly into the user folder.

When you're done it might look something like this:

htdocs/
└── select2-docs/
   ├── assets/
   ├── ...
   ├── user/
       ├── .git
       ├── accounts/
       ├── assets/
       ├── config/
       └── ...
   └── ...

Step 2

Grav needs your webserver to be able to write to certain directories. In OSX with XAMPP installed, this won't work by default. To deal with this:

Add default webserver user daemon to OSX's staff group (which already has the necessary permissions for writing to files/directories):

sudo dseditgroup -o edit -a daemon -t user staff

Step 3

Visit the local installation in your browser! For example, http://localhost/select2-docs.

Credits

Favicons were generated with https://realfavicongenerator.net/

docs's Issues

Set Multiple selected values , but only one are selected .

open page https://select2.org/getting-started/basic-usage
and execute script in console:
$('.js-example-basic-multiple').select2('val', ["HI", "CA"])

It doesnot work. Only one are selected .

https://select2.org/getting-started/basic-usage

bind multiple selected option in edit screen in ajax(remotedata) option

How to bind multiple option as a selected in latest version of select2 , i don't find any example for that, can you give me any .

I have use a ajax(remotedata) option for bind value in dropdown.

Wrong link in section Preventing Events

I think there is a wrong link to a stackexchange post in the section Preventing Events, it currently points to this answer,

https://stackoverflow.com/a/26706695/2970321

however, I believe it should point to the next answer,

https://stackoverflow.com/questions/26705098/jquery-select2-prevent-selecting-in-ajax-response/26706695#36091321

Is options document correct?

I've implemented as same as the following page when I make option group.
https://select2.org/options

But the following error happen.
Uncaught TypeError: Illegal constructor" in jquery.js:1:3233

Then I implemented as like as the following page.
https://select2.org/data-sources/formats
There is no problem.

Do we need "element": HTMLOptionElement and "element": HTMLOptGroupElement???
If don't need these options, can I modify this page?
https://select2.org/options

Add TOC for subsections to each chapter page

https://github.com/select2/docs/blob/develop/pages/12.programmatic-control/chapter.md

Example Page

i really miss the awesome example page from the old webpage. seeing everything on one page was a really great way to show select2 to another person and also was a very good quick reference.

could you re-add such an awesome example page again? the equivalent now would be the appearance page. do is see this correct?

Instructions for usage with Webpack

Migrating in from select2/select2#5372

Select2 doesn't work out of the box with Webpack and additional steps are needed. The linked ticket has some suggestions.

This ticket should come up with the minimum steps needed to make Select2 compatible and then document them.

When I add a new configuration item “tags : true”...

In this input,I want to add a new item. e.g. "美食"，While I was typing for “meishi”, new tag “memeimeismeishmeishi美食” is created！https://select2.org/tagging

Setting multiple values does not work as described in documentation

I use version 4.0.5.

Page: https://github.com/select2/docs/blob/develop/pages/12.programmatic-control/01.add-select-clear-items/docs.md

It says, which does not work:

$('#mySelect2').val(['1',` '2']);
$('#mySelect2').trigger('change'); // Notify any JS components that the value changed

The following works:

      $('#mySelect2').select2('val', ['1', '2']);

How can I use this select2 package in electron app html?

I've tried using cdn links, downloaded manually and tried to apply .select2() functionality. Still getting Uncaught TypeError: $(...).select2 is not a function

Can you please eloberate the usage?
Thanks in advance

Select2 single select inside modal in safari does not work

Select2 single select dropdown does not work inside modal in Safari. Clicking on the selection does not show the selection in the display.