diff options
Diffstat (limited to 'src/qml/doc/src/javascript/dynamicobjectcreation.qdoc')
| -rw-r--r-- | src/qml/doc/src/javascript/dynamicobjectcreation.qdoc | 38 |
1 files changed, 8 insertions, 30 deletions
diff --git a/src/qml/doc/src/javascript/dynamicobjectcreation.qdoc b/src/qml/doc/src/javascript/dynamicobjectcreation.qdoc index be4db4c917..f20111d154 100644 --- a/src/qml/doc/src/javascript/dynamicobjectcreation.qdoc +++ b/src/qml/doc/src/javascript/dynamicobjectcreation.qdoc @@ -1,29 +1,5 @@ -/**************************************************************************** -** -** Copyright (C) 2017 The Qt Company Ltd. -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:FDL$ -** Commercial License Usage -** Licensees holding valid commercial Qt licenses may use this file in -** accordance with the commercial license agreement provided with the -** Software or, alternatively, in accordance with the terms contained in -** a written agreement between you and The Qt Company. For licensing terms -** and conditions see https://www.qt.io/terms-conditions. For further -** information use the contact form at https://www.qt.io/contact-us. -** -** GNU Free Documentation License Usage -** Alternatively, this file may be used under the terms of the GNU Free -** Documentation License version 1.3 as published by the Free Software -** Foundation and appearing in the file included in the packaging of -** this file. Please review the following information to ensure -** the GNU Free Documentation License version 1.3 requirements -** will be met: https://www.gnu.org/licenses/fdl-1.3.html. -** $QT_END_LICENSE$ -** -****************************************************************************/ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! \page qtqml-javascript-dynamicobjectcreation.html @@ -35,10 +11,6 @@ useful to delay instantiation of objects until necessary, thereby improving application startup time. It also allows visual objects to be dynamically created and added to the scene in reaction to user input or other events. -See the \l {QML Example - Dynamic Scene}{Dynamic Scene example} for a -demonstration of the concepts discussed on this page. - - \section1 Creating Objects Dynamically There are two ways to create objects dynamically from JavaScript. You can @@ -126,6 +98,12 @@ It is also possible to instantiate components without blocking via the \section2 Creating an Object from a String of QML +\warning Creating objects from a string of QML is extremely slow since the engine has to compile the +passed QML string every time you do it. Furthermore, it's very easy to produce invalid QML when +programmatically constructing QML code. It's much better to keep your QML components as separate +files and add properties and methods to customize their behavior than to produce new components by +string manipulation. + If the QML is not defined until runtime, you can create a QML object from a string of QML using the \l{QtQml::Qt::createQmlObject()}{Qt.createQmlObject()} function, as in the following example: |