sapui5 icon indicating copy to clipboard operation
sapui5 copied to clipboard

[doc issue] Where can I find a complete API reference for `routing` in `manifest.json`?

Open ziyang-works opened this issue 1 month ago • 1 comments

Issue description

I'm working on Step 30: Routing and Navigation of the Walkthrough Tutorial, and have some questions regarding the given manifes.json code:

{
  ...
  "sap.ui5": {
  ...
    "routing": {
      "config": {
        "routerClass": "sap.m.routing.Router",
        "type": "View",
        "viewType": "XML",
        "path": "ui5.walkthrough.view",
        "controlId": "app",
        "controlAggregation": "pages"
      },
      "routes": [
        {
          "pattern": "",
          "name": "overview",
          "target": "overview"
        },
        {
          "pattern": "detail",
          "name": "detail",
          "target": "detail"
        }
      ],
      "targets": {
        "overview": {
          "id": "overview",
          "name": "Overview"
        },
        "detail": {
          "id": "detail",
          "name": "Detail"
        }
      }
    }
  }
}

I want to find API reference documents that provides the complete list of possible properties in routing and their values but failed to do so.

For example, I want to find what config.controlId and config.controlAggregation mean, but in Routing Configuration page, they are under targets property instead of config, so the page does not provide all possible properties and values.

Besides, Is it possible to list all attributes in a table as something like follows so it's easier to find the property name I'm looking for? I find it difficult to locate a specific property on that Routing Configuration page. For now I have to read through unnecessary lines of text or search in the page to find the property name I need.

For example, currently it's image

It might be easier to navigate if it's something like:

config

Property name Description
routerClass some description
homeRoute some description

Feedback Type (Optional)

content structure

Page Title on SAP Help Portal (prefilled)

No response

Page URL on SAP Help Portal (prefilled)

No response

ziyang-works avatar May 22 '24 13:05 ziyang-works