`.
+* [#9531](http://dev.ckeditor.com/ticket/9531): [Firefox & Inline editor] Toolbar is lost when closing the Format drop-down list by clicking its button.
+* [#9553](http://dev.ckeditor.com/ticket/9553): Table width incorrectly set when the `border-width` style is specified.
+* [#9594](http://dev.ckeditor.com/ticket/9594): Cannot tab past CKEditor when it is in read-only mode.
+* [#9658](http://dev.ckeditor.com/ticket/9658): [IE9] Justify not working on selected images.
+* [#9686](http://dev.ckeditor.com/ticket/9686): Added missing contents styles for `
` elements.
+* [#9709](http://dev.ckeditor.com/ticket/9709): [Paste from Word](http://ckeditor.com/addon/pastefromword) should not depend on configuration from other styles.
+* [#9726](http://dev.ckeditor.com/ticket/9726): Removed [Color Dialog](http://ckeditor.com/addon/colordialog) plugin dependency from [Table Tools](http://ckeditor.com/addon/tabletools).
+* [#9765](http://dev.ckeditor.com/ticket/9765): Toolbar Collapse command documented incorrectly in the [Accessibility Instructions](http://ckeditor.com/addon/a11yhelp) dialog window.
+* [#9771](http://dev.ckeditor.com/ticket/9771): [WebKit & Opera] Fixed scrolling issues when pasting.
+* [#9787](http://dev.ckeditor.com/ticket/9787): [IE9] `onChange` is not fired for checkboxes in dialogs.
+* [#9842](http://dev.ckeditor.com/ticket/9842): [Firefox 17] When opening a toolbar menu for the first time and pressing the *Down Arrow* key, focus goes to the next toolbar button instead of the menu options.
+* [#9847](http://dev.ckeditor.com/ticket/9847): [Elements Path](http://ckeditor.com/addon/elementspath) should not be initialized in the inline editor.
+* [#9853](http://dev.ckeditor.com/ticket/9853): [`editor.addRemoveFormatFilter()`](http://docs.ckeditor.com/#!/api/CKEDITOR.editor-method-addRemoveFormatFilter) is exposed before it really works.
+* [#8893](http://dev.ckeditor.com/ticket/8893): Value of the [`pasteFromWordCleanupFile`](http://docs.ckeditor.com/#!/api/CKEDITOR.config-cfg-pasteFromWordCleanupFile) configuration option is now taken from the instance configuration.
+* [#9693](http://dev.ckeditor.com/ticket/9693): Removed "Live Preview" checkbox from UI color picker.
+
+
+## CKEditor 4.0
+
+The first stable release of the new CKEditor 4 code line.
+
+The CKEditor JavaScript API has been kept compatible with CKEditor 4, whenever
+possible. The list of relevant changes can be found in the [API Changes page of
+the CKEditor 4 documentation][1].
+
+[1]: http://docs.ckeditor.com/#!/guide/dev_api_changes "API Changes"
diff --git a/htdocs/includes/ckeditor/_source/LICENSE.md b/htdocs/includes/ckeditor/_source/LICENSE.md
new file mode 100644
index 00000000000..afc4a3cdf3b
--- /dev/null
+++ b/htdocs/includes/ckeditor/_source/LICENSE.md
@@ -0,0 +1,1274 @@
+Software License Agreement
+==========================
+
+CKEditor - The text editor for Internet - http://ckeditor.com
+Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+
+Licensed under the terms of any of the following licenses at your
+choice:
+
+ - GNU General Public License Version 2 or later (the "GPL")
+ http://www.gnu.org/licenses/gpl.html
+ (See Appendix A)
+
+ - GNU Lesser General Public License Version 2.1 or later (the "LGPL")
+ http://www.gnu.org/licenses/lgpl.html
+ (See Appendix B)
+
+ - Mozilla Public License Version 1.1 or later (the "MPL")
+ http://www.mozilla.org/MPL/MPL-1.1.html
+ (See Appendix C)
+
+You are not required to, but if you want to explicitly declare the
+license you have chosen to be bound to when using, reproducing,
+modifying and distributing this software, just include a text file
+titled "legal.txt" in your version of this software, indicating your
+license choice. In any case, your choice will not restrict any
+recipient of your version of this software to use, reproduce, modify
+and distribute this software under any of the above licenses.
+
+Sources of Intellectual Property Included in CKEditor
+-----------------------------------------------------
+
+Where not otherwise indicated, all CKEditor content is authored by
+CKSource engineers and consists of CKSource-owned intellectual
+property. In some specific instances, CKEditor will incorporate work
+done by developers outside of CKSource with their express permission.
+
+(Ignore this line: %REMOVE_START%)
+
+Software available at our repository and developer version only:
+
+JavaScript Lint: At _dev/_thirdparty/jsl can be found the executable
+files of JavaScript Lint, which are licensed under the terms of the
+Mozilla Public License Version 1.1 (http://www.mozilla.org/MPL/).
+JavaScript Lint is Copyright (c) 2006 Matthias Miller.
+
+(Ignore this line: %REMOVE_END%)
+Trademarks
+----------
+
+CKEditor is a trademark of CKSource - Frederico Knabben. All other brand
+and product names are trademarks, registered trademarks or service
+marks of their respective holders.
+
+---
+
+Appendix A: The GPL License
+---------------------------
+
+GNU GENERAL PUBLIC LICENSE
+Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software-to make sure the software is free for all its users. This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it. (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.) You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+ To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have. You must make sure that they, too, receive or can get the
+source code. And you must show them these terms so they know their
+rights.
+
+ We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+ Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software. If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+ Finally, any free program is threatened constantly by software
+patents. We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary. To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+GNU GENERAL PUBLIC LICENSE
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License. The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language. (Hereinafter, translation is included without limitation in
+the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+ 1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+ 2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) You must cause the modified files to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in
+ whole or in part contains or is derived from the Program or any
+ part thereof, to be licensed as a whole at no charge to all third
+ parties under the terms of this License.
+
+ c) If the modified program normally reads commands interactively
+ when run, you must cause it, when started running for such
+ interactive use in the most ordinary way, to print or display an
+ announcement including an appropriate copyright notice and a
+ notice that there is no warranty (or else, saying that you provide
+ a warranty) and that users may redistribute the program under
+ these conditions, and telling the user how to view a copy of this
+ License. (Exception: if the Program itself is interactive but
+ does not normally print such an announcement, your work based on
+ the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable
+ source code, which must be distributed under the terms of Sections
+ 1 and 2 above on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three
+ years, to give any third party, for a charge no more than your
+ cost of physically performing source distribution, a complete
+ machine-readable copy of the corresponding source code, to be
+ distributed under the terms of Sections 1 and 2 above on a medium
+ customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer
+ to distribute corresponding source code. (This alternative is
+ allowed only for noncommercial distribution and only if you
+ received the program in object code or executable form with such
+ an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it. For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable. However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License. Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+ 5. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Program or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+ 6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+ 7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all. For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded. In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+ 9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation. If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+ 10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission. For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this. Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+NO WARRANTY
+
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+
+Appendix B: The LGPL License
+----------------------------
+
+GNU LESSER GENERAL PUBLIC LICENSE
+Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL. It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software-to make sure the software is free for all its users.
+
+ This license, the Lesser General Public License, applies to some
+specially designated software packages-typically libraries-of the
+Free Software Foundation and other authors who decide to use it. You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+ When we speak of free software, we are referring to freedom of use,
+not price. Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+ To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights. These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+ For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you. You must make sure that they, too, receive or can get the source
+code. If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it. And you must show them these terms so they know their rights.
+
+ We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+ To protect each distributor, we want to make it very clear that
+there is no warranty for the free library. Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+ Finally, software patents pose a constant threat to the existence of
+any free program. We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder. Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+ Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License. This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License. We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+ When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library. The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom. The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+ We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License. It also provides other free software developers Less
+of an advantage over competing non-free programs. These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries. However, the Lesser license provides advantages in certain
+special circumstances.
+
+ For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard. To achieve this, non-free programs must be
+allowed to use the library. A more frequent case is that a free
+library does the same job as widely used non-free libraries. In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+ In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software. For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+ Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+ The precise terms and conditions for copying, distribution and
+modification follow. Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library". The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+GNU LESSER GENERAL PUBLIC LICENSE
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+ A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+ The "Library", below, refers to any such software library or work
+which has been distributed under these terms. A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language. (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+ "Source code" for a work means the preferred form of the work for
+making modifications to it. For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+ Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it). Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+
+ 1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+ You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+ 2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) The modified work must itself be a software library.
+
+ b) You must cause the files modified to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ c) You must cause the whole of the work to be licensed at no
+ charge to all third parties under the terms of this License.
+
+ d) If a facility in the modified Library refers to a function or a
+ table of data to be supplied by an application program that uses
+ the facility, other than as an argument passed when the facility
+ is invoked, then you must make a good faith effort to ensure that,
+ in the event an application does not supply such function or
+ table, the facility still operates, and performs whatever part of
+ its purpose remains meaningful.
+
+ (For example, a function in a library to compute square roots has
+ a purpose that is entirely well-defined independent of the
+ application. Therefore, Subsection 2d requires that any
+ application-supplied function or table used by this function must
+ be optional: if the application does not supply it, the square
+ root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library. To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License. (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.) Do not make any other change in
+these notices.
+
+ Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+ This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+ 4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+ If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library". Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+ However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library". The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+ When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library. The
+threshold for this to be true is not precisely defined by law.
+
+ If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work. (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+ Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+ 6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+ You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License. You must supply a copy of this License. If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License. Also, you must do one
+of these things:
+
+ a) Accompany the work with the complete corresponding
+ machine-readable source code for the Library including whatever
+ changes were used in the work (which must be distributed under
+ Sections 1 and 2 above); and, if the work is an executable linked
+ with the Library, with the complete machine-readable "work that
+ uses the Library", as object code and/or source code, so that the
+ user can modify the Library and then relink to produce a modified
+ executable containing the modified Library. (It is understood
+ that the user who changes the contents of definitions files in the
+ Library will not necessarily be able to recompile the application
+ to use the modified definitions.)
+
+ b) Use a suitable shared library mechanism for linking with the
+ Library. A suitable mechanism is one that (1) uses at run time a
+ copy of the library already present on the user's computer system,
+ rather than copying library functions into the executable, and (2)
+ will operate properly with a modified version of the library, if
+ the user installs one, as long as the modified version is
+ interface-compatible with the version that the work was made with.
+
+ c) Accompany the work with a written offer, valid for at
+ least three years, to give the same user the materials
+ specified in Subsection 6a, above, for a charge no more
+ than the cost of performing this distribution.
+
+ d) If distribution of the work is made by offering access to copy
+ from a designated place, offer equivalent access to copy the above
+ specified materials from the same place.
+
+ e) Verify that the user has already received a copy of these
+ materials or that you have already sent this user a copy.
+
+ For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it. However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+ It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system. Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+ 7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+ a) Accompany the combined library with a copy of the same work
+ based on the Library, uncombined with any other library
+ facilities. This must be distributed under the terms of the
+ Sections above.
+
+ b) Give prominent notice with the combined library of the fact
+ that part of it is a work based on the Library, and explaining
+ where to find the accompanying uncombined form of the same work.
+
+ 8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License. Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License. However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+ 9. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Library or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+ 10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+ 11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all. For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded. In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+ 13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation. If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+ 14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission. For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this. Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+NO WARRANTY
+
+ 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+
+Appendix C: The MPL License
+---------------------------
+
+MOZILLA PUBLIC LICENSE
+Version 1.1
+
+1. Definitions.
+
+ 1.0.1. "Commercial Use" means distribution or otherwise making the
+ Covered Code available to a third party.
+
+ 1.1. "Contributor" means each entity that creates or contributes to
+ the creation of Modifications.
+
+ 1.2. "Contributor Version" means the combination of the Original
+ Code, prior Modifications used by a Contributor, and the Modifications
+ made by that particular Contributor.
+
+ 1.3. "Covered Code" means the Original Code or Modifications or the
+ combination of the Original Code and Modifications, in each case
+ including portions thereof.
+
+ 1.4. "Electronic Distribution Mechanism" means a mechanism generally
+ accepted in the software development community for the electronic
+ transfer of data.
+
+ 1.5. "Executable" means Covered Code in any form other than Source
+ Code.
+
+ 1.6. "Initial Developer" means the individual or entity identified
+ as the Initial Developer in the Source Code notice required by Exhibit
+ A.
+
+ 1.7. "Larger Work" means a work which combines Covered Code or
+ portions thereof with code not governed by the terms of this License.
+
+ 1.8. "License" means this document.
+
+ 1.8.1. "Licensable" means having the right to grant, to the maximum
+ extent possible, whether at the time of the initial grant or
+ subsequently acquired, any and all of the rights conveyed herein.
+
+ 1.9. "Modifications" means any addition to or deletion from the
+ substance or structure of either the Original Code or any previous
+ Modifications. When Covered Code is released as a series of files, a
+ Modification is:
+ A. Any addition to or deletion from the contents of a file
+ containing Original Code or previous Modifications.
+
+ B. Any new file that contains any part of the Original Code or
+ previous Modifications.
+
+ 1.10. "Original Code" means Source Code of computer software code
+ which is described in the Source Code notice required by Exhibit A as
+ Original Code, and which, at the time of its release under this
+ License is not already Covered Code governed by this License.
+
+ 1.10.1. "Patent Claims" means any patent claim(s), now owned or
+ hereafter acquired, including without limitation, method, process,
+ and apparatus claims, in any patent Licensable by grantor.
+
+ 1.11. "Source Code" means the preferred form of the Covered Code for
+ making modifications to it, including all modules it contains, plus
+ any associated interface definition files, scripts used to control
+ compilation and installation of an Executable, or source code
+ differential comparisons against either the Original Code or another
+ well known, available Covered Code of the Contributor's choice. The
+ Source Code can be in a compressed or archival form, provided the
+ appropriate decompression or de-archiving software is widely available
+ for no charge.
+
+ 1.12. "You" (or "Your") means an individual or a legal entity
+ exercising rights under, and complying with all of the terms of, this
+ License or a future version of this License issued under Section 6.1.
+ For legal entities, "You" includes any entity which controls, is
+ controlled by, or is under common control with You. For purposes of
+ this definition, "control" means (a) the power, direct or indirect,
+ to cause the direction or management of such entity, whether by
+ contract or otherwise, or (b) ownership of more than fifty percent
+ (50%) of the outstanding shares or beneficial ownership of such
+ entity.
+
+2. Source Code License.
+
+ 2.1. The Initial Developer Grant.
+ The Initial Developer hereby grants You a world-wide, royalty-free,
+ non-exclusive license, subject to third party intellectual property
+ claims:
+ (a) under intellectual property rights (other than patent or
+ trademark) Licensable by Initial Developer to use, reproduce,
+ modify, display, perform, sublicense and distribute the Original
+ Code (or portions thereof) with or without Modifications, and/or
+ as part of a Larger Work; and
+
+ (b) under Patents Claims infringed by the making, using or
+ selling of Original Code, to make, have made, use, practice,
+ sell, and offer for sale, and/or otherwise dispose of the
+ Original Code (or portions thereof).
+
+ (c) the licenses granted in this Section 2.1(a) and (b) are
+ effective on the date Initial Developer first distributes
+ Original Code under the terms of this License.
+
+ (d) Notwithstanding Section 2.1(b) above, no patent license is
+ granted: 1) for code that You delete from the Original Code; 2)
+ separate from the Original Code; or 3) for infringements caused
+ by: i) the modification of the Original Code or ii) the
+ combination of the Original Code with other software or devices.
+
+ 2.2. Contributor Grant.
+ Subject to third party intellectual property claims, each Contributor
+ hereby grants You a world-wide, royalty-free, non-exclusive license
+
+ (a) under intellectual property rights (other than patent or
+ trademark) Licensable by Contributor, to use, reproduce, modify,
+ display, perform, sublicense and distribute the Modifications
+ created by such Contributor (or portions thereof) either on an
+ unmodified basis, with other Modifications, as Covered Code
+ and/or as part of a Larger Work; and
+
+ (b) under Patent Claims infringed by the making, using, or
+ selling of Modifications made by that Contributor either alone
+ and/or in combination with its Contributor Version (or portions
+ of such combination), to make, use, sell, offer for sale, have
+ made, and/or otherwise dispose of: 1) Modifications made by that
+ Contributor (or portions thereof); and 2) the combination of
+ Modifications made by that Contributor with its Contributor
+ Version (or portions of such combination).
+
+ (c) the licenses granted in Sections 2.2(a) and 2.2(b) are
+ effective on the date Contributor first makes Commercial Use of
+ the Covered Code.
+
+ (d) Notwithstanding Section 2.2(b) above, no patent license is
+ granted: 1) for any code that Contributor has deleted from the
+ Contributor Version; 2) separate from the Contributor Version;
+ 3) for infringements caused by: i) third party modifications of
+ Contributor Version or ii) the combination of Modifications made
+ by that Contributor with other software (except as part of the
+ Contributor Version) or other devices; or 4) under Patent Claims
+ infringed by Covered Code in the absence of Modifications made by
+ that Contributor.
+
+3. Distribution Obligations.
+
+ 3.1. Application of License.
+ The Modifications which You create or to which You contribute are
+ governed by the terms of this License, including without limitation
+ Section 2.2. The Source Code version of Covered Code may be
+ distributed only under the terms of this License or a future version
+ of this License released under Section 6.1, and You must include a
+ copy of this License with every copy of the Source Code You
+ distribute. You may not offer or impose any terms on any Source Code
+ version that alters or restricts the applicable version of this
+ License or the recipients' rights hereunder. However, You may include
+ an additional document offering the additional rights described in
+ Section 3.5.
+
+ 3.2. Availability of Source Code.
+ Any Modification which You create or to which You contribute must be
+ made available in Source Code form under the terms of this License
+ either on the same media as an Executable version or via an accepted
+ Electronic Distribution Mechanism to anyone to whom you made an
+ Executable version available; and if made available via Electronic
+ Distribution Mechanism, must remain available for at least twelve (12)
+ months after the date it initially became available, or at least six
+ (6) months after a subsequent version of that particular Modification
+ has been made available to such recipients. You are responsible for
+ ensuring that the Source Code version remains available even if the
+ Electronic Distribution Mechanism is maintained by a third party.
+
+ 3.3. Description of Modifications.
+ You must cause all Covered Code to which You contribute to contain a
+ file documenting the changes You made to create that Covered Code and
+ the date of any change. You must include a prominent statement that
+ the Modification is derived, directly or indirectly, from Original
+ Code provided by the Initial Developer and including the name of the
+ Initial Developer in (a) the Source Code, and (b) in any notice in an
+ Executable version or related documentation in which You describe the
+ origin or ownership of the Covered Code.
+
+ 3.4. Intellectual Property Matters
+ (a) Third Party Claims.
+ If Contributor has knowledge that a license under a third party's
+ intellectual property rights is required to exercise the rights
+ granted by such Contributor under Sections 2.1 or 2.2,
+ Contributor must include a text file with the Source Code
+ distribution titled "LEGAL" which describes the claim and the
+ party making the claim in sufficient detail that a recipient will
+ know whom to contact. If Contributor obtains such knowledge after
+ the Modification is made available as described in Section 3.2,
+ Contributor shall promptly modify the LEGAL file in all copies
+ Contributor makes available thereafter and shall take other steps
+ (such as notifying appropriate mailing lists or newsgroups)
+ reasonably calculated to inform those who received the Covered
+ Code that new knowledge has been obtained.
+
+ (b) Contributor APIs.
+ If Contributor's Modifications include an application programming
+ interface and Contributor has knowledge of patent licenses which
+ are reasonably necessary to implement that API, Contributor must
+ also include this information in the LEGAL file.
+
+ (c) Representations.
+ Contributor represents that, except as disclosed pursuant to
+ Section 3.4(a) above, Contributor believes that Contributor's
+ Modifications are Contributor's original creation(s) and/or
+ Contributor has sufficient rights to grant the rights conveyed by
+ this License.
+
+ 3.5. Required Notices.
+ You must duplicate the notice in Exhibit A in each file of the Source
+ Code. If it is not possible to put such notice in a particular Source
+ Code file due to its structure, then You must include such notice in a
+ location (such as a relevant directory) where a user would be likely
+ to look for such a notice. If You created one or more Modification(s)
+ You may add your name as a Contributor to the notice described in
+ Exhibit A. You must also duplicate this License in any documentation
+ for the Source Code where You describe recipients' rights or ownership
+ rights relating to Covered Code. You may choose to offer, and to
+ charge a fee for, warranty, support, indemnity or liability
+ obligations to one or more recipients of Covered Code. However, You
+ may do so only on Your own behalf, and not on behalf of the Initial
+ Developer or any Contributor. You must make it absolutely clear than
+ any such warranty, support, indemnity or liability obligation is
+ offered by You alone, and You hereby agree to indemnify the Initial
+ Developer and every Contributor for any liability incurred by the
+ Initial Developer or such Contributor as a result of warranty,
+ support, indemnity or liability terms You offer.
+
+ 3.6. Distribution of Executable Versions.
+ You may distribute Covered Code in Executable form only if the
+ requirements of Section 3.1-3.5 have been met for that Covered Code,
+ and if You include a notice stating that the Source Code version of
+ the Covered Code is available under the terms of this License,
+ including a description of how and where You have fulfilled the
+ obligations of Section 3.2. The notice must be conspicuously included
+ in any notice in an Executable version, related documentation or
+ collateral in which You describe recipients' rights relating to the
+ Covered Code. You may distribute the Executable version of Covered
+ Code or ownership rights under a license of Your choice, which may
+ contain terms different from this License, provided that You are in
+ compliance with the terms of this License and that the license for the
+ Executable version does not attempt to limit or alter the recipient's
+ rights in the Source Code version from the rights set forth in this
+ License. If You distribute the Executable version under a different
+ license You must make it absolutely clear that any terms which differ
+ from this License are offered by You alone, not by the Initial
+ Developer or any Contributor. You hereby agree to indemnify the
+ Initial Developer and every Contributor for any liability incurred by
+ the Initial Developer or such Contributor as a result of any such
+ terms You offer.
+
+ 3.7. Larger Works.
+ You may create a Larger Work by combining Covered Code with other code
+ not governed by the terms of this License and distribute the Larger
+ Work as a single product. In such a case, You must make sure the
+ requirements of this License are fulfilled for the Covered Code.
+
+4. Inability to Comply Due to Statute or Regulation.
+
+ If it is impossible for You to comply with any of the terms of this
+ License with respect to some or all of the Covered Code due to
+ statute, judicial order, or regulation then You must: (a) comply with
+ the terms of this License to the maximum extent possible; and (b)
+ describe the limitations and the code they affect. Such description
+ must be included in the LEGAL file described in Section 3.4 and must
+ be included with all distributions of the Source Code. Except to the
+ extent prohibited by statute or regulation, such description must be
+ sufficiently detailed for a recipient of ordinary skill to be able to
+ understand it.
+
+5. Application of this License.
+
+ This License applies to code to which the Initial Developer has
+ attached the notice in Exhibit A and to related Covered Code.
+
+6. Versions of the License.
+
+ 6.1. New Versions.
+ Netscape Communications Corporation ("Netscape") may publish revised
+ and/or new versions of the License from time to time. Each version
+ will be given a distinguishing version number.
+
+ 6.2. Effect of New Versions.
+ Once Covered Code has been published under a particular version of the
+ License, You may always continue to use it under the terms of that
+ version. You may also choose to use such Covered Code under the terms
+ of any subsequent version of the License published by Netscape. No one
+ other than Netscape has the right to modify the terms applicable to
+ Covered Code created under this License.
+
+ 6.3. Derivative Works.
+ If You create or use a modified version of this License (which you may
+ only do in order to apply it to code which is not already Covered Code
+ governed by this License), You must (a) rename Your license so that
+ the phrases "Mozilla", "MOZILLAPL", "MOZPL", "Netscape",
+ "MPL", "NPL" or any confusingly similar phrase do not appear in your
+ license (except to note that your license differs from this License)
+ and (b) otherwise make it clear that Your version of the license
+ contains terms which differ from the Mozilla Public License and
+ Netscape Public License. (Filling in the name of the Initial
+ Developer, Original Code or Contributor in the notice described in
+ Exhibit A shall not of themselves be deemed to be modifications of
+ this License.)
+
+7. DISCLAIMER OF WARRANTY.
+
+ COVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN "AS IS" BASIS,
+ WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ WITHOUT LIMITATION, WARRANTIES THAT THE COVERED CODE IS FREE OF
+ DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING.
+ THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE COVERED CODE
+ IS WITH YOU. SHOULD ANY COVERED CODE PROVE DEFECTIVE IN ANY RESPECT,
+ YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR) ASSUME THE
+ COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+ OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF
+ ANY COVERED CODE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER.
+
+8. TERMINATION.
+
+ 8.1. This License and the rights granted hereunder will terminate
+ automatically if You fail to comply with terms herein and fail to cure
+ such breach within 30 days of becoming aware of the breach. All
+ sublicenses to the Covered Code which are properly granted shall
+ survive any termination of this License. Provisions which, by their
+ nature, must remain in effect beyond the termination of this License
+ shall survive.
+
+ 8.2. If You initiate litigation by asserting a patent infringement
+ claim (excluding declatory judgment actions) against Initial Developer
+ or a Contributor (the Initial Developer or Contributor against whom
+ You file such action is referred to as "Participant") alleging that:
+
+ (a) such Participant's Contributor Version directly or indirectly
+ infringes any patent, then any and all rights granted by such
+ Participant to You under Sections 2.1 and/or 2.2 of this License
+ shall, upon 60 days notice from Participant terminate prospectively,
+ unless if within 60 days after receipt of notice You either: (i)
+ agree in writing to pay Participant a mutually agreeable reasonable
+ royalty for Your past and future use of Modifications made by such
+ Participant, or (ii) withdraw Your litigation claim with respect to
+ the Contributor Version against such Participant. If within 60 days
+ of notice, a reasonable royalty and payment arrangement are not
+ mutually agreed upon in writing by the parties or the litigation claim
+ is not withdrawn, the rights granted by Participant to You under
+ Sections 2.1 and/or 2.2 automatically terminate at the expiration of
+ the 60 day notice period specified above.
+
+ (b) any software, hardware, or device, other than such Participant's
+ Contributor Version, directly or indirectly infringes any patent, then
+ any rights granted to You by such Participant under Sections 2.1(b)
+ and 2.2(b) are revoked effective as of the date You first made, used,
+ sold, distributed, or had made, Modifications made by that
+ Participant.
+
+ 8.3. If You assert a patent infringement claim against Participant
+ alleging that such Participant's Contributor Version directly or
+ indirectly infringes any patent where such claim is resolved (such as
+ by license or settlement) prior to the initiation of patent
+ infringement litigation, then the reasonable value of the licenses
+ granted by such Participant under Sections 2.1 or 2.2 shall be taken
+ into account in determining the amount or value of any payment or
+ license.
+
+ 8.4. In the event of termination under Sections 8.1 or 8.2 above,
+ all end user license agreements (excluding distributors and resellers)
+ which have been validly granted by You or any distributor hereunder
+ prior to termination shall survive termination.
+
+9. LIMITATION OF LIABILITY.
+
+ UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT
+ (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL YOU, THE INITIAL
+ DEVELOPER, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF COVERED CODE,
+ OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR
+ ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY
+ CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL,
+ WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER
+ COMMERCIAL DAMAGES OR LOSSES, EVEN IF SUCH PARTY SHALL HAVE BEEN
+ INFORMED OF THE POSSIBILITY OF SUCH DAMAGES. THIS LIMITATION OF
+ LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL INJURY
+ RESULTING FROM SUCH PARTY'S NEGLIGENCE TO THE EXTENT APPLICABLE LAW
+ PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE
+ EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO
+ THIS EXCLUSION AND LIMITATION MAY NOT APPLY TO YOU.
+
+10. U.S. GOVERNMENT END USERS.
+
+ The Covered Code is a "commercial item," as that term is defined in
+ 48 C.F.R. 2.101 (Oct. 1995), consisting of "commercial computer
+ software" and "commercial computer software documentation," as such
+ terms are used in 48 C.F.R. 12.212 (Sept. 1995). Consistent with 48
+ C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (June 1995),
+ all U.S. Government End Users acquire Covered Code with only those
+ rights set forth herein.
+
+11. MISCELLANEOUS.
+
+ This License represents the complete agreement concerning subject
+ matter hereof. If any provision of this License is held to be
+ unenforceable, such provision shall be reformed only to the extent
+ necessary to make it enforceable. This License shall be governed by
+ California law provisions (except to the extent applicable law, if
+ any, provides otherwise), excluding its conflict-of-law provisions.
+ With respect to disputes in which at least one party is a citizen of,
+ or an entity chartered or registered to do business in the United
+ States of America, any litigation relating to this License shall be
+ subject to the jurisdiction of the Federal Courts of the Northern
+ District of California, with venue lying in Santa Clara County,
+ California, with the losing party responsible for costs, including
+ without limitation, court costs and reasonable attorneys' fees and
+ expenses. The application of the United Nations Convention on
+ Contracts for the International Sale of Goods is expressly excluded.
+ Any law or regulation which provides that the language of a contract
+ shall be construed against the drafter shall not apply to this
+ License.
+
+12. RESPONSIBILITY FOR CLAIMS.
+
+ As between Initial Developer and the Contributors, each party is
+ responsible for claims and damages arising, directly or indirectly,
+ out of its utilization of rights under this License and You agree to
+ work with Initial Developer and Contributors to distribute such
+ responsibility on an equitable basis. Nothing herein is intended or
+ shall be deemed to constitute any admission of liability.
+
+13. MULTIPLE-LICENSED CODE.
+
+ Initial Developer may designate portions of the Covered Code as
+ "Multiple-Licensed". "Multiple-Licensed" means that the Initial
+ Developer permits you to utilize portions of the Covered Code under
+ Your choice of the NPL or the alternative licenses, if any, specified
+ by the Initial Developer in the file described in Exhibit A.
+
+EXHIBIT A -Mozilla Public License.
+
+ ``The contents of this file are subject to the Mozilla Public License
+ Version 1.1 (the "License"); you may not use this file except in
+ compliance with the License. You may obtain a copy of the License at
+ http://www.mozilla.org/MPL/
+
+ Software distributed under the License is distributed on an "AS IS"
+ basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
+ License for the specific language governing rights and limitations
+ under the License.
+
+ The Original Code is ______________________________________.
+
+ The Initial Developer of the Original Code is ________________________.
+ Portions created by ______________________ are Copyright (C) ______
+ _______________________. All Rights Reserved.
+
+ Contributor(s): ______________________________________.
+
+ Alternatively, the contents of this file may be used under the terms
+ of the _____ license (the "[___] License"), in which case the
+ provisions of [______] License are applicable instead of those
+ above. If you wish to allow use of your version of this file only
+ under the terms of the [____] License and not to allow others to use
+ your version of this file under the MPL, indicate your decision by
+ deleting the provisions above and replace them with the notice and
+ other provisions required by the [___] License. If you do not delete
+ the provisions above, a recipient may use your version of this file
+ under either the MPL or the [___] License."
+
+ [NOTE: The text of this Exhibit A may differ slightly from the text of
+ the notices in the Source Code files of the Original Code. You should
+ use the text of this Exhibit A rather than the text found in the
+ Original Code Source Code for Your Modifications.]
diff --git a/htdocs/includes/ckeditor/_source/README.md b/htdocs/includes/ckeditor/_source/README.md
new file mode 100644
index 00000000000..c5a55cd88f8
--- /dev/null
+++ b/htdocs/includes/ckeditor/_source/README.md
@@ -0,0 +1,39 @@
+CKEditor 4
+==========
+
+Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+http://ckeditor.com - See LICENSE.md for license information.
+
+CKEditor is a text editor to be used inside web pages. It's not a replacement
+for desktop text editors like Word or OpenOffice, but a component to be used as
+part of web applications and websites.
+
+## Documentation
+
+The full editor documentation is available online at the following address:
+http://docs.ckeditor.com
+
+## Installation
+
+Installing CKEditor is an easy task. Just follow these simple steps:
+
+ 1. **Download** the latest version from the CKEditor website:
+ http://ckeditor.com. You should have already completed this step, but be
+ sure you have the very latest version.
+ 2. **Extract** (decompress) the downloaded file into the root of your website.
+
+**Note:** CKEditor is by default installed in the `ckeditor` folder. You can
+place the files in whichever you want though.
+
+## Checking Your Installation
+
+The editor comes with a few sample pages that can be used to verify that
+installation proceeded properly. Take a look at the `samples` directory.
+
+To test your installation, just call the following page at your website:
+
+ http:////samples/index.html
+
+For example:
+
+ http://www.example.com/ckeditor/samples/index.html
diff --git a/htdocs/includes/ckeditor/_source/adapters/jquery.js b/htdocs/includes/ckeditor/_source/adapters/jquery.js
deleted file mode 100644
index b81c13f74e7..00000000000
--- a/htdocs/includes/ckeditor/_source/adapters/jquery.js
+++ /dev/null
@@ -1,306 +0,0 @@
-/*
-Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
-For licensing, see LICENSE.html or http://ckeditor.com/license
-*/
-
-/**
- * @fileOverview jQuery adapter provides easy use of basic CKEditor functions
- * and access to internal API. It also integrates some aspects of CKEditor with
- * jQuery framework.
- *
- * Every TEXTAREA, DIV and P elements can be converted to working editor.
- *
- * Plugin exposes some of editor's event to jQuery event system. All of those are namespaces inside
- * ".ckeditor" namespace and can be binded/listened on supported textarea, div and p nodes.
- *
- * Available jQuery events:
- * - instanceReady.ckeditor( editor, rootNode )
- * Triggered when new instance is ready.
- * - destroy.ckeditor( editor )
- * Triggered when instance is destroyed.
- * - getData.ckeditor( editor, eventData )
- * Triggered when getData event is fired inside editor. It can change returned data using eventData reference.
- * - setData.ckeditor( editor )
- * Triggered when getData event is fired inside editor.
- *
- * @example
- *
- *
- *
- */
-
-(function()
-{
- /**
- * Allows CKEditor to override jQuery.fn.val(), making it possible to use the val()
- * function on textareas, as usual, having it synchronized with CKEditor.
- *
- * This configuration option is global and executed during the jQuery Adapter loading.
- * It can't be customized across editor instances.
- * @type Boolean
- * @example
- * <script>
- * CKEDITOR.config.jqueryOverrideVal = true;
- * </script>
- * <!-- Important: The JQuery adapter is loaded *after* setting jqueryOverrideVal -->
- * <script src="/ckeditor/adapters/jquery.js"></script>
- * @example
- * // ... then later in the code ...
- *
- * $( 'textarea' ).ckeditor();
- * // ...
- * $( 'textarea' ).val( 'New content' );
- */
- CKEDITOR.config.jqueryOverrideVal = typeof CKEDITOR.config.jqueryOverrideVal == 'undefined'
- ? true : CKEDITOR.config.jqueryOverrideVal;
-
- var jQuery = window.jQuery;
-
- if ( typeof jQuery == 'undefined' )
- return;
-
- // jQuery object methods.
- jQuery.extend( jQuery.fn,
- /** @lends jQuery.fn */
- {
- /**
- * Return existing CKEditor instance for first matched element.
- * Allows to easily use internal API. Doesn't return jQuery object.
- *
- * Raised exception if editor doesn't exist or isn't ready yet.
- *
- * @name jQuery.ckeditorGet
- * @return CKEDITOR.editor
- * @see CKEDITOR.editor
- */
- ckeditorGet: function()
- {
- var instance = this.eq( 0 ).data( 'ckeditorInstance' );
- if ( !instance )
- throw "CKEditor not yet initialized, use ckeditor() with callback.";
- return instance;
- },
- /**
- * Triggers creation of CKEditor in all matched elements (reduced to DIV, P and TEXTAREAs).
- * Binds callback to instanceReady event of all instances. If editor is already created, than
- * callback is fired right away.
- *
- * Mixed parameter order allowed.
- *
- * @param callback Function to be run on editor instance. Passed parameters: [ textarea ].
- * Callback is fiered in "this" scope being ckeditor instance and having source textarea as first param.
- *
- * @param config Configuration options for new instance(s) if not already created.
- * See URL
- *
- * @example
- * $( 'textarea' ).ckeditor( function( textarea ) {
- * $( textarea ).val( this.getData() )
- * } );
- *
- * @name jQuery.fn.ckeditor
- * @return jQuery.fn
- */
- ckeditor: function( callback, config )
- {
- if ( !CKEDITOR.env.isCompatible )
- return this;
-
- if ( !jQuery.isFunction( callback ))
- {
- var tmp = config;
- config = callback;
- callback = tmp;
- }
- config = config || {};
-
- this.filter( 'textarea, div, p' ).each( function()
- {
- var $element = jQuery( this ),
- editor = $element.data( 'ckeditorInstance' ),
- instanceLock = $element.data( '_ckeditorInstanceLock' ),
- element = this;
-
- if ( editor && !instanceLock )
- {
- if ( callback )
- callback.apply( editor, [ this ] );
- }
- else if ( !instanceLock )
- {
- // CREATE NEW INSTANCE
-
- // Handle config.autoUpdateElement inside this plugin if desired.
- if ( config.autoUpdateElement
- || ( typeof config.autoUpdateElement == 'undefined' && CKEDITOR.config.autoUpdateElement ) )
- {
- config.autoUpdateElementJquery = true;
- }
-
- // Always disable config.autoUpdateElement.
- config.autoUpdateElement = false;
- $element.data( '_ckeditorInstanceLock', true );
-
- // Set instance reference in element's data.
- editor = CKEDITOR.replace( element, config );
- $element.data( 'ckeditorInstance', editor );
-
- // Register callback.
- editor.on( 'instanceReady', function( event )
- {
- var editor = event.editor;
- setTimeout( function()
- {
- // Delay bit more if editor is still not ready.
- if ( !editor.element )
- {
- setTimeout( arguments.callee, 100 );
- return;
- }
-
- // Remove this listener.
- event.removeListener( 'instanceReady', this.callee );
-
- // Forward setData on dataReady.
- editor.on( 'dataReady', function()
- {
- $element.trigger( 'setData' + '.ckeditor', [ editor ] );
- });
-
- // Forward getData.
- editor.on( 'getData', function( event ) {
- $element.trigger( 'getData' + '.ckeditor', [ editor, event.data ] );
- }, 999 );
-
- // Forward destroy event.
- editor.on( 'destroy', function()
- {
- $element.trigger( 'destroy.ckeditor', [ editor ] );
- });
-
- // Integrate with form submit.
- if ( editor.config.autoUpdateElementJquery && $element.is( 'textarea' ) && $element.parents( 'form' ).length )
- {
- var onSubmit = function()
- {
- $element.ckeditor( function()
- {
- editor.updateElement();
- });
- };
-
- // Bind to submit event.
- $element.parents( 'form' ).submit( onSubmit );
-
- // Bind to form-pre-serialize from jQuery Forms plugin.
- $element.parents( 'form' ).bind( 'form-pre-serialize', onSubmit );
-
- // Unbind when editor destroyed.
- $element.bind( 'destroy.ckeditor', function()
- {
- $element.parents( 'form' ).unbind( 'submit', onSubmit );
- $element.parents( 'form' ).unbind( 'form-pre-serialize', onSubmit );
- });
- }
-
- // Garbage collect on destroy.
- editor.on( 'destroy', function()
- {
- $element.data( 'ckeditorInstance', null );
- });
-
- // Remove lock.
- $element.data( '_ckeditorInstanceLock', null );
-
- // Fire instanceReady event.
- $element.trigger( 'instanceReady.ckeditor', [ editor ] );
-
- // Run given (first) code.
- if ( callback )
- callback.apply( editor, [ element ] );
- }, 0 );
- }, null, null, 9999);
- }
- else
- {
- // Editor is already during creation process, bind our code to the event.
- CKEDITOR.on( 'instanceReady', function( event )
- {
- var editor = event.editor;
- setTimeout( function()
- {
- // Delay bit more if editor is still not ready.
- if ( !editor.element )
- {
- setTimeout( arguments.callee, 100 );
- return;
- }
-
- if ( editor.element.$ == element )
- {
- // Run given code.
- if ( callback )
- callback.apply( editor, [ element ] );
- }
- }, 0 );
- }, null, null, 9999);
- }
- });
- return this;
- }
- });
-
- // New val() method for objects.
- if ( CKEDITOR.config.jqueryOverrideVal )
- {
- jQuery.fn.val = CKEDITOR.tools.override( jQuery.fn.val, function( oldValMethod )
- {
- /**
- * CKEditor-aware val() method.
- *
- * Acts same as original jQuery val(), but for textareas which have CKEditor instances binded to them, method
- * returns editor's content. It also works for settings values.
- *
- * @param oldValMethod
- * @name jQuery.fn.val
- */
- return function( newValue, forceNative )
- {
- var isSetter = typeof newValue != 'undefined',
- result;
-
- this.each( function()
- {
- var $this = jQuery( this ),
- editor = $this.data( 'ckeditorInstance' );
-
- if ( !forceNative && $this.is( 'textarea' ) && editor )
- {
- if ( isSetter )
- editor.setData( newValue );
- else
- {
- result = editor.getData();
- // break;
- return null;
- }
- }
- else
- {
- if ( isSetter )
- oldValMethod.call( $this, newValue );
- else
- {
- result = oldValMethod.call( $this );
- // break;
- return null;
- }
- }
-
- return true;
- });
- return isSetter ? this : result;
- };
- });
- }
-})();
diff --git a/htdocs/includes/ckeditor/_source/build-config.js b/htdocs/includes/ckeditor/_source/build-config.js
new file mode 100644
index 00000000000..09f9626824b
--- /dev/null
+++ b/htdocs/includes/ckeditor/_source/build-config.js
@@ -0,0 +1,165 @@
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.md or http://ckeditor.com/license
+ */
+
+/**
+ * This file was added automatically by CKEditor builder.
+ * You may re-use it at any time to build CKEditor again.
+ *
+ * If you would like to build CKEditor online again
+ * (for example to upgrade), visit one the following links:
+ *
+ * (1) http://ckeditor.com/builder
+ * Visit online builder to build CKEditor from scratch.
+ *
+ * (2) http://ckeditor.com/builder/6df6f619a26d5e0aab9c5392e3ab2c31
+ * Visit online builder to build CKEditor, starting with the same setup as before.
+ *
+ * (3) http://ckeditor.com/builder/download/6df6f619a26d5e0aab9c5392e3ab2c31
+ * Straight download link to the latest version of CKEditor (Optimized) with the same setup as before.
+ *
+ * NOTE:
+ * This file is not used by CKEditor, you may remove it.
+ * Changing this file will not change your CKEditor configuration.
+ */
+
+var CKBUILDER_CONFIG = {
+ skin: 'moonocolor',
+ preset: 'full',
+ ignore: [
+ 'dev',
+ '.gitignore',
+ '.gitattributes',
+ 'README.md',
+ '.mailmap'
+ ],
+ plugins : {
+ 'a11yhelp' : 1,
+ 'about' : 1,
+ 'basicstyles' : 1,
+ 'bidi' : 1,
+ 'blockquote' : 1,
+ 'clipboard' : 1,
+ 'colorbutton' : 1,
+ 'colordialog' : 1,
+ 'contextmenu' : 1,
+ 'dialogadvtab' : 1,
+ 'div' : 1,
+ 'elementspath' : 1,
+ 'enterkey' : 1,
+ 'entities' : 1,
+ 'filebrowser' : 1,
+ 'find' : 1,
+ 'flash' : 1,
+ 'floatingspace' : 1,
+ 'font' : 1,
+ 'format' : 1,
+ 'forms' : 1,
+ 'horizontalrule' : 1,
+ 'htmlwriter' : 1,
+ 'iframe' : 1,
+ 'image' : 1,
+ 'indentblock' : 1,
+ 'indentlist' : 1,
+ 'justify' : 1,
+ 'language' : 1,
+ 'link' : 1,
+ 'list' : 1,
+ 'liststyle' : 1,
+ 'magicline' : 1,
+ 'maximize' : 1,
+ 'newpage' : 1,
+ 'pagebreak' : 1,
+ 'pastefromword' : 1,
+ 'pastetext' : 1,
+ 'preview' : 1,
+ 'print' : 1,
+ 'removeformat' : 1,
+ 'resize' : 1,
+ 'save' : 1,
+ 'scayt' : 1,
+ 'selectall' : 1,
+ 'showblocks' : 1,
+ 'showborders' : 1,
+ 'smiley' : 1,
+ 'sourcearea' : 1,
+ 'specialchar' : 1,
+ 'stylescombo' : 1,
+ 'tab' : 1,
+ 'table' : 1,
+ 'tabletools' : 1,
+ 'templates' : 1,
+ 'toolbar' : 1,
+ 'undo' : 1,
+ 'wsc' : 1,
+ 'wysiwygarea' : 1
+ },
+ languages : {
+ 'af' : 1,
+ 'ar' : 1,
+ 'bg' : 1,
+ 'bn' : 1,
+ 'bs' : 1,
+ 'ca' : 1,
+ 'cs' : 1,
+ 'cy' : 1,
+ 'da' : 1,
+ 'de' : 1,
+ 'el' : 1,
+ 'en' : 1,
+ 'en-au' : 1,
+ 'en-ca' : 1,
+ 'en-gb' : 1,
+ 'eo' : 1,
+ 'es' : 1,
+ 'et' : 1,
+ 'eu' : 1,
+ 'fa' : 1,
+ 'fi' : 1,
+ 'fo' : 1,
+ 'fr' : 1,
+ 'fr-ca' : 1,
+ 'gl' : 1,
+ 'gu' : 1,
+ 'he' : 1,
+ 'hi' : 1,
+ 'hr' : 1,
+ 'hu' : 1,
+ 'id' : 1,
+ 'is' : 1,
+ 'it' : 1,
+ 'ja' : 1,
+ 'ka' : 1,
+ 'km' : 1,
+ 'ko' : 1,
+ 'ku' : 1,
+ 'lt' : 1,
+ 'lv' : 1,
+ 'mk' : 1,
+ 'mn' : 1,
+ 'ms' : 1,
+ 'nb' : 1,
+ 'nl' : 1,
+ 'no' : 1,
+ 'pl' : 1,
+ 'pt' : 1,
+ 'pt-br' : 1,
+ 'ro' : 1,
+ 'ru' : 1,
+ 'si' : 1,
+ 'sk' : 1,
+ 'sl' : 1,
+ 'sq' : 1,
+ 'sr' : 1,
+ 'sr-latn' : 1,
+ 'sv' : 1,
+ 'th' : 1,
+ 'tr' : 1,
+ 'ug' : 1,
+ 'uk' : 1,
+ 'vi' : 1,
+ 'zh' : 1,
+ 'zh-cn' : 1
+ }
+};
\ No newline at end of file
diff --git a/htdocs/includes/ckeditor/_source/ckeditor.js b/htdocs/includes/ckeditor/_source/ckeditor.js
new file mode 100644
index 00000000000..abb087d1565
--- /dev/null
+++ b/htdocs/includes/ckeditor/_source/ckeditor.js
@@ -0,0 +1,42 @@
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.md or http://ckeditor.com/license
+ */
+
+// Compressed version of core/ckeditor_base.js. See original for instructions.
+/*jsl:ignore*/
+window.CKEDITOR||(window.CKEDITOR=function(){var b={timestamp:"",version:"%VERSION%",revision:"%REV%",rnd:Math.floor(900*Math.random())+100,_:{pending:[]},status:"unloaded",basePath:function(){var a=window.CKEDITOR_BASEPATH||"";if(!a)for(var b=document.getElementsByTagName("script"),c=0;c' );
+
+}
+
+/**
+ * The skin to load for all created instances, it may be the name of the skin
+ * folder inside the editor installation path, or the name and the path separated
+ * by a comma.
+ *
+ * **Note:** This is a global configuration that applies to all instances.
+ *
+ * CKEDITOR.skinName = 'moono';
+ *
+ * CKEDITOR.skinName = 'myskin,/customstuff/myskin/';
+ *
+ * @cfg {String} [skinName='moono']
+ * @member CKEDITOR
+ */
+CKEDITOR.skinName = 'moono';
diff --git a/htdocs/includes/ckeditor/_source/config.js b/htdocs/includes/ckeditor/_source/config.js
new file mode 100644
index 00000000000..4bc7ecff999
--- /dev/null
+++ b/htdocs/includes/ckeditor/_source/config.js
@@ -0,0 +1,17 @@
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.html or http://ckeditor.com/license
+ */
+
+CKEDITOR.editorConfig = function( config ) {
+
+ // %REMOVE_START%
+ // The configuration options below are needed when running CKEditor from source files.
+ config.plugins = 'dialogui,dialog,about,a11yhelp,dialogadvtab,basicstyles,bidi,blockquote,clipboard,button,panelbutton,panel,floatpanel,colorbutton,colordialog,templates,menu,contextmenu,div,resize,toolbar,elementspath,enterkey,entities,popup,filebrowser,find,fakeobjects,flash,floatingspace,listblock,richcombo,font,forms,format,horizontalrule,htmlwriter,iframe,wysiwygarea,image,indent,indentblock,indentlist,smiley,justify,menubutton,language,link,list,liststyle,magicline,maximize,newpage,pagebreak,pastetext,pastefromword,preview,print,removeformat,save,selectall,showblocks,showborders,sourcearea,specialchar,scayt,stylescombo,tab,table,tabletools,undo,wsc';
+ config.skin = 'moonocolor';
+ // %REMOVE_END%
+
+ // Define changes to default configuration here. For example:
+ // config.language = 'fr';
+ // config.uiColor = '#AADC6E';
+};
diff --git a/htdocs/includes/ckeditor/_source/contents.css b/htdocs/includes/ckeditor/_source/contents.css
new file mode 100644
index 00000000000..ac3e9af2b96
--- /dev/null
+++ b/htdocs/includes/ckeditor/_source/contents.css
@@ -0,0 +1,123 @@
+/*
+Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+For licensing, see LICENSE.md or http://ckeditor.com/license
+*/
+
+body
+{
+ /* Font */
+ font-family: sans-serif, Arial, Verdana, "Trebuchet MS";
+ font-size: 12px;
+
+ /* Text color */
+ color: #333;
+
+ /* Remove the background color to make it transparent */
+ background-color: #fff;
+
+ margin: 20px;
+}
+
+.cke_editable
+{
+ font-size: 13px;
+ line-height: 1.6;
+}
+
+blockquote
+{
+ font-style: italic;
+ font-family: Georgia, Times, "Times New Roman", serif;
+ padding: 2px 0;
+ border-style: solid;
+ border-color: #ccc;
+ border-width: 0;
+}
+
+.cke_contents_ltr blockquote
+{
+ padding-left: 20px;
+ padding-right: 8px;
+ border-left-width: 5px;
+}
+
+.cke_contents_rtl blockquote
+{
+ padding-left: 8px;
+ padding-right: 20px;
+ border-right-width: 5px;
+}
+
+a
+{
+ color: #0782C1;
+}
+
+ol,ul,dl
+{
+ /* IE7: reset rtl list margin. (#7334) */
+ *margin-right: 0px;
+ /* preserved spaces for list items with text direction other than the list. (#6249,#8049)*/
+ padding: 0 40px;
+}
+
+h1,h2,h3,h4,h5,h6
+{
+ font-weight: normal;
+ line-height: 1.2;
+}
+
+hr
+{
+ border: 0px;
+ border-top: 1px solid #ccc;
+}
+
+img.right
+{
+ border: 1px solid #ccc;
+ float: right;
+ margin-left: 15px;
+ padding: 5px;
+}
+
+img.left
+{
+ border: 1px solid #ccc;
+ float: left;
+ margin-right: 15px;
+ padding: 5px;
+}
+
+pre
+{
+ white-space: pre-wrap; /* CSS 2.1 */
+ word-wrap: break-word; /* IE7 */
+}
+
+.marker
+{
+ background-color: Yellow;
+}
+
+span[lang]
+{
+ font-style: italic;
+}
+
+figure
+{
+ text-align: center;
+ border: solid 1px #ccc;
+ border-radius: 2px;
+ background: rgba(0,0,0,0.05);
+ padding: 10px;
+ margin: 10px 20px;
+ display: block; /* For IE8 */
+}
+
+figure figcaption
+{
+ text-align: center;
+ display: block; /* For IE8 */
+}
\ No newline at end of file
diff --git a/htdocs/includes/ckeditor/_source/core/_bootstrap.js b/htdocs/includes/ckeditor/_source/core/_bootstrap.js
index fd5b49bb5b1..d6802af54be 100644
--- a/htdocs/includes/ckeditor/_source/core/_bootstrap.js
+++ b/htdocs/includes/ckeditor/_source/core/_bootstrap.js
@@ -1,87 +1,74 @@
-/*
-Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
-For licensing, see LICENSE.html or http://ckeditor.com/license
-*/
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.md or http://ckeditor.com/license
+ */
/**
* @fileOverview API initialization code.
*/
-(function()
-{
- // Disable HC detaction in WebKit. (#5429)
+( function() {
+ // Disable HC detection in WebKit. (#5429)
if ( CKEDITOR.env.webkit )
- {
CKEDITOR.env.hc = false;
- return;
- }
+ else {
+ // Check whether high contrast is active by creating a colored border.
+ var hcDetect = CKEDITOR.dom.element.createFromHtml( '
', CKEDITOR.document );
- // Check whether high contrast is active by creating a colored border.
- var hcDetect = CKEDITOR.dom.element.createFromHtml(
- '
', CKEDITOR.document );
+ hcDetect.appendTo( CKEDITOR.document.getHead() );
- hcDetect.appendTo( CKEDITOR.document.getHead() );
+ // Update CKEDITOR.env.
+ // Catch exception needed sometimes for FF. (#4230)
+ try {
+ var top = hcDetect.getComputedStyle( 'border-top-color' ),
+ right = hcDetect.getComputedStyle( 'border-right-color' );
- // Update CKEDITOR.env.
- // Catch exception needed sometimes for FF. (#4230)
- try
- {
- CKEDITOR.env.hc = hcDetect.getComputedStyle( 'border-top-color' ) == hcDetect.getComputedStyle( 'border-right-color' );
- }
- catch (e)
- {
- CKEDITOR.env.hc = false;
+ // We need to check if getComputedStyle returned any value, because on FF
+ // it returnes empty string if CKEditor is loaded in hidden iframe. (#11121)
+ CKEDITOR.env.hc = !!( top && top == right );
+ } catch ( e ) {
+ CKEDITOR.env.hc = false;
+ }
+
+ hcDetect.remove();
}
if ( CKEDITOR.env.hc )
CKEDITOR.env.cssClass += ' cke_hc';
- hcDetect.remove();
-})();
+ // Initially hide UI spaces when relevant skins are loading, later restored by skin css.
+ CKEDITOR.document.appendStyleText( '.cke{visibility:hidden;}' );
-// Load core plugins.
-CKEDITOR.plugins.load( CKEDITOR.config.corePlugins.split( ',' ), function()
- {
- CKEDITOR.status = 'loaded';
- CKEDITOR.fire( 'loaded' );
+ // Mark the editor as fully loaded.
+ CKEDITOR.status = 'loaded';
+ CKEDITOR.fireOnce( 'loaded' );
- // Process all instances created by the "basic" implementation.
- var pending = CKEDITOR._.pending;
- if ( pending )
- {
- delete CKEDITOR._.pending;
+ // Process all instances created by the "basic" implementation.
+ var pending = CKEDITOR._.pending;
+ if ( pending ) {
+ delete CKEDITOR._.pending;
- for ( var i = 0 ; i < pending.length ; i++ )
- CKEDITOR.add( pending[ i ] );
+ for ( var i = 0; i < pending.length; i++ ) {
+ CKEDITOR.editor.prototype.constructor.apply( pending[ i ][ 0 ], pending[ i ][ 1 ] );
+ CKEDITOR.add( pending[ i ][ 0 ] );
}
- });
-
-// Needed for IE6 to not request image (HTTP 200 or 304) for every CSS background. (#6187)
-if ( CKEDITOR.env.ie )
-{
- // Remove IE mouse flickering on IE6 because of background images.
- try
- {
- document.execCommand( 'BackgroundImageCache', false, true );
}
- catch (e)
- {
- // We have been reported about loading problems caused by the above
- // line. For safety, let's just ignore errors.
- }
-}
+} )();
/**
* Indicates that CKEditor is running on a High Contrast environment.
- * @name CKEDITOR.env.hc
- * @example
- * if ( CKEDITOR.env.hc )
- * alert( 'You're running on High Contrast mode. The editor interface will get adapted to provide you a better experience.' );
+ *
+ * if ( CKEDITOR.env.hc )
+ * alert( 'You\'re running on High Contrast mode. The editor interface will get adapted to provide you a better experience.' );
+ *
+ * @property {Boolean} hc
+ * @member CKEDITOR.env
*/
/**
* Fired when a CKEDITOR core object is fully loaded and ready for interaction.
- * @name CKEDITOR#loaded
- * @event
+ *
+ * @event loaded
+ * @member CKEDITOR
*/
diff --git a/htdocs/includes/ckeditor/_source/core/ckeditor.js b/htdocs/includes/ckeditor/_source/core/ckeditor.js
index 3e54930be29..aaa37d35212 100644
--- a/htdocs/includes/ckeditor/_source/core/ckeditor.js
+++ b/htdocs/includes/ckeditor/_source/core/ckeditor.js
@@ -1,141 +1,204 @@
-/*
-Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
-For licensing, see LICENSE.html or http://ckeditor.com/license
-*/
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.md or http://ckeditor.com/license
+ */
/**
* @fileOverview Contains the third and last part of the {@link CKEDITOR} object
* definition.
*/
+/** @class CKEDITOR */
+
// Remove the CKEDITOR.loadFullCore reference defined on ckeditor_basic.
delete CKEDITOR.loadFullCore;
/**
- * Holds references to all editor instances created. The name of the properties
- * in this object correspond to instance names, and their values contains the
+ * Stores references to all editor instances created. The name of the properties
+ * in this object correspond to instance names, and their values contain the
* {@link CKEDITOR.editor} object representing them.
- * @type {Object}
- * @example
- * alert( CKEDITOR.instances .editor1.name ); // "editor1"
+ *
+ * alert( CKEDITOR.instances.editor1.name ); // 'editor1'
+ *
+ * @property {Object}
*/
CKEDITOR.instances = {};
/**
- * The document of the window holding the CKEDITOR object.
- * @type {CKEDITOR.dom.document}
- * @example
- * alert( CKEDITOR.document .getBody().getName() ); // "body"
+ * The document of the window storing the CKEDITOR object.
+ *
+ * alert( CKEDITOR.document.getBody().getName() ); // 'body'
+ *
+ * @property {CKEDITOR.dom.document}
*/
CKEDITOR.document = new CKEDITOR.dom.document( document );
/**
* Adds an editor instance to the global {@link CKEDITOR} object. This function
* is available for internal use mainly.
+ *
* @param {CKEDITOR.editor} editor The editor instance to be added.
- * @example
*/
-CKEDITOR.add = function( editor )
-{
+CKEDITOR.add = function( editor ) {
CKEDITOR.instances[ editor.name ] = editor;
- editor.on( 'focus', function()
- {
- if ( CKEDITOR.currentInstance != editor )
- {
- CKEDITOR.currentInstance = editor;
- CKEDITOR.fire( 'currentInstance' );
- }
- });
+ editor.on( 'focus', function() {
+ if ( CKEDITOR.currentInstance != editor ) {
+ CKEDITOR.currentInstance = editor;
+ CKEDITOR.fire( 'currentInstance' );
+ }
+ } );
- editor.on( 'blur', function()
- {
- if ( CKEDITOR.currentInstance == editor )
- {
- CKEDITOR.currentInstance = null;
- CKEDITOR.fire( 'currentInstance' );
- }
- });
+ editor.on( 'blur', function() {
+ if ( CKEDITOR.currentInstance == editor ) {
+ CKEDITOR.currentInstance = null;
+ CKEDITOR.fire( 'currentInstance' );
+ }
+ } );
+
+ CKEDITOR.fire( 'instance', null, editor );
};
/**
* Removes an editor instance from the global {@link CKEDITOR} object. This function
- * is available for internal use only. External code must use {@link CKEDITOR.editor.prototype.destroy}
- * to avoid memory leaks.
+ * is available for internal use only. External code must use {@link CKEDITOR.editor#method-destroy}.
+ *
+ * @private
* @param {CKEDITOR.editor} editor The editor instance to be removed.
- * @example
*/
-CKEDITOR.remove = function( editor )
-{
+CKEDITOR.remove = function( editor ) {
delete CKEDITOR.instances[ editor.name ];
};
-/**
- * Perform global clean up to free as much memory as possible
- * when there are no instances left
- */
-CKEDITOR.on( 'instanceDestroyed', function ()
- {
- if ( CKEDITOR.tools.isEmpty( this.instances ) )
- CKEDITOR.fire( 'reset' );
- });
+( function() {
+ var tpls = {};
+
+ /**
+ * Adds a named {@link CKEDITOR.template} instance to be reused among all editors.
+ * This will return the existing one if a template with same name is already
+ * defined. Additionally, it fires the "template" event to allow template source customization.
+ *
+ * @param {String} name The name which identifies a UI template.
+ * @param {String} source The source string for constructing this template.
+ * @returns {CKEDITOR.template} The created template instance.
+ */
+ CKEDITOR.addTemplate = function( name, source ) {
+ var tpl = tpls[ name ];
+ if ( tpl )
+ return tpl;
+
+ // Make it possible to customize the template through event.
+ var params = { name: name, source: source };
+ CKEDITOR.fire( 'template', params );
+
+ return ( tpls[ name ] = new CKEDITOR.template( params.source ) );
+ };
+
+ /**
+ * Retrieves a defined template created with {@link CKEDITOR#addTemplate}.
+ *
+ * @param {String} name The template name.
+ */
+ CKEDITOR.getTemplate = function( name ) {
+ return tpls[ name ];
+ };
+} )();
+
+( function() {
+ var styles = [];
+
+ /**
+ * Adds CSS rules to be appended to the editor document.
+ * This method is mostly used by plugins to add custom styles to the editor
+ * document. For basic content styling the `contents.css` file should be
+ * used instead.
+ *
+ * **Note:** This function should be called before the creation of editor instances.
+ *
+ * // Add styles for all headings inside editable contents.
+ * CKEDITOR.addCss( '.cke_editable h1,.cke_editable h2,.cke_editable h3 { border-bottom: 1px dotted red }' );
+ *
+ * @param {String} css The style rules to be appended.
+ * @see CKEDITOR.config#contentsCss
+ */
+ CKEDITOR.addCss = function( css ) {
+ styles.push( css );
+ };
+
+ /**
+ * Returns a string will all CSS rules passed to the {@link CKEDITOR#addCss} method.
+ *
+ * @returns {String} A string containing CSS rules.
+ */
+ CKEDITOR.getCss = function() {
+ return styles.join( '\n' );
+ };
+} )();
+
+// Perform global clean up to free as much memory as possible
+// when there are no instances left
+CKEDITOR.on( 'instanceDestroyed', function() {
+ if ( CKEDITOR.tools.isEmpty( this.instances ) )
+ CKEDITOR.fire( 'reset' );
+} );
// Load the bootstrap script.
-CKEDITOR.loader.load( 'core/_bootstrap' ); // @Packager.RemoveLine
+CKEDITOR.loader.load( '_bootstrap' ); // %REMOVE_LINE%
// Tri-state constants.
-
/**
* Used to indicate the ON or ACTIVE state.
- * @constant
- * @example
+ *
+ * @readonly
+ * @property {Number} [=1]
*/
CKEDITOR.TRISTATE_ON = 1;
/**
- * Used to indicate the OFF or NON ACTIVE state.
- * @constant
- * @example
+ * Used to indicate the OFF or INACTIVE state.
+ *
+ * @readonly
+ * @property {Number} [=2]
*/
CKEDITOR.TRISTATE_OFF = 2;
/**
- * Used to indicate DISABLED state.
- * @constant
- * @example
+ * Used to indicate the DISABLED state.
+ *
+ * @readonly
+ * @property {Number} [=0]
*/
CKEDITOR.TRISTATE_DISABLED = 0;
/**
- * The editor which is currently active (have user focus).
- * @name CKEDITOR.currentInstance
- * @type CKEDITOR.editor
- * @see CKEDITOR#currentInstance
- * @example
- * function showCurrentEditorName()
- * {
- * if ( CKEDITOR.currentInstance )
- * alert( CKEDITOR.currentInstance.name );
- * else
- * alert( 'Please focus an editor first.' );
- * }
+ * The editor which is currently active (has user focus).
+ *
+ * function showCurrentEditorName() {
+ * if ( CKEDITOR.currentInstance )
+ * alert( CKEDITOR.currentInstance.name );
+ * else
+ * alert( 'Please focus an editor first.' );
+ * }
+ *
+ * @property {CKEDITOR.editor} currentInstance
+ * @see CKEDITOR#event-currentInstance
*/
/**
* Fired when the CKEDITOR.currentInstance object reference changes. This may
* happen when setting the focus on different editor instances in the page.
- * @name CKEDITOR#currentInstance
- * @event
- * var editor; // Variable to hold a reference to the current editor.
- * CKEDITOR.on( 'currentInstance' , function( e )
- * {
- * editor = CKEDITOR.currentInstance;
- * });
+ *
+ * var editor; // A variable to store a reference to the current editor.
+ * CKEDITOR.on( 'currentInstance', function() {
+ * editor = CKEDITOR.currentInstance;
+ * } );
+ *
+ * @event currentInstance
*/
/**
* Fired when the last instance has been destroyed. This event is used to perform
- * global memory clean up.
- * @name CKEDITOR#reset
- * @event
+ * global memory cleanup.
+ *
+ * @event reset
*/
diff --git a/htdocs/includes/ckeditor/_source/core/ckeditor_base.js b/htdocs/includes/ckeditor/_source/core/ckeditor_base.js
index f3e87167939..069793172a9 100644
--- a/htdocs/includes/ckeditor/_source/core/ckeditor_base.js
+++ b/htdocs/includes/ckeditor/_source/core/ckeditor_base.js
@@ -1,7 +1,7 @@
-/*
-Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
-For licensing, see LICENSE.html or http://ckeditor.com/license
-*/
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.md or http://ckeditor.com/license
+ */
/**
* @fileOverview Contains the first and essential part of the {@link CKEDITOR}
@@ -9,130 +9,122 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
*/
// #### Compressed Code
-// Must be updated on changes in the script as well as updated in the
-// ckeditor_source.js and ckeditor_basic_source.js files.
+// Must be updated on changes in the script as well as updated in the ckeditor.js file.
-// if(!window.CKEDITOR)window.CKEDITOR=(function(){var a={timestamp:'',version:'3.6.4',revision:'7575',rnd:Math.floor(Math.random()*900)+100,_:{},status:'unloaded',basePath:(function(){var d=window.CKEDITOR_BASEPATH||'';if(!d){var e=document.getElementsByTagName('script');for(var f=0;f=0?'&':'?')+'t='+this.timestamp;return d;}},b=window.CKEDITOR_GETURL;if(b){var c=a.getUrl;a.getUrl=function(d){return b.call(a,d)||c.call(a,d);};}return a;})();
+// window.CKEDITOR||(window.CKEDITOR=function(){var b={timestamp:"",version:"%VERSION%",revision:"%REV%",rnd:Math.floor(900*Math.random())+100,_:{pending:[]},status:"unloaded",basePath:function(){var a=window.CKEDITOR_BASEPATH||"";if(!a)for(var b=document.getElementsByTagName("script"),c=0;c
- * unloaded : the API is not yet loaded.
- * basic_loaded : the basic API features are available.
- * basic_ready : the basic API is ready to load the full core code.
- * loading : the full API is being loaded.
- * loaded : the API can be fully used.
- *
- * @type String
- * @example
- * if ( CKEDITOR.status == 'loaded' )
- * {
- * // The API can now be fully used.
- * }
+ *
+ * * **unloaded**: the API is not yet loaded.
+ * * **basic_loaded**: the basic API features are available.
+ * * **basic_ready**: the basic API is ready to load the full core code.
+ * * **loaded**: the API can be fully used.
+ *
+ * Example:
+ *
+ * if ( CKEDITOR.status == 'loaded' ) {
+ * // The API can now be fully used.
+ * doSomething();
+ * } else {
+ * // Wait for the full core to be loaded and fire its loading.
+ * CKEDITOR.on( 'load', doSomething );
+ * CKEDITOR.loadFullCore && CKEDITOR.loadFullCore();
+ * }
*/
- status : 'unloaded',
+ status: 'unloaded',
/**
- * Contains the full URL for the CKEditor installation directory.
+ * The full URL for the CKEditor installation directory.
* It is possible to manually provide the base path by setting a
- * global variable named CKEDITOR_BASEPATH. This global variable
- * must be set before the editor script loading.
- * @type String
- * @example
- * alert( CKEDITOR.basePath ); // "http://www.example.com/ckeditor/" (e.g.)
+ * global variable named `CKEDITOR_BASEPATH`. This global variable
+ * must be set **before** the editor script loading.
+ *
+ * alert( CKEDITOR.basePath ); // e.g. 'http://www.example.com/ckeditor/'
+ *
+ * @property {String}
*/
- basePath : (function()
- {
+ basePath: ( function() {
// ATTENTION: fixes to this code must be ported to
// var basePath in "core/loader.js".
// Find out the editor directory path, based on its ' );
- return (
- this.getWindow = function()
- {
- return win;
- })();
- },
+ this.$.write( html );
+ this.$.close();
+ },
- /**
- * Defines the document contents through document.write. Note that the
- * previous document contents will be lost (cleaned).
- * @since 3.5
- * @param {String} html The HTML defining the document contents.
- * @example
- * document.write(
- * '<html>' +
- * '<head><title>Sample Doc</title></head>' +
- * '<body>Document contents created by code</body>' +
- * '</html>' );
- */
- write : function( html )
- {
- // Don't leave any history log in IE. (#5657)
- this.$.open( 'text/html', 'replace' );
+ /**
+ * Wrapper for `querySelectorAll`. Returns a list of elements within this document that match
+ * specified `selector`.
+ *
+ * **Note:** returned list is not a live collection (like a result of native `querySelectorAll`).
+ *
+ * @since 4.3
+ * @param {String} selector
+ * @returns {CKEDITOR.dom.nodeList}
+ */
+ find: function( selector ) {
+ return new CKEDITOR.dom.nodeList( this.$.querySelectorAll( selector ) );
+ },
- // Support for custom document.domain in IE.
- CKEDITOR.env.isCustomDomain() && ( this.$.domain = document.domain );
+ /**
+ * Wrapper for `querySelector`. Returns first element within this document that matches
+ * specified `selector`.
+ *
+ * @since 4.3
+ * @param {String} selector
+ * @returns {CKEDITOR.dom.element}
+ */
+ findOne: function( selector ) {
+ var el = this.$.querySelector( selector );
- this.$.write( html );
- this.$.close();
+ return el ? new CKEDITOR.dom.element( el ) : null;
+ },
+
+ /**
+ * IE8 only method. It returns document fragment which has all HTML5 elements enabled.
+ *
+ * @since 4.3
+ * @private
+ * @returns DocumentFragment
+ */
+ _getHtml5ShivFrag: function() {
+ var $frag = this.getCustomData( 'html5ShivFrag' );
+
+ if ( !$frag ) {
+ $frag = this.$.createDocumentFragment();
+ CKEDITOR.tools.enableHtml5Elements( $frag, true );
+ this.setCustomData( 'html5ShivFrag', $frag );
}
- });
+
+ return $frag;
+ }
+} );
diff --git a/htdocs/includes/ckeditor/_source/core/dom/documentfragment.js b/htdocs/includes/ckeditor/_source/core/dom/documentfragment.js
index cf25fe868de..c1af89929ca 100644
--- a/htdocs/includes/ckeditor/_source/core/dom/documentfragment.js
+++ b/htdocs/includes/ckeditor/_source/core/dom/documentfragment.js
@@ -1,49 +1,45 @@
-/*
-Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
-For licensing, see LICENSE.html or http://ckeditor.com/license
-*/
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.md or http://ckeditor.com/license
+ */
/**
- * @class DocumentFragment is a "lightweight" or "minimal" Document object. It is
+ * DocumentFragment is a "lightweight" or "minimal" Document object. It is
* commonly used to extract a portion of a document's tree or to create a new
* fragment of a document. Various operations may take DocumentFragment objects
* as arguments and results in all the child nodes of the DocumentFragment being
* moved to the child list of this node.
- * @param {Object} ownerDocument
+ *
+ * @class
+ * @constructor Creates a document fragment class instance.
+ * @param {Object} nodeOrDoc
+ * @todo example and param doc
*/
-CKEDITOR.dom.documentFragment = function( ownerDocument )
-{
- ownerDocument = ownerDocument || CKEDITOR.document;
- this.$ = ownerDocument.$.createDocumentFragment();
+CKEDITOR.dom.documentFragment = function( nodeOrDoc ) {
+ nodeOrDoc = nodeOrDoc || CKEDITOR.document;
+
+ if ( nodeOrDoc.type == CKEDITOR.NODE_DOCUMENT )
+ this.$ = nodeOrDoc.$.createDocumentFragment();
+ else
+ this.$ = nodeOrDoc;
};
-CKEDITOR.tools.extend( CKEDITOR.dom.documentFragment.prototype,
- CKEDITOR.dom.element.prototype,
- {
- type : CKEDITOR.NODE_DOCUMENT_FRAGMENT,
- insertAfterNode : function( node )
- {
- node = node.$;
- node.parentNode.insertBefore( this.$, node.nextSibling );
- }
- },
- true,
- {
- 'append' : 1,
- 'appendBogus' : 1,
- 'getFirst' : 1,
- 'getLast' : 1,
- 'appendTo' : 1,
- 'moveChildren' : 1,
- 'insertBefore' : 1,
- 'insertAfterNode' : 1,
- 'replace' : 1,
- 'trim' : 1,
- 'type' : 1,
- 'ltrim' : 1,
- 'rtrim' : 1,
- 'getDocument' : 1,
- 'getChildCount' : 1,
- 'getChild' : 1,
- 'getChildren' : 1
- } );
+CKEDITOR.tools.extend( CKEDITOR.dom.documentFragment.prototype, CKEDITOR.dom.element.prototype, {
+ /**
+ * The node type. This is a constant value set to {@link CKEDITOR#NODE_DOCUMENT_FRAGMENT}.
+ *
+ * @readonly
+ * @property {Number} [=CKEDITOR.NODE_DOCUMENT_FRAGMENT]
+ */
+ type: CKEDITOR.NODE_DOCUMENT_FRAGMENT,
+
+ /**
+ * Inserts document fragment's contents after specified node.
+ *
+ * @param {CKEDITOR.dom.node} node
+ */
+ insertAfterNode: function( node ) {
+ node = node.$;
+ node.parentNode.insertBefore( this.$, node.nextSibling );
+ }
+}, true, { 'append': 1, 'appendBogus': 1, 'getFirst': 1, 'getLast': 1, 'getParent': 1, 'getNext': 1, 'getPrevious': 1, 'appendTo': 1, 'moveChildren': 1, 'insertBefore': 1, 'insertAfterNode': 1, 'replace': 1, 'trim': 1, 'type': 1, 'ltrim': 1, 'rtrim': 1, 'getDocument': 1, 'getChildCount': 1, 'getChild': 1, 'getChildren': 1 } );
diff --git a/htdocs/includes/ckeditor/_source/core/dom/domobject.js b/htdocs/includes/ckeditor/_source/core/dom/domobject.js
index b1249c31bc9..96e2be18196 100644
--- a/htdocs/includes/ckeditor/_source/core/dom/domobject.js
+++ b/htdocs/includes/ckeditor/_source/core/dom/domobject.js
@@ -1,7 +1,7 @@
-/*
-Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
-For licensing, see LICENSE.html or http://ckeditor.com/license
-*/
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.md or http://ckeditor.com/license
+ */
/**
* @fileOverview Defines the {@link CKEDITOR.editor} class, which is the base
@@ -12,60 +12,67 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
* Represents a DOM object. This class is not intended to be used directly. It
* serves as the base class for other classes representing specific DOM
* objects.
- * @constructor
+ *
+ * @class
+ * @mixins CKEDITOR.event
+ * @constructor Creates a domObject class instance.
* @param {Object} nativeDomObject A native DOM object.
- * @augments CKEDITOR.event
- * @example
*/
-CKEDITOR.dom.domObject = function( nativeDomObject )
-{
- if ( nativeDomObject )
- {
+CKEDITOR.dom.domObject = function( nativeDomObject ) {
+ if ( nativeDomObject ) {
/**
* The native DOM object represented by this class instance.
- * @type Object
- * @example
- * var element = new CKEDITOR.dom.element( 'span' );
- * alert( element.$.nodeType ); // "1"
+ *
+ * var element = new CKEDITOR.dom.element( 'span' );
+ * alert( element.$.nodeType ); // '1'
+ *
+ * @readonly
+ * @property {Object}
*/
this.$ = nativeDomObject;
}
};
-CKEDITOR.dom.domObject.prototype = (function()
-{
+CKEDITOR.dom.domObject.prototype = ( function() {
// Do not define other local variables here. We want to keep the native
// listener closures as clean as possible.
- var getNativeListener = function( domObject, eventName )
- {
- return function( domEvent )
- {
- // In FF, when reloading the page with the editor focused, it may
- // throw an error because the CKEDITOR global is not anymore
- // available. So, we check it here first. (#2923)
- if ( typeof CKEDITOR != 'undefined' )
- domObject.fire( eventName, new CKEDITOR.dom.event( domEvent ) );
+ var getNativeListener = function( domObject, eventName ) {
+ return function( domEvent ) {
+ // In FF, when reloading the page with the editor focused, it may
+ // throw an error because the CKEDITOR global is not anymore
+ // available. So, we check it here first. (#2923)
+ if ( typeof CKEDITOR != 'undefined' )
+ domObject.fire( eventName, new CKEDITOR.dom.event( domEvent ) );
+ };
};
- };
- return /** @lends CKEDITOR.dom.domObject.prototype */ {
+ return {
- getPrivate : function()
- {
+ /**
+ * Get the private `_` object which is bound to the native
+ * DOM object using {@link #getCustomData}.
+ *
+ * var elementA = new CKEDITOR.dom.element( nativeElement );
+ * elementA.getPrivate().value = 1;
+ * ...
+ * var elementB = new CKEDITOR.dom.element( nativeElement );
+ * elementB.getPrivate().value; // 1
+ *
+ * @returns {Object} The private object.
+ */
+ getPrivate: function() {
var priv;
- // Get the main private function from the custom data. Create it if not
- // defined.
+ // Get the main private object from the custom data. Create it if not defined.
if ( !( priv = this.getCustomData( '_' ) ) )
this.setCustomData( '_', ( priv = {} ) );
return priv;
},
- /** @ignore */
- on : function( eventName )
- {
+ // Docs inherited from event.
+ on: function( eventName ) {
// We customize the "on" function here. The basic idea is that we'll have
// only one listener for a native event, which will then call all listeners
// set to the event.
@@ -73,15 +80,13 @@ CKEDITOR.dom.domObject.prototype = (function()
// Get the listeners holder object.
var nativeListeners = this.getCustomData( '_cke_nativeListeners' );
- if ( !nativeListeners )
- {
+ if ( !nativeListeners ) {
nativeListeners = {};
this.setCustomData( '_cke_nativeListeners', nativeListeners );
}
// Check if we have a listener for that event.
- if ( !nativeListeners[ eventName ] )
- {
+ if ( !nativeListeners[ eventName ] ) {
var listener = nativeListeners[ eventName ] = getNativeListener( this, eventName );
if ( this.$.addEventListener )
@@ -94,19 +99,16 @@ CKEDITOR.dom.domObject.prototype = (function()
return CKEDITOR.event.prototype.on.apply( this, arguments );
},
- /** @ignore */
- removeListener : function( eventName )
- {
+ // Docs inherited from event.
+ removeListener: function( eventName ) {
// Call the original implementation.
CKEDITOR.event.prototype.removeListener.apply( this, arguments );
// If we don't have listeners for this event, clean the DOM up.
- if ( !this.hasListeners( eventName ) )
- {
+ if ( !this.hasListeners( eventName ) ) {
var nativeListeners = this.getCustomData( '_cke_nativeListeners' );
var listener = nativeListeners && nativeListeners[ eventName ];
- if ( listener )
- {
+ if ( listener ) {
if ( this.$.removeEventListener )
this.$.removeEventListener( eventName, listener, false );
else if ( this.$.detachEvent )
@@ -119,14 +121,13 @@ CKEDITOR.dom.domObject.prototype = (function()
/**
* Removes any listener set on this object.
+ *
* To avoid memory leaks we must assure that there are no
* references left after the object is no longer needed.
*/
- removeAllListeners : function()
- {
+ removeAllListeners: function() {
var nativeListeners = this.getCustomData( '_cke_nativeListeners' );
- for ( var eventName in nativeListeners )
- {
+ for ( var eventName in nativeListeners ) {
var listener = nativeListeners[ eventName ];
if ( this.$.detachEvent )
this.$.detachEvent( 'on' + eventName, listener );
@@ -135,53 +136,58 @@ CKEDITOR.dom.domObject.prototype = (function()
delete nativeListeners[ eventName ];
}
+
+ // Remove events from events object so fire() method will not call
+ // listeners (#11400).
+ CKEDITOR.event.prototype.removeAllListeners.call( this );
}
};
-})();
+} )();
-(function( domObjectProto )
-{
+( function( domObjectProto ) {
var customData = {};
- CKEDITOR.on( 'reset', function()
- {
- customData = {};
- });
+ CKEDITOR.on( 'reset', function() {
+ customData = {};
+ } );
/**
* Determines whether the specified object is equal to the current object.
- * @name CKEDITOR.dom.domObject.prototype.equals
- * @function
+ *
+ * var doc = new CKEDITOR.dom.document( document );
+ * alert( doc.equals( CKEDITOR.document ) ); // true
+ * alert( doc == CKEDITOR.document ); // false
+ *
* @param {Object} object The object to compare with the current object.
- * @returns {Boolean} "true" if the object is equal.
- * @example
- * var doc = new CKEDITOR.dom.document( document );
- * alert( doc.equals( CKEDITOR.document ) ); // "true"
- * alert( doc == CKEDITOR.document ); // "false"
+ * @returns {Boolean} `true` if the object is equal.
*/
- domObjectProto.equals = function( object )
- {
- return ( object && object.$ === this.$ );
+ domObjectProto.equals = function( object ) {
+ // Try/Catch to avoid IE permission error when object is from different document.
+ try {
+ return ( object && object.$ === this.$ );
+ } catch ( er ) {
+ return false;
+ }
};
/**
* Sets a data slot value for this object. These values are shared by all
* instances pointing to that same DOM object.
- * Note: The created data slot is only guarantied to be available on this unique dom node,
- * thus any wish to continue access it from other element clones (either created by clone node or from innerHtml)
- * will fail, for such usage, please use {@link CKEDITOR.dom.element::setAttribute} instead.
- * @name CKEDITOR.dom.domObject.prototype.setCustomData
- * @function
+ *
+ * **Note:** The created data slot is only guarantied to be available on this unique dom node,
+ * thus any wish to continue access it from other element clones (either created by
+ * clone node or from `innerHtml`) will fail, for such usage, please use
+ * {@link CKEDITOR.dom.element#setAttribute} instead.
+ *
+ * var element = new CKEDITOR.dom.element( 'span' );
+ * element.setCustomData( 'hasCustomData', true );
+ *
* @param {String} key A key used to identify the data slot.
* @param {Object} value The value to set to the data slot.
* @returns {CKEDITOR.dom.domObject} This DOM object instance.
- * @see CKEDITOR.dom.domObject.prototype.getCustomData
- * @example
- * var element = new CKEDITOR.dom.element( 'span' );
- * element.setCustomData( 'hasCustomData', true );
+ * @chainable
*/
- domObjectProto.setCustomData = function( key, value )
- {
+ domObjectProto.setCustomData = function( key, value ) {
var expandoNumber = this.getUniqueId(),
dataSlot = customData[ expandoNumber ] || ( customData[ expandoNumber ] = {} );
@@ -192,47 +198,47 @@ CKEDITOR.dom.domObject.prototype = (function()
/**
* Gets the value set to a data slot in this object.
- * @name CKEDITOR.dom.domObject.prototype.getCustomData
- * @function
+ *
+ * var element = new CKEDITOR.dom.element( 'span' );
+ * alert( element.getCustomData( 'hasCustomData' ) ); // e.g. 'true'
+ * alert( element.getCustomData( 'nonExistingKey' ) ); // null
+ *
* @param {String} key The key used to identify the data slot.
* @returns {Object} This value set to the data slot.
- * @see CKEDITOR.dom.domObject.prototype.setCustomData
- * @example
- * var element = new CKEDITOR.dom.element( 'span' );
- * alert( element.getCustomData( 'hasCustomData' ) ); // e.g. 'true'
*/
- domObjectProto.getCustomData = function( key )
- {
+ domObjectProto.getCustomData = function( key ) {
var expandoNumber = this.$[ 'data-cke-expando' ],
dataSlot = expandoNumber && customData[ expandoNumber ];
- return dataSlot && dataSlot[ key ];
+ return ( dataSlot && key in dataSlot ) ? dataSlot[ key ] : null;
};
/**
- * @name CKEDITOR.dom.domObject.prototype.removeCustomData
+ * Removes the value in data slot under given `key`.
+ *
+ * @param {String} key
+ * @returns {Object} Removed value or `null` if not found.
*/
- domObjectProto.removeCustomData = function( key )
- {
+ domObjectProto.removeCustomData = function( key ) {
var expandoNumber = this.$[ 'data-cke-expando' ],
dataSlot = expandoNumber && customData[ expandoNumber ],
- retval = dataSlot && dataSlot[ key ];
+ retval, hadKey;
- if ( typeof retval != 'undefined' )
+ if ( dataSlot ) {
+ retval = dataSlot[ key ];
+ hadKey = key in dataSlot;
delete dataSlot[ key ];
+ }
- return retval || null;
+ return hadKey ? retval : null;
};
/**
* Removes any data stored on this object.
* To avoid memory leaks we must assure that there are no
* references left after the object is no longer needed.
- * @name CKEDITOR.dom.domObject.prototype.clearCustomData
- * @function
*/
- domObjectProto.clearCustomData = function()
- {
+ domObjectProto.clearCustomData = function() {
// Clear all event listeners
this.removeAllListeners();
@@ -243,16 +249,14 @@ CKEDITOR.dom.domObject.prototype = (function()
/**
* Gets an ID that can be used to identiquely identify this DOM object in
* the running session.
- * @name CKEDITOR.dom.domObject.prototype.getUniqueId
- * @function
+ *
* @returns {Number} A unique ID.
*/
- domObjectProto.getUniqueId = function()
- {
+ domObjectProto.getUniqueId = function() {
return this.$[ 'data-cke-expando' ] || ( this.$[ 'data-cke-expando' ] = CKEDITOR.tools.getNextNumber() );
};
// Implement CKEDITOR.event.
CKEDITOR.event.implementOn( domObjectProto );
-})( CKEDITOR.dom.domObject.prototype );
+} )( CKEDITOR.dom.domObject.prototype );
diff --git a/htdocs/includes/ckeditor/_source/core/dom/element.js b/htdocs/includes/ckeditor/_source/core/dom/element.js
index e65a8276fed..28d3c373582 100644
--- a/htdocs/includes/ckeditor/_source/core/dom/element.js
+++ b/htdocs/includes/ckeditor/_source/core/dom/element.js
@@ -1,7 +1,7 @@
-/*
-Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
-For licensing, see LICENSE.html or http://ckeditor.com/license
-*/
+/**
+ * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
+ * For licensing, see LICENSE.md or http://ckeditor.com/license
+ */
/**
* @fileOverview Defines the {@link CKEDITOR.dom.element} class, which
@@ -10,21 +10,22 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
/**
* Represents a DOM element.
- * @constructor
- * @augments CKEDITOR.dom.node
- * @param {Object|String} element A native DOM element or the element name for
- * new elements.
+ *
+ * // Create a new element.
+ * var element = new CKEDITOR.dom.element( 'span' );
+ *
+ * // Create an element based on a native DOM element.
+ * var element = new CKEDITOR.dom.element( document.getElementById( 'myId' ) );
+ *
+ * @class
+ * @extends CKEDITOR.dom.node
+ * @constructor Creates an element class instance.
+ * @param {Object/String} element A native DOM element or the element name for
+ * new elements.
* @param {CKEDITOR.dom.document} [ownerDocument] The document that will contain
- * the element in case of element creation.
- * @example
- * // Create a new <span> element.
- * var element = new CKEDITOR.dom.element( 'span' );
- * @example
- * // Create an element based on a native DOM element.
- * var element = new CKEDITOR.dom.element( document.getElementById( 'myId' ) );
+ * the element in case of element creation.
*/
-CKEDITOR.dom.element = function( element, ownerDocument )
-{
+CKEDITOR.dom.element = function( element, ownerDocument ) {
if ( typeof element == 'string' )
element = ( ownerDocument ? ownerDocument.$ : document ).createElement( element );
@@ -33,22 +34,25 @@ CKEDITOR.dom.element = function( element, ownerDocument )
};
// PACKAGER_RENAME( CKEDITOR.dom.element )
-
/**
* The the {@link CKEDITOR.dom.element} representing and element. If the
* element is a native DOM element, it will be transformed into a valid
* CKEDITOR.dom.element object.
+ *
+ * var element = new CKEDITOR.dom.element( 'span' );
+ * alert( element == CKEDITOR.dom.element.get( element ) ); // true
+ *
+ * var element = document.getElementById( 'myElement' );
+ * alert( CKEDITOR.dom.element.get( element ).getName() ); // (e.g.) 'p'
+ *
+ * @static
+ * @param {String/Object} element Element's id or name or native DOM element.
* @returns {CKEDITOR.dom.element} The transformed element.
- * @example
- * var element = new CKEDITOR.dom.element( 'span' );
- * alert( element == CKEDITOR.dom.element.get( element ) ); "true"
- * @example
- * var element = document.getElementById( 'myElement' );
- * alert( CKEDITOR.dom.element.get( element ) .getName() ); e.g. "p"
*/
-CKEDITOR.dom.element.get = function( element )
-{
- return element && ( element.$ ? element : new CKEDITOR.dom.element( element ) );
+CKEDITOR.dom.element.get = function( element ) {
+ var el = typeof element == 'string' ? document.getElementById( element ) || document.getElementsByName( element )[ 0 ] : element;
+
+ return el && ( el.$ ? el : new CKEDITOR.dom.element( el ) );
};
CKEDITOR.dom.element.prototype = new CKEDITOR.dom.node();
@@ -56,16 +60,16 @@ CKEDITOR.dom.element.prototype = new CKEDITOR.dom.node();
/**
* Creates an instance of the {@link CKEDITOR.dom.element} class based on the
* HTML representation of an element.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( 'My element ' );
+ * alert( element.getName() ); // 'strong'
+ *
+ * @static
* @param {String} html The element HTML. It should define only one element in
- * the "root" level. The "root" element can have child nodes, but not
- * siblings.
+ * the "root" level. The "root" element can have child nodes, but not siblings.
* @returns {CKEDITOR.dom.element} The element instance.
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<strong class="anyclass">My element</strong>' ) ;
- * alert( element.getName() ); // "strong"
*/
-CKEDITOR.dom.element.createFromHtml = function( html, ownerDocument )
-{
+CKEDITOR.dom.element.createFromHtml = function( html, ownerDocument ) {
var temp = new CKEDITOR.dom.element( 'div', ownerDocument );
temp.setHtml( html );
@@ -73,1734 +77,1931 @@ CKEDITOR.dom.element.createFromHtml = function( html, ownerDocument )
return temp.getFirst().remove();
};
-CKEDITOR.dom.element.setMarker = function( database, element, name, value )
-{
- var id = element.getCustomData( 'list_marker_id' ) ||
- ( element.setCustomData( 'list_marker_id', CKEDITOR.tools.getNextNumber() ).getCustomData( 'list_marker_id' ) ),
- markerNames = element.getCustomData( 'list_marker_names' ) ||
- ( element.setCustomData( 'list_marker_names', {} ).getCustomData( 'list_marker_names' ) );
- database[id] = element;
- markerNames[name] = 1;
+/**
+ * @static
+ * @todo
+ */
+CKEDITOR.dom.element.setMarker = function( database, element, name, value ) {
+ var id = element.getCustomData( 'list_marker_id' ) || ( element.setCustomData( 'list_marker_id', CKEDITOR.tools.getNextNumber() ).getCustomData( 'list_marker_id' ) ),
+ markerNames = element.getCustomData( 'list_marker_names' ) || ( element.setCustomData( 'list_marker_names', {} ).getCustomData( 'list_marker_names' ) );
+ database[ id ] = element;
+ markerNames[ name ] = 1;
return element.setCustomData( name, value );
};
-CKEDITOR.dom.element.clearAllMarkers = function( database )
-{
+/**
+ * @static
+ * @todo
+ */
+CKEDITOR.dom.element.clearAllMarkers = function( database ) {
for ( var i in database )
- CKEDITOR.dom.element.clearMarkers( database, database[i], 1 );
+ CKEDITOR.dom.element.clearMarkers( database, database[ i ], 1 );
};
-CKEDITOR.dom.element.clearMarkers = function( database, element, removeFromDatabase )
-{
+/**
+ * @static
+ * @todo
+ */
+CKEDITOR.dom.element.clearMarkers = function( database, element, removeFromDatabase ) {
var names = element.getCustomData( 'list_marker_names' ),
id = element.getCustomData( 'list_marker_id' );
for ( var i in names )
element.removeCustomData( i );
element.removeCustomData( 'list_marker_names' );
- if ( removeFromDatabase )
- {
+ if ( removeFromDatabase ) {
element.removeCustomData( 'list_marker_id' );
- delete database[id];
+ delete database[ id ];
}
};
+( function() {
-CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
- /** @lends CKEDITOR.dom.element.prototype */
- {
- /**
- * The node type. This is a constant value set to
- * {@link CKEDITOR.NODE_ELEMENT}.
- * @type Number
- * @example
- */
- type : CKEDITOR.NODE_ELEMENT,
+CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype, {
+ /**
+ * The node type. This is a constant value set to {@link CKEDITOR#NODE_ELEMENT}.
+ *
+ * @readonly
+ * @property {Number} [=CKEDITOR.NODE_ELEMENT]
+ */
+ type: CKEDITOR.NODE_ELEMENT,
- /**
- * Adds a CSS class to the element. It appends the class to the
- * already existing names.
- * @param {String} className The name of the class to be added.
- * @example
- * var element = new CKEDITOR.dom.element( 'div' );
- * element.addClass( 'classA' ); // <div class="classA">
- * element.addClass( 'classB' ); // <div class="classA classB">
- * element.addClass( 'classA' ); // <div class="classA classB">
- */
- addClass : function( className )
- {
- var c = this.$.className;
- if ( c )
- {
- var regex = new RegExp( '(?:^|\\s)' + className + '(?:\\s|$)', '' );
- if ( !regex.test( c ) )
- c += ' ' + className;
+ /**
+ * Adds a CSS class to the element. It appends the class to the
+ * already existing names.
+ *
+ * var element = new CKEDITOR.dom.element( 'div' );
+ * element.addClass( 'classA' ); //
+ * element.addClass( 'classB' ); //
+ * element.addClass( 'classA' ); //
+ *
+ * @param {String} className The name of the class to be added.
+ */
+ addClass: function( className ) {
+ var c = this.$.className;
+ if ( c ) {
+ var regex = new RegExp( '(?:^|\\s)' + className + '(?:\\s|$)', '' );
+ if ( !regex.test( c ) )
+ c += ' ' + className;
+ }
+ this.$.className = c || className;
+ },
+
+ /**
+ * Removes a CSS class name from the elements classes. Other classes
+ * remain untouched.
+ *
+ * var element = new CKEDITOR.dom.element( 'div' );
+ * element.addClass( 'classA' ); //
+ * element.addClass( 'classB' ); //
+ * element.removeClass( 'classA' ); //
+ * element.removeClass( 'classB' ); //
+ *
+ * @chainable
+ * @param {String} className The name of the class to remove.
+ */
+ removeClass: function( className ) {
+ var c = this.getAttribute( 'class' );
+ if ( c ) {
+ var regex = new RegExp( '(?:^|\\s+)' + className + '(?=\\s|$)', 'i' );
+ if ( regex.test( c ) ) {
+ c = c.replace( regex, '' ).replace( /^\s+/, '' );
+
+ if ( c )
+ this.setAttribute( 'class', c );
+ else
+ this.removeAttribute( 'class' );
}
- this.$.className = c || className;
+ }
+
+ return this;
+ },
+
+ /**
+ * Checks if element has class name.
+ *
+ * @param {String} className
+ * @returns {Boolean}
+ */
+ hasClass: function( className ) {
+ var regex = new RegExp( '(?:^|\\s+)' + className + '(?=\\s|$)', '' );
+ return regex.test( this.getAttribute( 'class' ) );
+ },
+
+ /**
+ * Append a node as a child of this element.
+ *
+ * var p = new CKEDITOR.dom.element( 'p' );
+ *
+ * var strong = new CKEDITOR.dom.element( 'strong' );
+ * p.append( strong );
+ *
+ * var em = p.append( 'em' );
+ *
+ * // Result: '
'
+ *
+ * @param {CKEDITOR.dom.node/String} node The node or element name to be appended.
+ * @param {Boolean} [toStart=false] Indicates that the element is to be appended at the start.
+ * @returns {CKEDITOR.dom.node} The appended node.
+ */
+ append: function( node, toStart ) {
+ if ( typeof node == 'string' )
+ node = this.getDocument().createElement( node );
+
+ if ( toStart )
+ this.$.insertBefore( node.$, this.$.firstChild );
+ else
+ this.$.appendChild( node.$ );
+
+ return node;
+ },
+
+ /**
+ * Append HTML as a child(ren) of this element.
+ *
+ * @param {String} html
+ */
+ appendHtml: function( html ) {
+ if ( !this.$.childNodes.length )
+ this.setHtml( html );
+ else {
+ var temp = new CKEDITOR.dom.element( 'div', this.getDocument() );
+ temp.setHtml( html );
+ temp.moveChildren( this );
+ }
+ },
+
+ /**
+ * Append text to this element.
+ *
+ * var p = new CKEDITOR.dom.element( 'p' );
+ * p.appendText( 'This is' );
+ * p.appendText( ' some text' );
+ *
+ * // Result: '
This is some text
'
+ *
+ * @param {String} text The text to be appended.
+ * @returns {CKEDITOR.dom.node} The appended node.
+ */
+ appendText: function( text ) {
+ if ( this.$.text != undefined )
+ this.$.text += text;
+ else
+ this.append( new CKEDITOR.dom.text( text ) );
+ },
+
+ /**
+ * Appends a `
` filler element to this element if the filler is not present already.
+ * By default filler is appended only if {@link CKEDITOR.env#needsBrFiller} is `true`,
+ * however when `force` is set to `true` filler will be appended regardless of the environment.
+ *
+ * @param {Boolean} [force] Append filler regardless of the environment.
+ */
+ appendBogus: function( force ) {
+ if ( !force && !( CKEDITOR.env.needsBrFiller || CKEDITOR.env.opera ) )
+ return;
+
+ var lastChild = this.getLast();
+
+ // Ignore empty/spaces text.
+ while ( lastChild && lastChild.type == CKEDITOR.NODE_TEXT && !CKEDITOR.tools.rtrim( lastChild.getText() ) )
+ lastChild = lastChild.getPrevious();
+ if ( !lastChild || !lastChild.is || !lastChild.is( 'br' ) ) {
+ var bogus = CKEDITOR.env.opera ? this.getDocument().createText( '' ) : this.getDocument().createElement( 'br' );
+
+ CKEDITOR.env.gecko && bogus.setAttribute( 'type', '_moz' );
+
+ this.append( bogus );
+ }
+ },
+
+ /**
+ * Breaks one of the ancestor element in the element position, moving
+ * this element between the broken parts.
+ *
+ * // Before breaking:
+ * //
This is some sample test text
+ * // If "element" is
and "parent" is
:
+ * // This is some sample test text
+ * element.breakParent( parent );
+ *
+ * // Before breaking:
+ * // This is some sample test text
+ * // If "element" is and "parent" is :
+ * // This is some sample test text
+ * element.breakParent( parent );
+ *
+ * @param {CKEDITOR.dom.element} parent The anscestor element to get broken.
+ */
+ breakParent: function( parent ) {
+ var range = new CKEDITOR.dom.range( this.getDocument() );
+
+ // We'll be extracting part of this element, so let's use our
+ // range to get the correct piece.
+ range.setStartAfter( this );
+ range.setEndAfter( parent );
+
+ // Extract it.
+ var docFrag = range.extractContents();
+
+ // Move the element outside the broken element.
+ range.insertNode( this.remove() );
+
+ // Re-insert the extracted piece after the element.
+ docFrag.insertAfterNode( this );
+ },
+
+ /**
+ * Checks if this element contains given node.
+ *
+ * @method
+ * @param {CKEDITOR.dom.node} node
+ * @returns {Boolean}
+ */
+ contains: CKEDITOR.env.ie || CKEDITOR.env.webkit ?
+ function( node ) {
+ var $ = this.$;
+
+ return node.type != CKEDITOR.NODE_ELEMENT ? $.contains( node.getParent().$ ) : $ != node.$ && $.contains( node.$ );
+ } : function( node ) {
+ return !!( this.$.compareDocumentPosition( node.$ ) & 16 );
},
- /**
- * Removes a CSS class name from the elements classes. Other classes
- * remain untouched.
- * @param {String} className The name of the class to remove.
- * @example
- * var element = new CKEDITOR.dom.element( 'div' );
- * element.addClass( 'classA' ); // <div class="classA">
- * element.addClass( 'classB' ); // <div class="classA classB">
- * element.removeClass( 'classA' ); // <div class="classB">
- * element.removeClass( 'classB' ); // <div>
- */
- removeClass : function( className )
- {
- var c = this.getAttribute( 'class' );
- if ( c )
- {
- var regex = new RegExp( '(?:^|\\s+)' + className + '(?=\\s|$)', 'i' );
- if ( regex.test( c ) )
- {
- c = c.replace( regex, '' ).replace( /^\s+/, '' );
+ /**
+ * Moves the selection focus to this element.
+ *
+ * var element = CKEDITOR.document.getById( 'myTextarea' );
+ * element.focus();
+ *
+ * @method
+ * @param {Boolean} defer Whether to asynchronously defer the
+ * execution by 100 ms.
+ */
+ focus: ( function() {
+ function exec() {
+ // IE throws error if the element is not visible.
+ try {
+ this.$.focus();
+ } catch ( e ) {}
+ }
- if ( c )
- this.setAttribute( 'class', c );
- else
- this.removeAttribute( 'class' );
- }
- }
- },
-
- hasClass : function( className )
- {
- var regex = new RegExp( '(?:^|\\s+)' + className + '(?=\\s|$)', '' );
- return regex.test( this.getAttribute('class') );
- },
-
- /**
- * Append a node as a child of this element.
- * @param {CKEDITOR.dom.node|String} node The node or element name to be
- * appended.
- * @param {Boolean} [toStart] Indicates that the element is to be
- * appended at the start.
- * @returns {CKEDITOR.dom.node} The appended node.
- * @example
- * var p = new CKEDITOR.dom.element( 'p' );
- *
- * var strong = new CKEDITOR.dom.element( 'strong' );
- * p.append( strong );
- *
- * var em = p.append( 'em' );
- *
- * // result: "<p><strong></strong><em></em></p>"
- */
- append : function( node, toStart )
- {
- if ( typeof node == 'string' )
- node = this.getDocument().createElement( node );
-
- if ( toStart )
- this.$.insertBefore( node.$, this.$.firstChild );
+ return function( defer ) {
+ if ( defer )
+ CKEDITOR.tools.setTimeout( exec, 100, this );
else
- this.$.appendChild( node.$ );
+ exec.call( this );
+ };
+ } )(),
- return node;
- },
+ /**
+ * Gets the inner HTML of this element.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( ' Example
' );
+ * alert( element.getHtml() ); // 'Example '
+ *
+ * @returns {String} The inner HTML of this element.
+ */
+ getHtml: function() {
+ var retval = this.$.innerHTML;
+ // Strip tags in IE. (#3341).
+ return CKEDITOR.env.ie ? retval.replace( /<\?[^>]*>/g, '' ) : retval;
+ },
- appendHtml : function( html )
- {
- if ( !this.$.childNodes.length )
- this.setHtml( html );
- else
- {
- var temp = new CKEDITOR.dom.element( 'div', this.getDocument() );
- temp.setHtml( html );
- temp.moveChildren( this );
- }
- },
+ /**
+ * Gets the outer (inner plus tags) HTML of this element.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( 'Example
' );
+ * alert( element.getOuterHtml() ); // 'Example
'
+ *
+ * @returns {String} The outer HTML of this element.
+ */
+ getOuterHtml: function() {
+ if ( this.$.outerHTML ) {
+ // IE includes the tag in the outerHTML of
+ // namespaced element. So, we must strip it here. (#3341)
+ return this.$.outerHTML.replace( /<\?[^>]*>/, '' );
+ }
- /**
- * Append text to this element.
- * @param {String} text The text to be appended.
- * @returns {CKEDITOR.dom.node} The appended node.
- * @example
- * var p = new CKEDITOR.dom.element( 'p' );
- * p.appendText( 'This is' );
- * p.appendText( ' some text' );
- *
- * // result: "<p>This is some text</p>"
- */
- appendText : function( text )
- {
- if ( this.$.text != undefined )
- this.$.text += text;
- else
- this.append( new CKEDITOR.dom.text( text ) );
- },
+ var tmpDiv = this.$.ownerDocument.createElement( 'div' );
+ tmpDiv.appendChild( this.$.cloneNode( true ) );
+ return tmpDiv.innerHTML;
+ },
- appendBogus : function()
- {
- var lastChild = this.getLast() ;
+ /**
+ * Retrieve the bounding rectangle of the current element, in pixels,
+ * relative to the upper-left corner of the browser's client area.
+ *
+ * @returns {Object} The dimensions of the DOM element including
+ * `left`, `top`, `right`, `bottom`, `width` and `height`.
+ */
+ getClientRect: function() {
+ // http://help.dottoro.com/ljvmcrrn.php
+ var rect = CKEDITOR.tools.extend( {}, this.$.getBoundingClientRect() );
- // Ignore empty/spaces text.
- while ( lastChild && lastChild.type == CKEDITOR.NODE_TEXT && !CKEDITOR.tools.rtrim( lastChild.getText() ) )
- lastChild = lastChild.getPrevious();
- if ( !lastChild || !lastChild.is || !lastChild.is( 'br' ) )
- {
- var bogus = CKEDITOR.env.opera ?
- this.getDocument().createText('') :
- this.getDocument().createElement( 'br' );
+ !rect.width && ( rect.width = rect.right - rect.left );
+ !rect.height && ( rect.height = rect.bottom - rect.top );
- CKEDITOR.env.gecko && bogus.setAttribute( 'type', '_moz' );
+ return rect;
+ },
- this.append( bogus );
- }
- },
-
- /**
- * Breaks one of the ancestor element in the element position, moving
- * this element between the broken parts.
- * @param {CKEDITOR.dom.element} parent The anscestor element to get broken.
- * @example
- * // Before breaking:
- * // <b>This <i>is some<span /> sample</i> test text</b>
- * // If "element" is <span /> and "parent" is <i>:
- * // <b>This <i>is some</i><span /><i> sample</i> test text</b>
- * element.breakParent( parent );
- * @example
- * // Before breaking:
- * // <b>This <i>is some<span /> sample</i> test text</b>
- * // If "element" is <span /> and "parent" is <b>:
- * // <b>This <i>is some</i></b><span /><b><i> sample</i> test text</b>
- * element.breakParent( parent );
- */
- breakParent : function( parent )
- {
- var range = new CKEDITOR.dom.range( this.getDocument() );
-
- // We'll be extracting part of this element, so let's use our
- // range to get the correct piece.
- range.setStartAfter( this );
- range.setEndAfter( parent );
-
- // Extract it.
- var docFrag = range.extractContents();
-
- // Move the element outside the broken element.
- range.insertNode( this.remove() );
-
- // Re-insert the extracted piece after the element.
- docFrag.insertAfterNode( this );
- },
-
- contains :
- CKEDITOR.env.ie || CKEDITOR.env.webkit ?
- function( node )
- {
+ /**
+ * Sets the inner HTML of this element.
+ *
+ * var p = new CKEDITOR.dom.element( 'p' );
+ * p.setHtml( 'Inner HTML' );
+ *
+ * // Result: 'Inner HTML
'
+ *
+ * @method
+ * @param {String} html The HTML to be set for this element.
+ * @returns {String} The inserted HTML.
+ */
+ setHtml: ( CKEDITOR.env.ie && CKEDITOR.env.version < 9 ) ?
+ // old IEs throws error on HTML manipulation (through the "innerHTML" property)
+ // on the element which resides in an DTD invalid position, e.g.
+ // fortunately it can be worked around with DOM manipulation.
+ function( html ) {
+ try {
var $ = this.$;
- return node.type != CKEDITOR.NODE_ELEMENT ?
- $.contains( node.getParent().$ ) :
- $ != node.$ && $.contains( node.$ );
+ // Fix the case when setHtml is called on detached element.
+ // HTML5 shiv used for document in which this element was created
+ // won't affect that detached element. So get document fragment with
+ // all HTML5 elements enabled and set innerHTML while this element is appended to it.
+ if ( this.getParent() )
+ return ( $.innerHTML = html );
+ else {
+ var $frag = this.getDocument()._getHtml5ShivFrag();
+ $frag.appendChild( $ );
+ $.innerHTML = html;
+ $frag.removeChild( $ );
+
+ return html;
+ }
}
- :
- function( node )
- {
- return !!( this.$.compareDocumentPosition( node.$ ) & 16 );
- },
+ catch ( e ) {
+ this.$.innerHTML = '';
- /**
- * Moves the selection focus to this element.
- * @function
- * @param {Boolean} defer Whether to asynchronously defer the
- * execution by 100 ms.
- * @example
- * var element = CKEDITOR.document.getById( 'myTextarea' );
- *
element.focus() ;
- */
- focus : ( function()
- {
- function exec()
- {
- // IE throws error if the element is not visible.
- try
- {
- this.$.focus();
- }
- catch (e)
- {}
- }
+ var temp = new CKEDITOR.dom.element( 'body', this.getDocument() );
+ temp.$.innerHTML = html;
- return function( defer )
- {
- if ( defer )
- CKEDITOR.tools.setTimeout( exec, 100, this );
- else
- exec.call( this );
+ var children = temp.getChildren();
+ while ( children.count() )
+ this.append( children.getItem( 0 ) );
+
+ return html;
+ }
+ }
+ :
+ function( html ) {
+ return ( this.$.innerHTML = html );
+ },
+
+ /**
+ * Sets the element contents as plain text.
+ *
+ * var element = new CKEDITOR.dom.element( 'div' );
+ * element.setText( 'A > B & C < D' );
+ * alert( element.innerHTML ); // 'A > B & C < D'
+ *
+ * @param {String} text The text to be set.
+ * @returns {String} The inserted text.
+ */
+ setText: function( text ) {
+ CKEDITOR.dom.element.prototype.setText = ( this.$.innerText != undefined ) ?
+ function( text ) {
+ return this.$.innerText = text;
+ } : function( text ) {
+ return this.$.textContent = text;
};
- })(),
- /**
- * Gets the inner HTML of this element.
- * @returns {String} The inner HTML of this element.
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<div><b>Example</b></div>' );
- * alert(
p.getHtml() ); // "<b>Example</b>"
- */
- getHtml : function()
- {
- var retval = this.$.innerHTML;
- // Strip tags in IE. (#3341).
- return CKEDITOR.env.ie ? retval.replace( /<\?[^>]*>/g, '' ) : retval;
- },
+ return this.setText( text );
+ },
- getOuterHtml : function()
- {
- if ( this.$.outerHTML )
- {
- // IE includes the tag in the outerHTML of
- // namespaced element. So, we must strip it here. (#3341)
- return this.$.outerHTML.replace( /<\?[^>]*>/, '' );
- }
-
- var tmpDiv = this.$.ownerDocument.createElement( 'div' );
- tmpDiv.appendChild( this.$.cloneNode( true ) );
- return tmpDiv.innerHTML;
- },
-
- /**
- * Sets the inner HTML of this element.
- * @param {String} html The HTML to be set for this element.
- * @returns {String} The inserted HTML.
- * @example
- * var p = new CKEDITOR.dom.element( 'p' );
- *
p.setHtml( '<b>Inner</b> HTML' );
- *
- * // result: "<p><b>Inner</b> HTML</p>"
- */
- setHtml : function( html )
- {
- return ( this.$.innerHTML = html );
- },
-
- /**
- * Sets the element contents as plain text.
- * @param {String} text The text to be set.
- * @returns {String} The inserted text.
- * @example
- * var element = new CKEDITOR.dom.element( 'div' );
- * element.setText( 'A > B & C < D' );
- * alert( element.innerHTML ); // "A > B & C < D"
- */
- setText : function( text )
- {
- CKEDITOR.dom.element.prototype.setText = ( this.$.innerText != undefined ) ?
- function ( text )
- {
- return this.$.innerText = text;
- } :
- function ( text )
- {
- return this.$.textContent = text;
- };
-
- return this.setText( text );
- },
-
- /**
- * Gets the value of an element attribute.
- * @function
- * @param {String} name The attribute name.
- * @returns {String} The attribute value or null if not defined.
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<input type="text" />' );
- * alert(
element.getAttribute( 'type' ) ); // "text"
- */
- getAttribute : (function()
- {
- var standard = function( name )
- {
+ /**
+ * Gets the value of an element attribute.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
' );
+ * alert( element.getAttribute( 'type' ) ); // 'text'
+ *
+ * @method
+ * @param {String} name The attribute name.
+ * @returns {String} The attribute value or null if not defined.
+ */
+ getAttribute: ( function() {
+ var standard = function( name ) {
return this.$.getAttribute( name, 2 );
};
- if ( CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) )
- {
- return function( name )
- {
- switch ( name )
- {
- case 'class':
- name = 'className';
- break;
+ if ( CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) ) {
+ return function( name ) {
+ switch ( name ) {
+ case 'class':
+ name = 'className';
+ break;
- case 'http-equiv':
- name = 'httpEquiv';
- break;
+ case 'http-equiv':
+ name = 'httpEquiv';
+ break;
- case 'name':
- return this.$.name;
+ case 'name':
+ return this.$.name;
- case 'tabindex':
- var tabIndex = standard.call( this, name );
+ case 'tabindex':
+ var tabIndex = standard.call( this, name );
- // IE returns tabIndex=0 by default for all
- // elements. For those elements,
- // getAtrribute( 'tabindex', 2 ) returns 32768
- // instead. So, we must make this check to give a
- // uniform result among all browsers.
- if ( tabIndex !== 0 && this.$.tabIndex === 0 )
- tabIndex = null;
+ // IE returns tabIndex=0 by default for all
+ // elements. For those elements,
+ // getAtrribute( 'tabindex', 2 ) returns 32768
+ // instead. So, we must make this check to give a
+ // uniform result among all browsers.
+ if ( tabIndex !== 0 && this.$.tabIndex === 0 )
+ tabIndex = null;
- return tabIndex;
- break;
+ return tabIndex;
+ break;
- case 'checked':
+ case 'checked':
{
var attr = this.$.attributes.getNamedItem( name ),
- attrValue = attr.specified ? attr.nodeValue // For value given by parser.
- : this.$.checked; // For value created via DOM interface.
+ attrValue = attr.specified ? attr.nodeValue // For value given by parser.
+ : this.$.checked; // For value created via DOM interface.
return attrValue ? 'checked' : null;
}
- case 'hspace':
- case 'value':
- return this.$[ name ];
+ case 'hspace':
+ case 'value':
+ return this.$[ name ];
- case 'style':
- // IE does not return inline styles via getAttribute(). See #2947.
- return this.$.style.cssText;
+ case 'style':
+ // IE does not return inline styles via getAttribute(). See #2947.
+ return this.$.style.cssText;
- case 'contenteditable':
- case 'contentEditable':
- return this.$.attributes.getNamedItem( 'contentEditable' ).specified ?
- this.$.getAttribute( 'contentEditable' ) : null;
- }
-
- return standard.call( this, name );
- };
- }
- else
- return standard;
- })(),
-
- getChildren : function()
- {
- return new CKEDITOR.dom.nodeList( this.$.childNodes );
- },
-
- /**
- * Gets the current computed value of one of the element CSS style
- * properties.
- * @function
- * @param {String} propertyName The style property name.
- * @returns {String} The property value.
- * @example
- * var element = new CKEDITOR.dom.element( 'span' );
- * alert(
element.getComputedStyle( 'display' ) ); // "inline"
- */
- getComputedStyle :
- CKEDITOR.env.ie ?
- function( propertyName )
- {
- return this.$.currentStyle[ CKEDITOR.tools.cssStyleToDomStyle( propertyName ) ];
+ case 'contenteditable':
+ case 'contentEditable':
+ return this.$.attributes.getNamedItem( 'contentEditable' ).specified ? this.$.getAttribute( 'contentEditable' ) : null;
}
- :
- function( propertyName )
- {
- return this.getWindow().$.getComputedStyle( this.$, '' ).getPropertyValue( propertyName );
- },
- /**
- * Gets the DTD entries for this element.
- * @returns {Object} An object containing the list of elements accepted
- * by this element.
- */
- getDtd : function()
- {
- var dtd = CKEDITOR.dtd[ this.getName() ];
-
- this.getDtd = function()
- {
- return dtd;
+ return standard.call( this, name );
};
+ } else
+ return standard;
+ } )(),
+ /**
+ * Gets the nodes list containing all children of this element.
+ *
+ * @returns {CKEDITOR.dom.nodeList}
+ */
+ getChildren: function() {
+ return new CKEDITOR.dom.nodeList( this.$.childNodes );
+ },
+
+ /**
+ * Gets the current computed value of one of the element CSS style
+ * properties.
+ *
+ * var element = new CKEDITOR.dom.element( 'span' );
+ * alert( element.getComputedStyle( 'display' ) ); // 'inline'
+ *
+ * @method
+ * @param {String} propertyName The style property name.
+ * @returns {String} The property value.
+ */
+ getComputedStyle: CKEDITOR.env.ie ?
+ function( propertyName ) {
+ return this.$.currentStyle[ CKEDITOR.tools.cssStyleToDomStyle( propertyName ) ];
+ } : function( propertyName ) {
+ var style = this.getWindow().$.getComputedStyle( this.$, null );
+ // Firefox may return null if we call the above on a hidden iframe. (#9117)
+ return style ? style.getPropertyValue( propertyName ) : '';
+ },
+
+ /**
+ * Gets the DTD entries for this element.
+ *
+ * @returns {Object} An object containing the list of elements accepted
+ * by this element.
+ */
+ getDtd: function() {
+ var dtd = CKEDITOR.dtd[ this.getName() ];
+
+ this.getDtd = function() {
return dtd;
- },
+ };
- getElementsByTag : CKEDITOR.dom.document.prototype.getElementsByTag,
+ return dtd;
+ },
- /**
- * Gets the computed tabindex for this element.
- * @function
- * @returns {Number} The tabindex value.
- * @example
- * var element = CKEDITOR.document.getById( 'myDiv' );
- * alert(
element.getTabIndex() ); // e.g. "-1"
- */
- getTabIndex :
- CKEDITOR.env.ie ?
- function()
- {
- var tabIndex = this.$.tabIndex;
+ /**
+ * Gets all this element's descendants having given tag name.
+ *
+ * @method
+ * @param {String} tagName
+ */
+ getElementsByTag: CKEDITOR.dom.document.prototype.getElementsByTag,
- // IE returns tabIndex=0 by default for all elements. In
- // those cases we must check that the element really has
- // the tabindex attribute set to zero, or it is one of
- // those element that should have zero by default.
- if ( tabIndex === 0 && !CKEDITOR.dtd.$tabIndex[ this.getName() ] && parseInt( this.getAttribute( 'tabindex' ), 10 ) !== 0 )
- tabIndex = -1;
+ /**
+ * Gets the computed tabindex for this element.
+ *
+ * var element = CKEDITOR.document.getById( 'myDiv' );
+ * alert( element.getTabIndex() ); // (e.g.) '-1'
+ *
+ * @method
+ * @returns {Number} The tabindex value.
+ */
+ getTabIndex: CKEDITOR.env.ie ?
+ function() {
+ var tabIndex = this.$.tabIndex;
- return tabIndex;
- }
- : CKEDITOR.env.webkit ?
- function()
- {
- var tabIndex = this.$.tabIndex;
+ // IE returns tabIndex=0 by default for all elements. In
+ // those cases we must check that the element really has
+ // the tabindex attribute set to zero, or it is one of
+ // those element that should have zero by default.
+ if ( tabIndex === 0 && !CKEDITOR.dtd.$tabIndex[ this.getName() ] && parseInt( this.getAttribute( 'tabindex' ), 10 ) !== 0 )
+ tabIndex = -1;
- // Safari returns "undefined" for elements that should not
- // have tabindex (like a div). So, we must try to get it
- // from the attribute.
- // https://bugs.webkit.org/show_bug.cgi?id=20596
- if ( tabIndex == undefined )
- {
- tabIndex = parseInt( this.getAttribute( 'tabindex' ), 10 );
+ return tabIndex;
+ } : CKEDITOR.env.webkit ?
+ function() {
+ var tabIndex = this.$.tabIndex;
- // If the element don't have the tabindex attribute,
- // then we should return -1.
- if ( isNaN( tabIndex ) )
- tabIndex = -1;
- }
+ // Safari returns "undefined" for elements that should not
+ // have tabindex (like a div). So, we must try to get it
+ // from the attribute.
+ // https://bugs.webkit.org/show_bug.cgi?id=20596
+ if ( tabIndex == undefined ) {
+ tabIndex = parseInt( this.getAttribute( 'tabindex' ), 10 );
- return tabIndex;
- }
- :
- function()
- {
- return this.$.tabIndex;
- },
-
- /**
- * Gets the text value of this element.
- *
- * Only in IE (which uses innerText), <br> will cause linebreaks,
- * and sucessive whitespaces (including line breaks) will be reduced to
- * a single space. This behavior is ok for us, for now. It may change
- * in the future.
- * @returns {String} The text value.
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<div>Sample <i>text</i>.</div>' );
- * alert(
element.getText() ); // "Sample text."
- */
- getText : function()
- {
- return this.$.textContent || this.$.innerText || '';
- },
-
- /**
- * Gets the window object that contains this element.
- * @returns {CKEDITOR.dom.window} The window object.
- * @example
- */
- getWindow : function()
- {
- return this.getDocument().getWindow();
- },
-
- /**
- * Gets the value of the "id" attribute of this element.
- * @returns {String} The element id, or null if not available.
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<p id="myId"></p>' );
- * alert(
element.getId() ); // "myId"
- */
- getId : function()
- {
- return this.$.id || null;
- },
-
- /**
- * Gets the value of the "name" attribute of this element.
- * @returns {String} The element name, or null if not available.
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<input name="myName"></input>' );
- * alert(
element.getNameAtt() ); // "myName"
- */
- getNameAtt : function()
- {
- return this.$.name || null;
- },
-
- /**
- * Gets the element name (tag name). The returned name is guaranteed to
- * be always full lowercased.
- * @returns {String} The element name.
- * @example
- * var element = new CKEDITOR.dom.element( 'span' );
- * alert(
element.getName() ); // "span"
- */
- getName : function()
- {
- // Cache the lowercased name inside a closure.
- var nodeName = this.$.nodeName.toLowerCase();
-
- if ( CKEDITOR.env.ie && ! ( document.documentMode > 8 ) )
- {
- var scopeName = this.$.scopeName;
- if ( scopeName != 'HTML' )
- nodeName = scopeName.toLowerCase() + ':' + nodeName;
+ // If the element don't have the tabindex attribute,
+ // then we should return -1.
+ if ( isNaN( tabIndex ) )
+ tabIndex = -1;
}
- return (
- this.getName = function()
- {
- return nodeName;
- })();
+ return tabIndex;
+ } : function() {
+ return this.$.tabIndex;
},
- /**
- * Gets the value set to this element. This value is usually available
- * for form field elements.
- * @returns {String} The element value.
- */
- getValue : function()
+ /**
+ * Gets the text value of this element.
+ *
+ * Only in IE (which uses innerText), `
` will cause linebreaks,
+ * and sucessive whitespaces (including line breaks) will be reduced to
+ * a single space. This behavior is ok for us, for now. It may change
+ * in the future.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
Sample text .
' );
+ * alert(
element.getText() ); // 'Sample text.'
+ *
+ * @returns {String} The text value.
+ */
+ getText: function() {
+ return this.$.textContent || this.$.innerText || '';
+ },
+
+ /**
+ * Gets the window object that contains this element.
+ *
+ * @returns {CKEDITOR.dom.window} The window object.
+ */
+ getWindow: function() {
+ return this.getDocument().getWindow();
+ },
+
+ /**
+ * Gets the value of the `id` attribute of this element.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
' );
+ * alert( element.getId() ); // 'myId'
+ *
+ * @returns {String} The element id, or null if not available.
+ */
+ getId: function() {
+ return this.$.id || null;
+ },
+
+ /**
+ * Gets the value of the `name` attribute of this element.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
' );
+ * alert(
element.getNameAtt() ); // 'myName'
+ *
+ * @returns {String} The element name, or null if not available.
+ */
+ getNameAtt: function() {
+ return this.$.name || null;
+ },
+
+ /**
+ * Gets the element name (tag name). The returned name is guaranteed to
+ * be always full lowercased.
+ *
+ * var element = new CKEDITOR.dom.element( 'span' );
+ * alert( element.getName() ); // 'span'
+ *
+ * @returns {String} The element name.
+ */
+ getName: function() {
+ // Cache the lowercased name inside a closure.
+ var nodeName = this.$.nodeName.toLowerCase();
+
+ if ( CKEDITOR.env.ie && !( document.documentMode > 8 ) ) {
+ var scopeName = this.$.scopeName;
+ if ( scopeName != 'HTML' )
+ nodeName = scopeName.toLowerCase() + ':' + nodeName;
+ }
+
+ return ( this.getName = function() {
+ return nodeName;
+ } )();
+ },
+
+ /**
+ * Gets the value set to this element. This value is usually available
+ * for form field elements.
+ *
+ * @returns {String} The element value.
+ */
+ getValue: function() {
+ return this.$.value;
+ },
+
+ /**
+ * Gets the first child node of this element.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
Example
' );
+ * var first = element.getFirst();
+ * alert( first.getName() ); // 'b'
+ *
+ * @param {Function} evaluator Filtering the result node.
+ * @returns {CKEDITOR.dom.node} The first child node or null if not available.
+ */
+ getFirst: function( evaluator ) {
+ var first = this.$.firstChild,
+ retval = first && new CKEDITOR.dom.node( first );
+ if ( retval && evaluator && !evaluator( retval ) )
+ retval = retval.getNext( evaluator );
+
+ return retval;
+ },
+
+ /**
+ * See {@link #getFirst}.
+ *
+ * @param {Function} evaluator Filtering the result node.
+ * @returns {CKEDITOR.dom.node}
+ */
+ getLast: function( evaluator ) {
+ var last = this.$.lastChild,
+ retval = last && new CKEDITOR.dom.node( last );
+ if ( retval && evaluator && !evaluator( retval ) )
+ retval = retval.getPrevious( evaluator );
+
+ return retval;
+ },
+
+ /**
+ * Gets CSS style value.
+ *
+ * @param {String} name The CSS property name.
+ * @returns {String} Style value.
+ */
+ getStyle: function( name ) {
+ return this.$.style[ CKEDITOR.tools.cssStyleToDomStyle( name ) ];
+ },
+
+ /**
+ * Checks if the element name matches the specified criteria.
+ *
+ * var element = new CKEDITOR.element( 'span' );
+ * alert( element.is( 'span' ) ); // true
+ * alert( element.is( 'p', 'span' ) ); // true
+ * alert( element.is( 'p' ) ); // false
+ * alert( element.is( 'p', 'div' ) ); // false
+ * alert( element.is( { p:1,span:1 } ) ); // true
+ *
+ * @param {String.../Object} name One or more names to be checked, or a {@link CKEDITOR.dtd} object.
+ * @returns {Boolean} `true` if the element name matches any of the names.
+ */
+ is: function() {
+ var name = this.getName();
+
+ // Check against the specified DTD liternal.
+ if ( typeof arguments[ 0 ] == 'object' )
+ return !!arguments[ 0 ][ name ];
+
+ // Check for tag names
+ for ( var i = 0; i < arguments.length; i++ ) {
+ if ( arguments[ i ] == name )
+ return true;
+ }
+ return false;
+ },
+
+ /**
+ * Decide whether one element is able to receive cursor.
+ *
+ * @param {Boolean} [textCursor=true] Only consider element that could receive text child.
+ */
+ isEditable: function( textCursor ) {
+ var name = this.getName();
+
+ if ( this.isReadOnly() || this.getComputedStyle( 'display' ) == 'none' ||
+ this.getComputedStyle( 'visibility' ) == 'hidden' ||
+ CKEDITOR.dtd.$nonEditable[ name ] ||
+ CKEDITOR.dtd.$empty[ name ] ||
+ ( this.is( 'a' ) &&
+ ( this.data( 'cke-saved-name' ) || this.hasAttribute( 'name' ) ) &&
+ !this.getChildCount()
+ ) )
{
- return this.$.value;
- },
-
- /**
- * Gets the first child node of this element.
- * @param {Function} evaluator Filtering the result node.
- * @returns {CKEDITOR.dom.node} The first child node or null if not
- * available.
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<div><b>Example</b></div>' );
- * var first =
element.getFirst() ;
- * alert( first.getName() ); // "b"
- */
- getFirst : function( evaluator )
- {
- var first = this.$.firstChild,
- retval = first && new CKEDITOR.dom.node( first );
- if ( retval && evaluator && !evaluator( retval ) )
- retval = retval.getNext( evaluator );
-
- return retval;
- },
-
- /**
- * @param {Function} evaluator Filtering the result node.
- */
- getLast : function( evaluator )
- {
- var last = this.$.lastChild,
- retval = last && new CKEDITOR.dom.node( last );
- if ( retval && evaluator && !evaluator( retval ) )
- retval = retval.getPrevious( evaluator );
-
- return retval;
- },
-
- getStyle : function( name )
- {
- return this.$.style[ CKEDITOR.tools.cssStyleToDomStyle( name ) ];
- },
-
- /**
- * Checks if the element name matches one or more names.
- * @param {String} name[,name[,...]] One or more names to be checked.
- * @returns {Boolean} true if the element name matches any of the names.
- * @example
- * var element = new CKEDITOR.element( 'span' );
- * alert(
element.is( 'span' ) ); "true"
- * alert(
element.is( 'p', 'span' ) ); "true"
- * alert(
element.is( 'p' ) ); "false"
- * alert(
element.is( 'p', 'div' ) ); "false"
- */
- is : function()
- {
- var name = this.getName();
- for ( var i = 0 ; i < arguments.length ; i++ )
- {
- if ( arguments[ i ] == name )
- return true;
- }
return false;
- },
+ }
- /**
- * Decide whether one element is able to receive cursor.
- * @param {Boolean} [textCursor=true] Only consider element that could receive text child.
- */
- isEditable : function( textCursor )
- {
- var name = this.getName();
+ if ( textCursor !== false ) {
+ // Get the element DTD (defaults to span for unknown elements).
+ var dtd = CKEDITOR.dtd[ name ] || CKEDITOR.dtd.span;
+ // In the DTD # == text node.
+ return !!( dtd && dtd[ '#' ] );
+ }
- if ( this.isReadOnly()
- || this.getComputedStyle( 'display' ) == 'none'
- || this.getComputedStyle( 'visibility' ) == 'hidden'
- || this.is( 'a' ) && this.data( 'cke-saved-name' ) && !this.getChildCount()
- || CKEDITOR.dtd.$nonEditable[ name ]
- || CKEDITOR.dtd.$empty[ name ] )
- {
- return false;
+ return true;
+ },
+
+ /**
+ * Compare this element's inner html, tag name, attributes, etc. with other one.
+ *
+ * See [W3C's DOM Level 3 spec - node#isEqualNode](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-isEqualNode)
+ * for more details.
+ *
+ * @param {CKEDITOR.dom.element} otherElement Element to compare.
+ * @returns {Boolean}
+ */
+ isIdentical: function( otherElement ) {
+ // do shallow clones, but with IDs
+ var thisEl = this.clone( 0, 1 ),
+ otherEl = otherElement.clone( 0, 1 );
+
+ // Remove distractions.
+ thisEl.removeAttributes( [ '_moz_dirty', 'data-cke-expando', 'data-cke-saved-href', 'data-cke-saved-name' ] );
+ otherEl.removeAttributes( [ '_moz_dirty', 'data-cke-expando', 'data-cke-saved-href', 'data-cke-saved-name' ] );
+
+ // Native comparison available.
+ if ( thisEl.$.isEqualNode ) {
+ // Styles order matters.
+ thisEl.$.style.cssText = CKEDITOR.tools.normalizeCssText( thisEl.$.style.cssText );
+ otherEl.$.style.cssText = CKEDITOR.tools.normalizeCssText( otherEl.$.style.cssText );
+ return thisEl.$.isEqualNode( otherEl.$ );
+ } else {
+ thisEl = thisEl.getOuterHtml();
+ otherEl = otherEl.getOuterHtml();
+
+ // Fix tiny difference between link href in older IEs.
+ if ( CKEDITOR.env.ie && CKEDITOR.env.version < 9 && this.is( 'a' ) ) {
+ var parent = this.getParent();
+ if ( parent.type == CKEDITOR.NODE_ELEMENT ) {
+ var el = parent.clone();
+ el.setHtml( thisEl ), thisEl = el.getHtml();
+ el.setHtml( otherEl ), otherEl = el.getHtml();
+ }
}
- if ( textCursor !== false )
- {
- // Get the element DTD (defaults to span for unknown elements).
- var dtd = CKEDITOR.dtd[ name ] || CKEDITOR.dtd.span;
- // In the DTD # == text node.
- return ( dtd && dtd[ '#'] );
- }
+ return thisEl == otherEl;
+ }
+ },
- return true;
- },
+ /**
+ * Checks if this element is visible. May not work if the element is
+ * child of an element with visibility set to `hidden`, but works well
+ * on the great majority of cases.
+ *
+ * @returns {Boolean} True if the element is visible.
+ */
+ isVisible: function() {
+ var isVisible = ( this.$.offsetHeight || this.$.offsetWidth ) && this.getComputedStyle( 'visibility' ) != 'hidden',
+ elementWindow, elementWindowFrame;
- isIdentical : function( otherElement )
- {
- if ( this.getName() != otherElement.getName() )
+ // Webkit and Opera report non-zero offsetHeight despite that
+ // element is inside an invisible iframe. (#4542)
+ if ( isVisible && ( CKEDITOR.env.webkit || CKEDITOR.env.opera ) ) {
+ elementWindow = this.getWindow();
+
+ if ( !elementWindow.equals( CKEDITOR.document.getWindow() ) && ( elementWindowFrame = elementWindow.$.frameElement ) )
+ isVisible = new CKEDITOR.dom.element( elementWindowFrame ).isVisible();
+
+ }
+
+ return !!isVisible;
+ },
+
+ /**
+ * Whether it's an empty inline elements which has no visual impact when removed.
+ *
+ * @returns {Boolean}
+ */
+ isEmptyInlineRemoveable: function() {
+ if ( !CKEDITOR.dtd.$removeEmpty[ this.getName() ] )
+ return false;
+
+ var children = this.getChildren();
+ for ( var i = 0, count = children.count(); i < count; i++ ) {
+ var child = children.getItem( i );
+
+ if ( child.type == CKEDITOR.NODE_ELEMENT && child.data( 'cke-bookmark' ) )
+ continue;
+
+ if ( child.type == CKEDITOR.NODE_ELEMENT && !child.isEmptyInlineRemoveable() || child.type == CKEDITOR.NODE_TEXT && CKEDITOR.tools.trim( child.getText() ) )
return false;
- var thisAttribs = this.$.attributes,
- otherAttribs = otherElement.$.attributes;
+ }
+ return true;
+ },
- var thisLength = thisAttribs.length,
- otherLength = otherAttribs.length;
+ /**
+ * Checks if the element has any defined attributes.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
Example
' );
+ * alert( element.hasAttributes() ); // true
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
Example
' );
+ * alert( element.hasAttributes() ); // false
+ *
+ * @method
+ * @returns {Boolean} True if the element has attributes.
+ */
+ hasAttributes: CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) ?
+ function() {
+ var attributes = this.$.attributes;
- for ( var i = 0 ; i < thisLength ; i++ )
- {
- var attribute = thisAttribs[ i ];
+ for ( var i = 0; i < attributes.length; i++ ) {
+ var attribute = attributes[ i ];
- if ( attribute.nodeName == '_moz_dirty' )
- continue;
+ switch ( attribute.nodeName ) {
+ case 'class':
+ // IE has a strange bug. If calling removeAttribute('className'),
+ // the attributes collection will still contain the "class"
+ // attribute, which will be marked as "specified", even if the
+ // outerHTML of the element is not displaying the class attribute.
+ // Note : I was not able to reproduce it outside the editor,
+ // but I've faced it while working on the TC of #1391.
+ if ( this.getAttribute( 'class' ) )
+ return true;
- if ( ( !CKEDITOR.env.ie || ( attribute.specified && attribute.nodeName != 'data-cke-expando' ) ) && attribute.nodeValue != otherElement.getAttribute( attribute.nodeName ) )
- return false;
- }
+ // Attributes to be ignored.
+ case 'data-cke-expando':
+ continue;
- // For IE, we have to for both elements, because it's difficult to
- // know how the atttibutes collection is organized in its DOM.
- if ( CKEDITOR.env.ie )
- {
- for ( i = 0 ; i < otherLength ; i++ )
- {
- attribute = otherAttribs[ i ];
- if ( attribute.specified && attribute.nodeName != 'data-cke-expando'
- && attribute.nodeValue != this.getAttribute( attribute.nodeName ) )
- return false;
+ /*jsl:fallthru*/
+
+ default:
+ if ( attribute.specified )
+ return true;
}
}
- return true;
+ return false;
+ } : function() {
+ var attrs = this.$.attributes,
+ attrsNum = attrs.length;
+
+ // The _moz_dirty attribute might get into the element after pasting (#5455)
+ var execludeAttrs = { 'data-cke-expando': 1, _moz_dirty: 1 };
+
+ return attrsNum > 0 && ( attrsNum > 2 || !execludeAttrs[ attrs[ 0 ].nodeName ] || ( attrsNum == 2 && !execludeAttrs[ attrs[ 1 ].nodeName ] ) );
},
- /**
- * Checks if this element is visible. May not work if the element is
- * child of an element with visibility set to "hidden", but works well
- * on the great majority of cases.
- * @return {Boolean} True if the element is visible.
- */
- isVisible : function()
- {
- var isVisible = ( this.$.offsetHeight || this.$.offsetWidth ) && this.getComputedStyle( 'visibility' ) != 'hidden',
- elementWindow,
- elementWindowFrame;
+ /**
+ * Checks if the specified attribute is defined for this element.
+ *
+ * @method
+ * @param {String} name The attribute name.
+ * @returns {Boolean} `true` if the specified attribute is defined.
+ */
+ hasAttribute: ( function() {
+ function standard( name ) {
+ var $attr = this.$.attributes.getNamedItem( name );
+ return !!( $attr && $attr.specified );
+ }
- // Webkit and Opera report non-zero offsetHeight despite that
- // element is inside an invisible iframe. (#4542)
- if ( isVisible && ( CKEDITOR.env.webkit || CKEDITOR.env.opera ) )
- {
- elementWindow = this.getWindow();
+ return ( CKEDITOR.env.ie && CKEDITOR.env.version < 8 ) ?
+ function( name ) {
+ // On IE < 8 the name attribute cannot be retrieved
+ // right after the element creation and setting the
+ // name with setAttribute.
+ if ( name == 'name' )
+ return !!this.$.name;
- if ( !elementWindow.equals( CKEDITOR.document.getWindow() )
- && ( elementWindowFrame = elementWindow.$.frameElement ) )
- {
- isVisible = new CKEDITOR.dom.element( elementWindowFrame ).isVisible();
- }
- }
+ return standard.call( this, name );
+ } : standard;
+ } )(),
- return !!isVisible;
- },
+ /**
+ * Hides this element (sets `display: none`).
+ *
+ * var element = CKEDITOR.document.getById( 'myElement' );
+ * element.hide();
+ */
+ hide: function() {
+ this.setStyle( 'display', 'none' );
+ },
- /**
- * Whether it's an empty inline elements which has no visual impact when removed.
- */
- isEmptyInlineRemoveable : function()
- {
- if ( !CKEDITOR.dtd.$removeEmpty[ this.getName() ] )
- return false;
+ /**
+ * Moves this element's children to the target element.
+ *
+ * @param {CKEDITOR.dom.element} target
+ * @param {Boolean} [toStart=false] Insert moved children at the
+ * beginning of the target element.
+ */
+ moveChildren: function( target, toStart ) {
+ var $ = this.$;
+ target = target.$;
- var children = this.getChildren();
- for ( var i = 0, count = children.count(); i < count; i++ )
- {
- var child = children.getItem( i );
+ if ( $ == target )
+ return;
- if ( child.type == CKEDITOR.NODE_ELEMENT && child.data( 'cke-bookmark' ) )
- continue;
+ var child;
- if ( child.type == CKEDITOR.NODE_ELEMENT && !child.isEmptyInlineRemoveable()
- || child.type == CKEDITOR.NODE_TEXT && CKEDITOR.tools.trim( child.getText() ) )
- {
- return false;
- }
- }
- return true;
- },
+ if ( toStart ) {
+ while ( ( child = $.lastChild ) )
+ target.insertBefore( $.removeChild( child ), target.firstChild );
+ } else {
+ while ( ( child = $.firstChild ) )
+ target.appendChild( $.removeChild( child ) );
+ }
+ },
- /**
- * Checks if the element has any defined attributes.
- * @function
- * @returns {Boolean} True if the element has attributes.
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<div title="Test">Example</div>' );
- * alert(
element.hasAttributes() ); // "true"
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '<div>Example</div>' );
- * alert(
element.hasAttributes() ); // "false"
- */
- hasAttributes :
- CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) ?
- function()
- {
- var attributes = this.$.attributes;
+ /**
+ * Merges sibling elements that are identical to this one.
+ *
+ * Identical child elements are also merged. For example:
+ *
+ *
=>
+ *
+ * @method
+ * @param {Boolean} [inlineOnly=true] Allow only inline elements to be merged.
+ */
+ mergeSiblings: ( function() {
+ function mergeElements( element, sibling, isNext ) {
+ if ( sibling && sibling.type == CKEDITOR.NODE_ELEMENT ) {
+ // Jumping over bookmark nodes and empty inline elements, e.g.
,
+ // queuing them to be moved later. (#5567)
+ var pendingNodes = [];
- for ( var i = 0 ; i < attributes.length ; i++ )
- {
- var attribute = attributes[i];
-
- switch ( attribute.nodeName )
- {
- case 'class' :
- // IE has a strange bug. If calling removeAttribute('className'),
- // the attributes collection will still contain the "class"
- // attribute, which will be marked as "specified", even if the
- // outerHTML of the element is not displaying the class attribute.
- // Note : I was not able to reproduce it outside the editor,
- // but I've faced it while working on the TC of #1391.
- if ( this.getAttribute( 'class' ) )
- return true;
-
- // Attributes to be ignored.
- case 'data-cke-expando' :
- continue;
-
- /*jsl:fallthru*/
-
- default :
- if ( attribute.specified )
- return true;
- }
- }
-
- return false;
- }
- :
- function()
- {
- var attrs = this.$.attributes,
- attrsNum = attrs.length;
-
- // The _moz_dirty attribute might get into the element after pasting (#5455)
- var execludeAttrs = { 'data-cke-expando' : 1, _moz_dirty : 1 };
-
- return attrsNum > 0 &&
- ( attrsNum > 2 ||
- !execludeAttrs[ attrs[0].nodeName ] ||
- ( attrsNum == 2 && !execludeAttrs[ attrs[1].nodeName ] ) );
- },
-
- /**
- * Checks if the specified attribute is defined for this element.
- * @returns {Boolean} True if the specified attribute is defined.
- * @param {String} name The attribute name.
- * @example
- */
- hasAttribute : (function()
- {
- function standard( name )
- {
- var $attr = this.$.attributes.getNamedItem( name );
- return !!( $attr && $attr.specified );
- }
-
- return ( CKEDITOR.env.ie && CKEDITOR.env.version < 8 ) ?
- function( name )
- {
- // On IE < 8 the name attribute cannot be retrieved
- // right after the element creation and setting the
- // name with setAttribute.
- if ( name == 'name' )
- return !!this.$.name;
-
- return standard.call( this, name );
- }
- :
- standard;
- })(),
-
- /**
- * Hides this element (display:none).
- * @example
- * var element = CKEDITOR.dom.element.getById( 'myElement' );
- *
element.hide() ;
- */
- hide : function()
- {
- this.setStyle( 'display', 'none' );
- },
-
- moveChildren : function( target, toStart )
- {
- var $ = this.$;
- target = target.$;
-
- if ( $ == target )
- return;
-
- var child;
-
- if ( toStart )
- {
- while ( ( child = $.lastChild ) )
- target.insertBefore( $.removeChild( child ), target.firstChild );
- }
- else
- {
- while ( ( child = $.firstChild ) )
- target.appendChild( $.removeChild( child ) );
- }
- },
-
- /**
- * Merges sibling elements that are identical to this one.
- *
- * Identical child elements are also merged. For example:
- * <b><i></i></b><b><i></i></b> => <b><i></i></b>
- * @function
- * @param {Boolean} [inlineOnly] Allow only inline elements to be merged. Defaults to "true".
- */
- mergeSiblings : ( function()
- {
- function mergeElements( element, sibling, isNext )
- {
- if ( sibling && sibling.type == CKEDITOR.NODE_ELEMENT )
- {
- // Jumping over bookmark nodes and empty inline elements, e.g.
,
- // queuing them to be moved later. (#5567)
- var pendingNodes = [];
-
- while ( sibling.data( 'cke-bookmark' )
- || sibling.isEmptyInlineRemoveable() )
- {
- pendingNodes.push( sibling );
- sibling = isNext ? sibling.getNext() : sibling.getPrevious();
- if ( !sibling || sibling.type != CKEDITOR.NODE_ELEMENT )
- return;
- }
-
- if ( element.isIdentical( sibling ) )
- {
- // Save the last child to be checked too, to merge things like
- //
=>
- var innerSibling = isNext ? element.getLast() : element.getFirst();
-
- // Move pending nodes first into the target element.
- while( pendingNodes.length )
- pendingNodes.shift().move( element, !isNext );
-
- sibling.moveChildren( element, !isNext );
- sibling.remove();
-
- // Now check the last inner child (see two comments above).
- if ( innerSibling && innerSibling.type == CKEDITOR.NODE_ELEMENT )
- innerSibling.mergeSiblings();
- }
- }
- }
-
- return function( inlineOnly )
- {
- if ( ! ( inlineOnly === false
- || CKEDITOR.dtd.$removeEmpty[ this.getName() ]
- || this.is( 'a' ) ) ) // Merge empty links and anchors also. (#5567)
- {
+ while ( sibling.data( 'cke-bookmark' ) || sibling.isEmptyInlineRemoveable() ) {
+ pendingNodes.push( sibling );
+ sibling = isNext ? sibling.getNext() : sibling.getPrevious();
+ if ( !sibling || sibling.type != CKEDITOR.NODE_ELEMENT )
return;
- }
+ }
- mergeElements( this, this.getNext(), true );
- mergeElements( this, this.getPrevious() );
- };
- } )(),
+ if ( element.isIdentical( sibling ) ) {
+ // Save the last child to be checked too, to merge things like
+ //
=>
+ var innerSibling = isNext ? element.getLast() : element.getFirst();
- /**
- * Shows this element (display it).
- * @example
- * var element = CKEDITOR.dom.element.getById( 'myElement' );
- *
element.show() ;
- */
- show : function()
- {
- this.setStyles(
- {
- display : '',
- visibility : ''
- });
- },
+ // Move pending nodes first into the target element.
+ while ( pendingNodes.length )
+ pendingNodes.shift().move( element, !isNext );
- /**
- * Sets the value of an element attribute.
- * @param {String} name The name of the attribute.
- * @param {String} value The value to be set to the attribute.
- * @function
- * @returns {CKEDITOR.dom.element} This element instance.
- * @example
- * var element = CKEDITOR.dom.element.getById( 'myElement' );
- *
element.setAttribute( 'class', 'myClass' ) ;
- *
element.setAttribute( 'title', 'This is an example' ) ;
- */
- setAttribute : (function()
- {
- var standard = function( name, value )
+ sibling.moveChildren( element, !isNext );
+ sibling.remove();
+
+ // Now check the last inner child (see two comments above).
+ if ( innerSibling && innerSibling.type == CKEDITOR.NODE_ELEMENT )
+ innerSibling.mergeSiblings();
+ }
+ }
+ }
+
+ return function( inlineOnly ) {
+ if ( !( inlineOnly === false || CKEDITOR.dtd.$removeEmpty[ this.getName() ] || this.is( 'a' ) ) ) // Merge empty links and anchors also. (#5567)
{
+ return;
+ }
+
+ mergeElements( this, this.getNext(), true );
+ mergeElements( this, this.getPrevious() );
+ };
+ } )(),
+
+ /**
+ * Shows this element (displays it).
+ *
+ * var element = CKEDITOR.document.getById( 'myElement' );
+ * element.show();
+ */
+ show: function() {
+ this.setStyles( {
+ display: '',
+ visibility: ''
+ } );
+ },
+
+ /**
+ * Sets the value of an element attribute.
+ *
+ * var element = CKEDITOR.document.getById( 'myElement' );
+ * element.setAttribute( 'class', 'myClass' );
+ * element.setAttribute( 'title', 'This is an example' );
+ *
+ * @method
+ * @param {String} name The name of the attribute.
+ * @param {String} value The value to be set to the attribute.
+ * @returns {CKEDITOR.dom.element} This element instance.
+ */
+ setAttribute: ( function() {
+ var standard = function( name, value ) {
this.$.setAttribute( name, value );
return this;
};
- if ( CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) )
- {
- return function( name, value )
- {
- if ( name == 'class' )
- this.$.className = value;
- else if ( name == 'style' )
- this.$.style.cssText = value;
- else if ( name == 'tabindex' ) // Case sensitive.
- this.$.tabIndex = value;
- else if ( name == 'checked' )
- this.$.checked = value;
- else if ( name == 'contenteditable' )
- standard.call( this, 'contentEditable', value );
- else
- standard.apply( this, arguments );
- return this;
- };
- }
- else if ( CKEDITOR.env.ie8Compat && CKEDITOR.env.secure )
- {
- return function( name, value )
- {
- // IE8 throws error when setting src attribute to non-ssl value. (#7847)
- if ( name == 'src' && value.match( /^http:\/\// ) )
- try { standard.apply( this, arguments ); } catch( e ){}
- else
- standard.apply( this, arguments );
- return this;
- };
- }
- else
- return standard;
- })(),
+ if ( CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) ) {
+ return function( name, value ) {
+ if ( name == 'class' )
+ this.$.className = value;
+ else if ( name == 'style' )
+ this.$.style.cssText = value;
+ else if ( name == 'tabindex' ) // Case sensitive.
+ this.$.tabIndex = value;
+ else if ( name == 'checked' )
+ this.$.checked = value;
+ else if ( name == 'contenteditable' )
+ standard.call( this, 'contentEditable', value );
+ else
+ standard.apply( this, arguments );
+ return this;
+ };
+ } else if ( CKEDITOR.env.ie8Compat && CKEDITOR.env.secure ) {
+ return function( name, value ) {
+ // IE8 throws error when setting src attribute to non-ssl value. (#7847)
+ if ( name == 'src' && value.match( /^http:\/\// ) )
+ try {
+ standard.apply( this, arguments );
+ } catch ( e ) {} else
+ standard.apply( this, arguments );
+ return this;
+ };
+ } else
+ return standard;
+ } )(),
- /**
- * Sets the value of several element attributes.
- * @param {Object} attributesPairs An object containing the names and
- * values of the attributes.
- * @returns {CKEDITOR.dom.element} This element instance.
- * @example
- * var element = CKEDITOR.dom.element.getById( 'myElement' );
- *
element.setAttributes({
- * 'class' : 'myClass',
- * 'title' : 'This is an example' }) ;
- */
- setAttributes : function( attributesPairs )
- {
- for ( var name in attributesPairs )
- this.setAttribute( name, attributesPairs[ name ] );
- return this;
- },
+ /**
+ * Sets the value of several element attributes.
+ *
+ * var element = CKEDITOR.document.getById( 'myElement' );
+ * element.setAttributes( {
+ * 'class': 'myClass',
+ * title: 'This is an example'
+ * } );
+ *
+ * @chainable
+ * @param {Object} attributesPairs An object containing the names and
+ * values of the attributes.
+ * @returns {CKEDITOR.dom.element} This element instance.
+ */
+ setAttributes: function( attributesPairs ) {
+ for ( var name in attributesPairs )
+ this.setAttribute( name, attributesPairs[ name ] );
+ return this;
+ },
- /**
- * Sets the element value. This function is usually used with form
- * field element.
- * @param {String} value The element value.
- * @returns {CKEDITOR.dom.element} This element instance.
- */
- setValue : function( value )
- {
- this.$.value = value;
- return this;
- },
+ /**
+ * Sets the element value. This function is usually used with form
+ * field element.
+ *
+ * @chainable
+ * @param {String} value The element value.
+ * @returns {CKEDITOR.dom.element} This element instance.
+ */
+ setValue: function( value ) {
+ this.$.value = value;
+ return this;
+ },
- /**
- * Removes an attribute from the element.
- * @param {String} name The attribute name.
- * @function
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '
' );
- * element.removeAttribute( 'class' );
- */
- removeAttribute : (function()
- {
- var standard = function( name )
- {
+ /**
+ * Removes an attribute from the element.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
' );
+ * element.removeAttribute( 'class' );
+ *
+ * @method
+ * @param {String} name The attribute name.
+ */
+ removeAttribute: ( function() {
+ var standard = function( name ) {
this.$.removeAttribute( name );
};
- if ( CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) )
- {
- return function( name )
- {
- if ( name == 'class' )
- name = 'className';
- else if ( name == 'tabindex' )
- name = 'tabIndex';
- else if ( name == 'contenteditable' )
- name = 'contentEditable';
- standard.call( this, name );
- };
- }
- else
- return standard;
- })(),
-
- removeAttributes : function ( attributes )
- {
- if ( CKEDITOR.tools.isArray( attributes ) )
- {
- for ( var i = 0 ; i < attributes.length ; i++ )
- this.removeAttribute( attributes[ i ] );
- }
- else
- {
- for ( var attr in attributes )
- attributes.hasOwnProperty( attr ) && this.removeAttribute( attr );
- }
- },
-
- /**
- * Removes a style from the element.
- * @param {String} name The style name.
- * @function
- * @example
- * var element = CKEDITOR.dom.element.createFromHtml( '
' );
- * element.removeStyle( 'display' );
- */
- removeStyle : function( name )
- {
- // Removes the specified property from the current style object.
- var $ = this.$.style;
- $.removeProperty ? $.removeProperty( name ) : $.removeAttribute( CKEDITOR.tools.cssStyleToDomStyle( name ) );
-
- if ( !this.$.style.cssText )
- this.removeAttribute( 'style' );
- },
-
- /**
- * Sets the value of an element style.
- * @param {String} name The name of the style. The CSS naming notation
- * must be used (e.g. "background-color").
- * @param {String} value The value to be set to the style.
- * @returns {CKEDITOR.dom.element} This element instance.
- * @example
- * var element = CKEDITOR.dom.element.getById( 'myElement' );
- *
element.setStyle( 'background-color', '#ff0000' ) ;
- *
element.setStyle( 'margin-top', '10px' ) ;
- *
element.setStyle( 'float', 'right' ) ;
- */
- setStyle : function( name, value )
- {
- this.$.style[ CKEDITOR.tools.cssStyleToDomStyle( name ) ] = value;
- return this;
- },
-
- /**
- * Sets the value of several element styles.
- * @param {Object} stylesPairs An object containing the names and
- * values of the styles.
- * @returns {CKEDITOR.dom.element} This element instance.
- * @example
- * var element = CKEDITOR.dom.element.getById( 'myElement' );
- *
element.setStyles({
- * 'position' : 'absolute',
- * 'float' : 'right' }) ;
- */
- setStyles : function( stylesPairs )
- {
- for ( var name in stylesPairs )
- this.setStyle( name, stylesPairs[ name ] );
- return this;
- },
-
- /**
- * Sets the opacity of an element.
- * @param {Number} opacity A number within the range [0.0, 1.0].
- * @example
- * var element = CKEDITOR.dom.element.getById( 'myElement' );
- *
element.setOpacity( 0.75 ) ;
- */
- setOpacity : function( opacity )
- {
- if ( CKEDITOR.env.ie && CKEDITOR.env.version < 9 )
- {
- opacity = Math.round( opacity * 100 );
- this.setStyle( 'filter', opacity >= 100 ? '' : 'progid:DXImageTransform.Microsoft.Alpha(opacity=' + opacity + ')' );
- }
- else
- this.setStyle( 'opacity', opacity );
- },
-
- /**
- * Makes the element and its children unselectable.
- * @function
- * @example
- * var element = CKEDITOR.dom.element.getById( 'myElement' );
- * element.unselectable();
- */
- unselectable :
- CKEDITOR.env.gecko ?
- function()
- {
- this.$.style.MozUserSelect = 'none';
- this.on( 'dragstart', function( evt ) { evt.data.preventDefault(); } );
- }
- : CKEDITOR.env.webkit ?
- function()
- {
- this.$.style.KhtmlUserSelect = 'none';
- this.on( 'dragstart', function( evt ) { evt.data.preventDefault(); } );
- }
- :
- function()
- {
- if ( CKEDITOR.env.ie || CKEDITOR.env.opera )
- {
- var element = this.$,
- elements = element.getElementsByTagName("*"),
- e,
- i = 0;
-
- element.unselectable = 'on';
-
- while ( ( e = elements[ i++ ] ) )
- {
- switch ( e.tagName.toLowerCase() )
- {
- case 'iframe' :
- case 'textarea' :
- case 'input' :
- case 'select' :
- /* Ignore the above tags */
- break;
- default :
- e.unselectable = 'on';
- }
- }
- }
- },
-
- getPositionedAncestor : function()
- {
- var current = this;
- while ( current.getName() != 'html' )
- {
- if ( current.getComputedStyle( 'position' ) != 'static' )
- return current;
-
- current = current.getParent();
- }
- return null;
- },
-
- getDocumentPosition : function( refDocument )
- {
- var x = 0, y = 0,
- doc = this.getDocument(),
- body = doc.getBody(),
- quirks = doc.$.compatMode == 'BackCompat';
-
- if ( document.documentElement[ "getBoundingClientRect" ] )
- {
- var box = this.$.getBoundingClientRect(),
- $doc = doc.$,
- $docElem = $doc.documentElement;
-
- var clientTop = $docElem.clientTop || body.$.clientTop || 0,
- clientLeft = $docElem.clientLeft || body.$.clientLeft || 0,
- needAdjustScrollAndBorders = true;
-
- /*
- * #3804: getBoundingClientRect() works differently on IE and non-IE
- * browsers, regarding scroll positions.
- *
- * On IE, the top position of the element is always 0, no matter
- * how much you scrolled down.
- *
- * On other browsers, the top position of the element is negative
- * scrollTop.
- */
- if ( CKEDITOR.env.ie )
- {
- var inDocElem = doc.getDocumentElement().contains( this ),
- inBody = doc.getBody().contains( this );
-
- needAdjustScrollAndBorders = ( quirks && inBody ) || ( !quirks && inDocElem );
- }
-
- if ( needAdjustScrollAndBorders )
- {
- x = box.left + ( !quirks && $docElem.scrollLeft || body.$.scrollLeft );
- x -= clientLeft;
- y = box.top + ( !quirks && $docElem.scrollTop || body.$.scrollTop );
- y -= clientTop;
- }
- }
- else
- {
- var current = this, previous = null, offsetParent;
- while ( current && !( current.getName() == 'body' || current.getName() == 'html' ) )
- {
- x += current.$.offsetLeft - current.$.scrollLeft;
- y += current.$.offsetTop - current.$.scrollTop;
-
- // Opera includes clientTop|Left into offsetTop|Left.
- if ( !current.equals( this ) )
- {
- x += ( current.$.clientLeft || 0 );
- y += ( current.$.clientTop || 0 );
- }
-
- var scrollElement = previous;
- while ( scrollElement && !scrollElement.equals( current ) )
- {
- x -= scrollElement.$.scrollLeft;
- y -= scrollElement.$.scrollTop;
- scrollElement = scrollElement.getParent();
- }
-
- previous = current;
- current = ( offsetParent = current.$.offsetParent ) ?
- new CKEDITOR.dom.element( offsetParent ) : null;
- }
- }
-
- if ( refDocument )
- {
- var currentWindow = this.getWindow(),
- refWindow = refDocument.getWindow();
-
- if ( !currentWindow.equals( refWindow ) && currentWindow.$.frameElement )
- {
- var iframePosition = ( new CKEDITOR.dom.element( currentWindow.$.frameElement ) ).getDocumentPosition( refDocument );
-
- x += iframePosition.x;
- y += iframePosition.y;
- }
- }
-
- if ( !document.documentElement[ "getBoundingClientRect" ] )
- {
- // In Firefox, we'll endup one pixel before the element positions,
- // so we must add it here.
- if ( CKEDITOR.env.gecko && !quirks )
- {
- x += this.$.clientLeft ? 1 : 0;
- y += this.$.clientTop ? 1 : 0;
- }
- }
-
- return { x : x, y : y };
- },
-
- /**
- * Make any page element visible inside the browser viewport.
- * @param {Boolean} [alignToTop]
- */
- scrollIntoView : function( alignToTop )
- {
- var parent = this.getParent();
- if ( !parent ) return;
-
- // Scroll the element into parent container from the inner out.
- do
- {
- // Check ancestors that overflows.
- var overflowed =
- parent.$.clientWidth && parent.$.clientWidth < parent.$.scrollWidth
- || parent.$.clientHeight && parent.$.clientHeight < parent.$.scrollHeight;
-
- if ( overflowed )
- this.scrollIntoParent( parent, alignToTop, 1 );
-
- // Walk across the frame.
- if ( parent.is( 'html' ) )
- {
- var win = parent.getWindow();
-
- // Avoid security error.
- try
- {
- var iframe = win.$.frameElement;
- iframe && ( parent = new CKEDITOR.dom.element( iframe ) );
- }
- catch(er){}
- }
- }
- while ( ( parent = parent.getParent() ) );
- },
-
- /**
- * Make any page element visible inside one of the ancestors by scrolling the parent.
- * @param {CKEDITOR.dom.element|CKEDITOR.dom.window} parent The container to scroll into.
- * @param {Boolean} [alignToTop] Align the element's top side with the container's
- * when
true is specified; align the bottom with viewport bottom when
- *
false is specified. Otherwise scroll on either side with the minimum
- * amount to show the element.
- * @param {Boolean} [hscroll] Whether horizontal overflow should be considered.
- */
- scrollIntoParent : function( parent, alignToTop, hscroll )
- {
- !parent && ( parent = this.getWindow() );
-
- var doc = parent.getDocument();
- var isQuirks = doc.$.compatMode == 'BackCompat';
-
- // On window is scrolled while quirks scrolls .
- if ( parent instanceof CKEDITOR.dom.window )
- parent = isQuirks ? doc.getBody() : doc.getDocumentElement();
-
- // Scroll the parent by the specified amount.
- function scrollBy( x, y )
- {
- // Webkit doesn't support "scrollTop/scrollLeft"
- // on documentElement/body element.
- if ( /body|html/.test( parent.getName() ) )
- parent.getWindow().$.scrollBy( x, y );
- else
- {
- parent.$[ 'scrollLeft' ] += x;
- parent.$[ 'scrollTop' ] += y;
- }
- }
-
- // Figure out the element position relative to the specified window.
- function screenPos( element, refWin )
- {
- var pos = { x: 0, y: 0 };
-
- if ( !( element.is( isQuirks ? 'body' : 'html' ) ) )
- {
- var box = element.$.getBoundingClientRect();
- pos.x = box.left, pos.y = box.top;
- }
-
- var win = element.getWindow();
- if ( !win.equals( refWin ) )
- {
- var outerPos = screenPos( CKEDITOR.dom.element.get( win.$.frameElement ), refWin );
- pos.x += outerPos.x, pos.y += outerPos.y;
- }
-
- return pos;
- }
-
- // calculated margin size.
- function margin( element, side )
- {
- return parseInt( element.getComputedStyle( 'margin-' + side ) || 0, 10 ) || 0;
- }
-
- var win = parent.getWindow();
-
- var thisPos = screenPos( this, win ),
- parentPos = screenPos( parent, win ),
- eh = this.$.offsetHeight,
- ew = this.$.offsetWidth,
- ch = parent.$.clientHeight,
- cw = parent.$.clientWidth,
- lt,
- br;
-
- // Left-top margins.
- lt =
- {
- x : thisPos.x - margin( this, 'left' ) - parentPos.x || 0,
- y : thisPos.y - margin( this, 'top' ) - parentPos.y|| 0
+ if ( CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) ) {
+ return function( name ) {
+ if ( name == 'class' )
+ name = 'className';
+ else if ( name == 'tabindex' )
+ name = 'tabIndex';
+ else if ( name == 'contenteditable' )
+ name = 'contentEditable';
+ standard.call( this, name );
};
+ } else
+ return standard;
+ } )(),
- // Bottom-right margins.
- br =
- {
- x : thisPos.x + ew + margin( this, 'right' ) - ( ( parentPos.x ) + cw ) || 0,
- y : thisPos.y + eh + margin( this, 'bottom' ) - ( ( parentPos.y ) + ch ) || 0
- };
+ /**
+ * Removes all element's attributes or just given ones.
+ *
+ * @param {Array} [attributes] The array with attributes names.
+ */
+ removeAttributes: function( attributes ) {
+ if ( CKEDITOR.tools.isArray( attributes ) ) {
+ for ( var i = 0; i < attributes.length; i++ )
+ this.removeAttribute( attributes[ i ] );
+ } else {
+ for ( var attr in attributes )
+ attributes.hasOwnProperty( attr ) && this.removeAttribute( attr );
+ }
+ },
- // 1. Do the specified alignment as much as possible;
- // 2. Otherwise be smart to scroll only the minimum amount;
- // 3. Never cut at the top;
- // 4. DO NOT scroll when already visible.
- if ( lt.y < 0 || br.y > 0 )
- {
- scrollBy( 0,
- alignToTop === true ? lt.y :
- alignToTop === false ? br.y :
- lt.y < 0 ? lt.y : br.y );
+ /**
+ * Removes a style from the element.
+ *
+ * var element = CKEDITOR.dom.element.createFromHtml( '
' );
+ * element.removeStyle( 'display' );
+ *
+ * @method
+ * @param {String} name The style name.
+ */
+ removeStyle: function( name ) {
+ // Removes the specified property from the current style object.
+ var $ = this.$.style;
+
+ // "removeProperty" need to be specific on the following styles.
+ if ( !$.removeProperty && ( name == 'border' || name == 'margin' || name == 'padding' ) ) {
+ var names = expandedRules( name );
+ for ( var i = 0 ; i < names.length ; i++ )
+ this.removeStyle( names[ i ] );
+ return;
+ }
+
+ $.removeProperty ? $.removeProperty( name ) : $.removeAttribute( CKEDITOR.tools.cssStyleToDomStyle( name ) );
+
+ // Eventually remove empty style attribute.
+ if ( !this.$.style.cssText )
+ this.removeAttribute( 'style' );
+ },
+
+ /**
+ * Sets the value of an element style.
+ *
+ * var element = CKEDITOR.document.getById( 'myElement' );
+ * element.setStyle( 'background-color', '#ff0000' );
+ * element.setStyle( 'margin-top', '10px' );
+ * element.setStyle( 'float', 'right' );
+ *
+ * @param {String} name The name of the style. The CSS naming notation
+ * must be used (e.g. `background-color`).
+ * @param {String} value The value to be set to the style.
+ * @returns {CKEDITOR.dom.element} This element instance.
+ */
+ setStyle: function( name, value ) {
+ this.$.style[ CKEDITOR.tools.cssStyleToDomStyle( name ) ] = value;
+ return this;
+ },
+
+ /**
+ * Sets the value of several element styles.
+ *
+ * var element = CKEDITOR.document.getById( 'myElement' );
+ * element.setStyles( {
+ * position: 'absolute',
+ * float: 'right'
+ * } );
+ *
+ * @param {Object} stylesPairs An object containing the names and
+ * values of the styles.
+ * @returns {CKEDITOR.dom.element} This element instance.
+ */
+ setStyles: function( stylesPairs ) {
+ for ( var name in stylesPairs )
+ this.setStyle( name, stylesPairs[ name ] );
+ return this;
+ },
+
+ /**
+ * Sets the opacity of an element.
+ *
+ * var element = CKEDITOR.document.getById( 'myElement' );
+ * element.setOpacity( 0.75 );
+ *
+ * @param {Number} opacity A number within the range `[0.0, 1.0]`.
+ */
+ setOpacity: function( opacity ) {
+ if ( CKEDITOR.env.ie && CKEDITOR.env.version < 9 ) {
+ opacity = Math.round( opacity * 100 );
+ this.setStyle( 'filter', opacity >= 100 ? '' : 'progid:DXImageTransform.Microsoft.Alpha(opacity=' + opacity + ')' );
+ } else
+ this.setStyle( 'opacity', opacity );
+ },
+
+ /**
+ * Makes the element and its children unselectable.
+ *
+ * var element = CKEDITOR.document.getById( 'myElement' );
+ * element.unselectable();
+ *
+ * @method
+ */
+ unselectable: function() {
+ // CSS unselectable.
+ this.setStyles( CKEDITOR.tools.cssVendorPrefix( 'user-select', 'none' ) );
+
+ // For IE/Opera which doesn't support for the above CSS style,
+ // the unselectable="on" attribute only specifies the selection
+ // process cannot start in the element itself, and it doesn't inherit.
+ if ( CKEDITOR.env.ie || CKEDITOR.env.opera ) {
+ this.setAttribute( 'unselectable', 'on' );
+
+ var element,
+ elements = this.getElementsByTag( "*" );
+
+ for ( var i = 0, count = elements.count() ; i < count ; i++ ) {
+ element = elements.getItem( i );
+ element.setAttribute( 'unselectable', 'on' );
+ }
+ }
+ },
+
+ /**
+ * Gets closest positioned (`position != static`) ancestor.
+ *
+ * @returns {CKEDITOR.dom.element} Positioned ancestor or `null`.
+ */
+ getPositionedAncestor: function() {
+ var current = this;
+ while ( current.getName() != 'html' ) {
+ if ( current.getComputedStyle( 'position' ) != 'static' )
+ return current;
+
+ current = current.getParent();
+ }
+ return null;
+ },
+
+ /**
+ * Gets this element's position in document.
+ *
+ * @param {CKEDITOR.dom.document} [refDocument]
+ * @returns {Object} Element's position.
+ * @returns {Number} return.x
+ * @returns {Number} return.y
+ * @todo refDocument
+ */
+ getDocumentPosition: function( refDocument ) {
+ var x = 0,
+ y = 0,
+ doc = this.getDocument(),
+ body = doc.getBody(),
+ quirks = doc.$.compatMode == 'BackCompat';
+
+ if ( document.documentElement[ "getBoundingClientRect" ] ) {
+ var box = this.$.getBoundingClientRect(),
+ $doc = doc.$,
+ $docElem = $doc.documentElement;
+
+ var clientTop = $docElem.clientTop || body.$.clientTop || 0,
+ clientLeft = $docElem.clientLeft || body.$.clientLeft || 0,
+ needAdjustScrollAndBorders = true;
+
+ // #3804: getBoundingClientRect() works differently on IE and non-IE
+ // browsers, regarding scroll positions.
+ //
+ // On IE, the top position of the element is always 0, no matter
+ // how much you scrolled down.
+ //
+ // On other browsers, the top position of the element is negative
+ // scrollTop.
+ if ( CKEDITOR.env.ie ) {
+ var inDocElem = doc.getDocumentElement().contains( this ),
+ inBody = doc.getBody().contains( this );
+
+ needAdjustScrollAndBorders = ( quirks && inBody ) || ( !quirks && inDocElem );
}
- if ( hscroll && ( lt.x < 0 || br.x > 0 ) )
- scrollBy( lt.x < 0 ? lt.x : br.x, 0 );
- },
-
- setState : function( state )
- {
- switch ( state )
- {
- case CKEDITOR.TRISTATE_ON :
- this.addClass( 'cke_on' );
- this.removeClass( 'cke_off' );
- this.removeClass( 'cke_disabled' );
- break;
- case CKEDITOR.TRISTATE_DISABLED :
- this.addClass( 'cke_disabled' );
- this.removeClass( 'cke_off' );
- this.removeClass( 'cke_on' );
- break;
- default :
- this.addClass( 'cke_off' );
- this.removeClass( 'cke_on' );
- this.removeClass( 'cke_disabled' );
- break;
+ if ( needAdjustScrollAndBorders ) {
+ x = box.left + ( !quirks && $docElem.scrollLeft || body.$.scrollLeft );
+ x -= clientLeft;
+ y = box.top + ( !quirks && $docElem.scrollTop || body.$.scrollTop );
+ y -= clientTop;
}
- },
+ } else {
+ var current = this,
+ previous = null,
+ offsetParent;
+ while ( current && !( current.getName() == 'body' || current.getName() == 'html' ) ) {
+ x += current.$.offsetLeft - current.$.scrollLeft;
+ y += current.$.offsetTop - current.$.scrollTop;
- /**
- * Returns the inner document of this IFRAME element.
- * @returns {CKEDITOR.dom.document} The inner document.
- */
- getFrameDocument : function()
- {
- var $ = this.$;
-
- try
- {
- // In IE, with custom document.domain, it may happen that
- // the iframe is not yet available, resulting in "Access
- // Denied" for the following property access.
- $.contentWindow.document;
- }
- catch ( e )
- {
- // Trick to solve this issue, forcing the iframe to get ready
- // by simply setting its "src" property.
- $.src = $.src;
-
- // In IE6 though, the above is not enough, so we must pause the
- // execution for a while, giving it time to think.
- if ( CKEDITOR.env.ie && CKEDITOR.env.version < 7 )
- {
- window.showModalDialog(
- 'javascript:document.write("' +
- '")' );
+ // Opera includes clientTop|Left into offsetTop|Left.
+ if ( !current.equals( this ) ) {
+ x += ( current.$.clientLeft || 0 );
+ y += ( current.$.clientTop || 0 );
}
- }
- return $ && new CKEDITOR.dom.document( $.contentWindow.document );
- },
-
- /**
- * Copy all the attributes from one node to the other, kinda like a clone
- * skipAttributes is an object with the attributes that must NOT be copied.
- * @param {CKEDITOR.dom.element} dest The destination element.
- * @param {Object} skipAttributes A dictionary of attributes to skip.
- * @example
- */
- copyAttributes : function( dest, skipAttributes )
- {
- var attributes = this.$.attributes;
- skipAttributes = skipAttributes || {};
-
- for ( var n = 0 ; n < attributes.length ; n++ )
- {
- var attribute = attributes[n];
-
- // Lowercase attribute name hard rule is broken for
- // some attribute on IE, e.g. CHECKED.
- var attrName = attribute.nodeName.toLowerCase(),
- attrValue;
-
- // We can set the type only once, so do it with the proper value, not copying it.
- if ( attrName in skipAttributes )
- continue;
-
- if ( attrName == 'checked' && ( attrValue = this.getAttribute( attrName ) ) )
- dest.setAttribute( attrName, attrValue );
- // IE BUG: value attribute is never specified even if it exists.
- else if ( attribute.specified ||
- ( CKEDITOR.env.ie && attribute.nodeValue && attrName == 'value' ) )
- {
- attrValue = this.getAttribute( attrName );
- if ( attrValue === null )
- attrValue = attribute.nodeValue;
-
- dest.setAttribute( attrName, attrValue );
+ var scrollElement = previous;
+ while ( scrollElement && !scrollElement.equals( current ) ) {
+ x -= scrollElement.$.scrollLeft;
+ y -= scrollElement.$.scrollTop;
+ scrollElement = scrollElement.getParent();
}
+
+ previous = current;
+ current = ( offsetParent = current.$.offsetParent ) ? new CKEDITOR.dom.element( offsetParent ) : null;
+ }
+ }
+
+ if ( refDocument ) {
+ var currentWindow = this.getWindow(),
+ refWindow = refDocument.getWindow();
+
+ if ( !currentWindow.equals( refWindow ) && currentWindow.$.frameElement ) {
+ var iframePosition = ( new CKEDITOR.dom.element( currentWindow.$.frameElement ) ).getDocumentPosition( refDocument );
+
+ x += iframePosition.x;
+ y += iframePosition.y;
+ }
+ }
+
+ if ( !document.documentElement[ "getBoundingClientRect" ] ) {
+ // In Firefox, we'll endup one pixel before the element positions,
+ // so we must add it here.
+ if ( CKEDITOR.env.gecko && !quirks ) {
+ x += this.$.clientLeft ? 1 : 0;
+ y += this.$.clientTop ? 1 : 0;
+ }
+ }
+
+ return { x: x, y: y };
+ },
+
+ /**
+ * Make any page element visible inside the browser viewport.
+ *
+ * @param {Boolean} [alignToTop=false]
+ */
+ scrollIntoView: function( alignToTop ) {
+ var parent = this.getParent();
+ if ( !parent )
+ return;
+
+ // Scroll the element into parent container from the inner out.
+ do {
+ // Check ancestors that overflows.
+ var overflowed =
+ parent.$.clientWidth && parent.$.clientWidth < parent.$.scrollWidth ||
+ parent.$.clientHeight && parent.$.clientHeight < parent.$.scrollHeight;
+
+ // Skip body element, which will report wrong clientHeight when containing
+ // floated content. (#9523)
+ if ( overflowed && !parent.is( 'body' ) )
+ this.scrollIntoParent( parent, alignToTop, 1 );
+
+ // Walk across the frame.
+ if ( parent.is( 'html' ) ) {
+ var win = parent.getWindow();
+
+ // Avoid security error.
+ try {
+ var iframe = win.$.frameElement;
+ iframe && ( parent = new CKEDITOR.dom.element( iframe ) );
+ } catch ( er ) {}
+ }
+ }
+ while ( ( parent = parent.getParent() ) );
+ },
+
+ /**
+ * Make any page element visible inside one of the ancestors by scrolling the parent.
+ *
+ * @param {CKEDITOR.dom.element/CKEDITOR.dom.window} parent The container to scroll into.
+ * @param {Boolean} [alignToTop] Align the element's top side with the container's
+ * when `true` is specified; align the bottom with viewport bottom when
+ * `false` is specified. Otherwise scroll on either side with the minimum
+ * amount to show the element.
+ * @param {Boolean} [hscroll] Whether horizontal overflow should be considered.
+ */
+ scrollIntoParent: function( parent, alignToTop, hscroll ) {
+ !parent && ( parent = this.getWindow() );
+
+ var doc = parent.getDocument();
+ var isQuirks = doc.$.compatMode == 'BackCompat';
+
+ // On window is scrolled while quirks scrolls .
+ if ( parent instanceof CKEDITOR.dom.window )
+ parent = isQuirks ? doc.getBody() : doc.getDocumentElement();
+
+ // Scroll the parent by the specified amount.
+ function scrollBy( x, y ) {
+ // Webkit doesn't support "scrollTop/scrollLeft"
+ // on documentElement/body element.
+ if ( /body|html/.test( parent.getName() ) )
+ parent.getWindow().$.scrollBy( x, y );
+ else {
+ parent.$[ 'scrollLeft' ] += x;
+ parent.$[ 'scrollTop' ] += y;
+ }
+ }
+
+ // Figure out the element position relative to the specified window.
+ function screenPos( element, refWin ) {
+ var pos = { x: 0, y: 0 };
+
+ if ( !( element.is( isQuirks ? 'body' : 'html' ) ) ) {
+ var box = element.$.getBoundingClientRect();
+ pos.x = box.left, pos.y = box.top;
}
- // The style:
- if ( this.$.style.cssText !== '' )
- dest.$.style.cssText = this.$.style.cssText;
- },
+ var win = element.getWindow();
+ if ( !win.equals( refWin ) ) {
+ var outerPos = screenPos( CKEDITOR.dom.element.get( win.$.frameElement ), refWin );
+ pos.x += outerPos.x, pos.y += outerPos.y;
+ }
- /**
- * Changes the tag name of the current element.
- * @param {String} newTag The new tag for the element.
- */
- renameNode : function( newTag )
- {
- // If it's already correct exit here.
- if ( this.getName() == newTag )
- return;
+ return pos;
+ }
- var doc = this.getDocument();
+ // calculated margin size.
+ function margin( element, side ) {
+ return parseInt( element.getComputedStyle( 'margin-' + side ) || 0, 10 ) || 0;
+ }
- // Create the new node.
- var newNode = new CKEDITOR.dom.element( newTag, doc );
+ var win = parent.getWindow();
- // Copy all attributes.
- this.copyAttributes( newNode );
+ var thisPos = screenPos( this, win ),
+ parentPos = screenPos( parent, win ),
+ eh = this.$.offsetHeight,
+ ew = this.$.offsetWidth,
+ ch = parent.$.clientHeight,
+ cw = parent.$.clientWidth,
+ lt, br;
- // Move children to the new node.
- this.moveChildren( newNode );
+ // Left-top margins.
+ lt = {
+ x: thisPos.x - margin( this, 'left' ) - parentPos.x || 0,
+ y: thisPos.y - margin( this, 'top' ) - parentPos.y || 0
+ };
- // Replace the node.
- this.getParent() && this.$.parentNode.replaceChild( newNode.$, this.$ );
- newNode.$[ 'data-cke-expando' ] = this.$[ 'data-cke-expando' ];
- this.$ = newNode.$;
- },
+ // Bottom-right margins.
+ br = {
+ x: thisPos.x + ew + margin( this, 'right' ) - ( ( parentPos.x ) + cw ) || 0,
+ y: thisPos.y + eh + margin( this, 'bottom' ) - ( ( parentPos.y ) + ch ) || 0
+ };
- /**
- * Gets a DOM tree descendant under the current node.
- * @param {Array|Number} indices The child index or array of child indices under the node.
- * @returns {CKEDITOR.dom.node} The specified DOM child under the current node. Null if child does not exist.
- * @example
- * var strong = p.getChild(0);
- */
- getChild : function( indices )
- {
+ // 1. Do the specified alignment as much as possible;
+ // 2. Otherwise be smart to scroll only the minimum amount;
+ // 3. Never cut at the top;
+ // 4. DO NOT scroll when already visible.
+ if ( lt.y < 0 || br.y > 0 )
+ scrollBy( 0, alignToTop === true ? lt.y : alignToTop === false ? br.y : lt.y < 0 ? lt.y : br.y );
+
+ if ( hscroll && ( lt.x < 0 || br.x > 0 ) )
+ scrollBy( lt.x < 0 ? lt.x : br.x, 0 );
+ },
+
+ /**
+ * Switch the `class` attribute to reflect one of the triple states of an
+ * element in one of {@link CKEDITOR#TRISTATE_ON}, {@link CKEDITOR#TRISTATE_OFF}
+ * or {@link CKEDITOR#TRISTATE_DISABLED}.
+ *
+ * link.setState( CKEDITOR.TRISTATE_ON );
+ * //
...
+ * link.setState( CKEDITOR.TRISTATE_OFF );
+ * //
...
+ * link.setState( CKEDITOR.TRISTATE_DISABLED );
+ * //
...
+ *
+ * span.setState( CKEDITOR.TRISTATE_ON, 'cke_button' );
+ * //
...
+ *
+ * @param {Number} state Indicate the element state. One of {@link CKEDITOR#TRISTATE_ON},
+ * {@link CKEDITOR#TRISTATE_OFF}, {@link CKEDITOR#TRISTATE_DISABLED}.
+ * @param [base='cke'] The prefix apply to each of the state class name.
+ * @param [useAria=true] Whether toggle the ARIA state attributes besides of class name change.
+ */
+ setState: function( state, base, useAria ) {
+ base = base || 'cke';
+
+ switch ( state ) {
+ case CKEDITOR.TRISTATE_ON:
+ this.addClass( base + '_on' );
+ this.removeClass( base + '_off' );
+ this.removeClass( base + '_disabled' );
+ useAria && this.setAttribute( 'aria-pressed', true );
+ useAria && this.removeAttribute( 'aria-disabled' );
+ break;
+
+ case CKEDITOR.TRISTATE_DISABLED:
+ this.addClass( base + '_disabled' );
+ this.removeClass( base + '_off' );
+ this.removeClass( base + '_on' );
+ useAria && this.setAttribute( 'aria-disabled', true );
+ useAria && this.removeAttribute( 'aria-pressed' );
+ break;
+
+ default:
+ this.addClass( base + '_off' );
+ this.removeClass( base + '_on' );
+ this.removeClass( base + '_disabled' );
+ useAria && this.removeAttribute( 'aria-pressed' );
+ useAria && this.removeAttribute( 'aria-disabled' );
+ break;
+ }
+ },
+
+ /**
+ * Returns the inner document of this `