diff --git a/docs/Get_Started_Setup_Tutorials_and_Demo_Apps_8b49fc1.md b/docs/Get_Started_Setup_Tutorials_and_Demo_Apps_8b49fc1.md index 28dc522e..02c0d1df 100644 --- a/docs/Get_Started_Setup_Tutorials_and_Demo_Apps_8b49fc1.md +++ b/docs/Get_Started_Setup_Tutorials_and_Demo_Apps_8b49fc1.md @@ -58,7 +58,7 @@ To download the code from the Demo Kit, follow these steps: 3. Extract the project folder to a desired location on your local machine. -4. **If you use UI5 Tooling \(recommended\):** At your chosen location, open a new shell and execute `npm install`. After all dependencies have been installed, enter `npm start` to start the development server. +4. **If you use UI5 Tooling \(recommended\):** At your chosen location, open a new shell and execute `npm install`. After all dependencies have been installed, enter `npm start` to start the development server. \(**Note:** if they're not already present, you may have to create and adjust some project configuration files first; see the [Walkthrough Tutorial](Walkthrough_Tutorial_3da5f4b.md) for an example.\) 5. Test your project setup by opening one of its HTML pages in your development environment and making sure that the app displays the features exactly as shown in the preview of the step. diff --git a/docs/More_About_Controls_3ec6808.md b/docs/More_About_Controls_3ec6808.md index 9e9c7bdb..416f5825 100644 --- a/docs/More_About_Controls_3ec6808.md +++ b/docs/More_About_Controls_3ec6808.md @@ -55,7 +55,7 @@ This library contains the `CodeEditor` control. and all its components, base classes for controls, components and the Model-View-Controller (MVC) classes.")** This library contains the jQuery plugins \(`jQuery.sap.*`\), the core and all its components, base classes for controls, components and the Model-View-Controller \(MVC\) classes. -- **[sap.ui.mdc \(experimental\)](sap_ui_mdc_experimental_1dd2aa9.md "The sap.ui.mdc library contains composite, metadata-driven controls +- **[sap.ui.mdc \(experimental\)](sap_ui_mdc_experimental_1dd2aa9.md "The sap.ui.mdc library contains composite, metadata-driven controls that assemble UI elements with predefined user experience and various functionalities. The controls can be used as a basis for scalable application development and can be implemented for use with any OpenUI5 model diff --git a/docs/Step_10_Descriptor_for_Applications_8f93bf2.md b/docs/Step_10_Descriptor_for_Applications_8f93bf2.md index fd083910..cd61e769 100644 --- a/docs/Step_10_Descriptor_for_Applications_8f93bf2.md +++ b/docs/Step_10_Descriptor_for_Applications_8f93bf2.md @@ -31,22 +31,19 @@ The SAP Fiori launchpad acts as an application container and instantiates the ap You can view and download all files at [Walkthrough - Step 10](https://sdk.openui5.org/entity/sap.m.tutorial.walkthrough/sample/sap.m.tutorial.walkthrough.10). -> ### Caution: -> Automatic model instantiation is only available as of OpenUI5 version 1.30. If you are using an older version, you can manually instantiate the resource bundle and other models of the app in the `init` method of the `Component.js` file as we did in [Step 9: Component Configuration](Step_9_Component_Configuration_4cfa608.md). - *** ### webapp/manifest.json \(New\) -```js +``` { - "_version": "1.12.0", + "_version": "1.58.0", "sap.app": { - "id": "sap.ui.demo.walkthrough", - "type": "application", + "id": "ui5.walkthrough", "i18n": "i18n/i18n.properties", "title": "{{appTitle}}", "description": "{{appDescription}}", + "type": "application", "applicationVersion": { "version": "1.0.0" } @@ -60,13 +57,8 @@ You can view and download all files at [Walkthrough - Step 10](https://sdk.openu } }, "sap.ui5": { - "rootView": { - "viewName": "sap.ui.demo.walkthrough.view.App", - "type": "XML", - "id": "app" - }, "dependencies": { - "minUI5Version": "1.93", + "minUI5Version": "1.108.0", "libs": { "sap.ui.core": {}, "sap.m": {} @@ -76,11 +68,16 @@ You can view and download all files at [Walkthrough - Step 10](https://sdk.openu "i18n": { "type": "sap.ui.model.resource.ResourceModel", "settings": { - "bundleName": "sap.ui.demo.walkthrough.i18n.i18n", + "bundleName": "ui5.walkthrough.i18n.i18n", "supportedLocales": [""], "fallbackLocale": "" } } + }, + "rootView": { + "viewName": "ui5.walkthrough.view.App", + "type": "XML", + "id": "app" } } } @@ -95,19 +92,19 @@ The content of the `manifest.json` file is a configuration object in JSON format The `sap.app` namespace contains the following application-specific attributes: - - `id` \(mandatory\): The namespace of our application component + - `id` \(mandatory\): The namespace of our application component. The ID must not exceed 70 characters. It must be unique and must correspond to the component ID/namespace. - - `type`: Defines what we want to configure, here: an application + - `type`: Defines what we want to configure; here: an application. - - `i18n`: Defines the path to the resource bundle file + - `i18n`: Defines the path to the resource bundle file. The `supportedLocales` and `fallbackLocale` properties are set to empty strings, as our demo app uses only one `i18n.properties` file for simplicity and we'd like to prevent the browser from trying to load additional `i18n_*.properties` files based on your browser settings and your locale. - - `title`: Title of the application in handlebars syntax referenced from the app's resource bundle + - `title`: Title of the application in handlebars syntax referenced from the app's resource bundle. - - `description`: Short description text what the application does in handlebars syntax referenced from the app's resource bundle + - `description`: Short description text what the application does in handlebars syntax referenced from the app's resource bundle. - - `applicationVersion`: The version of the application to be able to easily update the application later on + - `applicationVersion`: The version of the application to be able to update the application easily later on. - **`sap.ui`** @@ -147,28 +144,28 @@ The content of the `manifest.json` file is a configuration object in JSON format - SAPUI5 Walkthrough + UI5 Walkthrough -
+
``` -Now we declare our component in the body of our `index.html`. In the bootstrapping script of our `index.html`, we enable the `ComponentSupport` module and remove the `sap.m` library. Then, we declare our component in the body via a `div` tag. This will instantiate the component when the `onInit` event is executed. +Now we declare our component in the body of our `index.html`. In the bootstrapping script of our `index.html`, we enable the `ComponentSupport` module. Then, we declare our component in the body via a `div` tag. This will instantiate the component when the `onInit` event is executed. -We will no longer need our `index.js` from now on, because the descriptor takes care of everything. +We can delete our `index.js`, because the descriptor now takes care of everything. *** @@ -195,23 +192,26 @@ In the resource bundle we simply add the texts for the app and add comments to s sap.ui.define([ "sap/ui/core/UIComponent", "sap/ui/model/json/JSONModel" -], function (UIComponent, JSONModel) { +], (UIComponent, JSONModel) => { "use strict"; - return UIComponent.extend("sap.ui.demo.walkthrough.Component", { + + return UIComponent.extend("ui5.walkthrough.Component", { metadata : { interfaces: ["sap.ui.core.IAsyncContentCreation"], manifest: "json" }, - init : function () { + + init() { // call the init function of the parent UIComponent.prototype.init.apply(this, arguments); + // set data model - var oData = { + const oData = { recipient : { name : "World" } }; - var oModel = new JSONModel(oData); + const oModel = new JSONModel(oData); this.setModel(oModel); } }); diff --git a/docs/Step_11_Pages_and_Panels_3b9d9f8.md b/docs/Step_11_Pages_and_Panels_3b9d9f8.md index 5b7018f0..01133fe9 100644 --- a/docs/Step_11_Pages_and_Panels_3b9d9f8.md +++ b/docs/Step_11_Pages_and_Panels_3b9d9f8.md @@ -24,13 +24,21 @@ After all the work on the app structure it’s time to improve the look of our a *** + + ### Coding You can view and download all files at [Walkthrough - Step 11](https://sdk.openui5.org/entity/sap.m.tutorial.walkthrough/sample/sap.m.tutorial.walkthrough.11). +*** + + + +### webapp/view/App.view.xml + ```xml @@ -41,10 +49,10 @@ You can view and download all files at [Walkthrough - Step 11](https://sdk.openu -