tabs

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Steedos Tabs | Steedos 标签页

Overview | 概述

Tabs define the navigation items that appear in an application's sidebar. Each tab is a

.tab.yml

file that points to an object, a micro page, or a URL. Tabs are referenced by name in the application's

tabs

array.

标签页定义了应用程序侧边栏中的导航项。每个标签页是一个

.tab.yml

文件，指向一个对象、微页面或 URL。标签页通过名称在应用程序的

tabs

数组中引用。

标签页定义了应用程序侧边栏中的导航项。每个标签页是一个

.tab.yml

文件，指向一个对象、微页面或 URL。标签页通过名称在应用程序的

tabs

数组中引用。

标签页定义了应用程序侧边栏中的导航项。每个标签页是一个

.tab.yml

文件，指向一个对象、微页面或 URL。标签页通过名称在应用程序的

tabs

数组中引用。

File Format | 文件格式

File Extension:
```
.tab.yml
```
Location:
```
main/default/tabs/
```
Format: YAML
Naming:
```
[tab_name].tab.yml
```

文件扩展名：
```
.tab.yml
```
存放位置：
```
main/default/tabs/
```
格式：YAML
命名规则：
```
[tab_name].tab.yml
```

Tab Types | 标签页类型

1. Object Tab | 对象标签页

Displays an object's list view. Most common tab type.

显示对象的列表视图。最常用的标签页类型。

yaml

name: object_contract
desktop: true
icon: collection
label: 合同
mobile: true
object: contract
permissions: []
type: object

显示对象的列表视图。最常用的标签页类型。

yaml

name: object_contract
desktop: true
icon: collection
label: 合同
mobile: true
object: contract
permissions: []
type: object

2. Page Tab | 页面标签页

Renders a micro page (Amis page). Used for dashboards, custom UIs, and landing pages.

渲染微页面（Amis 页面）。用于仪表板、自定义界面和落地页。

yaml

name: page_app_launcher
desktop: true
icon: agent_home
is_new_window: false
is_use_iframe: false
label: 应用
mobile: true
page: app_launcher
permissions: []
type: page

渲染微页面（Amis页面）。用于仪表板、自定义界面和落地页。

yaml

name: page_app_launcher
desktop: true
icon: agent_home
is_new_window: false
is_use_iframe: false
label: 应用
mobile: true
page: app_launcher
permissions: []
type: page

3. URL Tab | URL 标签页

3. URL Tab | URL标签页

Opens an internal or external URL. Can use iframe or new window.

打开内部或外部 URL。可使用 iframe 或新窗口。

yaml

name: admin_swagger
desktop: true
icon: data_model
is_new_window: true
is_use_iframe: true
label: OpenAPI
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user
type: url
url: /api/v6/

打开内部或外部URL。可使用iframe或新窗口。

yaml

name: admin_swagger
desktop: true
icon: data_model
is_new_window: true
is_use_iframe: true
label: OpenAPI
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user
type: url
url: /api/v6/

Field Reference | 字段参考

Required Fields | 必需字段

name (String)

Unique identifier for the tab. This is the name referenced in the application's

tabs

array.

标签页的唯一标识符。这是在应用程序

tabs

数组中引用的名称。

yaml

name: object_contract

标签页的唯一标识符，是在应用程序

tabs

数组中引用的名称。

标签页的唯一标识符。这是在应用程序

tabs

数组中引用的名称。

yaml

name: object_contract

type (String)

⚠️ MUST be one of:
object
,
page
,
url
. No other values are valid. 严禁使用其他值。

Tab type.

yaml

type: object
type: page
type: url

⚠️ 必须为以下值之一：
object
、
page
、
url
。严禁使用其他值。

标签页类型。

yaml

type: object
type: page
type: url

label (String)

Display name shown in the sidebar navigation.

侧边栏导航中显示的名称。

yaml

label: 合同管理

侧边栏导航中显示的名称。

yaml

label: 合同管理

Type-Specific Fields | 类型特定字段

object (String) — for

type: object

object (String) — 适用于

type: object

The object API name to display.

yaml

type: object
object: contracts

要显示的对象API名称。

yaml

type: object
object: contracts

page (String) — for

type: page

page (String) — 适用于

type: page

The micro page name to render.

yaml

type: page
page: app_launcher

要渲染的微页面名称。

yaml

type: page
page: app_launcher

url (String) — for

type: url

url (String) — 适用于

type: url

The URL to open. Supports template variables.

要打开的 URL。支持模板变量。

yaml

type: url
url: /app/admin/space_users/view/${context.user.spaceUserId}

URL Template Variables | URL 模板变量:

Variable	Description
`${context.user.spaceUserId}`	Current user's space_users ID

要打开的URL，支持模板变量。

要打开的 URL。支持模板变量。

yaml

type: url
url: /app/admin/space_users/view/${context.user.spaceUserId}

URL Template Variables | URL模板变量:

变量	描述
`${context.user.spaceUserId}`	当前用户的space_users ID

Optional Fields | 可选字段

desktop (Boolean)

Whether the tab is visible on desktop. Default:

true

yaml

desktop: true

标签页在桌面端是否可见，默认值：

true

。

yaml

desktop: true

mobile (Boolean)

Whether the tab is visible on mobile. Default:

true

yaml

mobile: true

标签页在移动端是否可见，默认值：

true

。

yaml

mobile: true

icon (String)

⚠️ MUST be a valid SLDS icon name from the objects skill Valid Icon Values list. Do NOT invent icon names. If no icon matches, use
custom
or
record
.

⚠️ 必须为对象 skill 有效图标列表中的有效 SLDS 图标名称，严禁编造。如无匹配，使用
custom
或
record
。

Salesforce Lightning Design System icon name.

yaml

icon: contract
icon: agent_home
icon: data_model

⚠️ 必须为对象skill 有效图标列表中的有效SLDS图标名称，严禁编造。如无匹配，使用
custom
或
record
。

⚠️ 必须为对象skill 有效图标列表中的有效 SLDS 图标名称，严禁编造。如无匹配，使用
custom
或
record
。

Salesforce Lightning Design System图标名称。

yaml

icon: contract
icon: agent_home
icon: data_model

is_new_window (Boolean)

Whether to open in a new browser window/tab. Default:

false

是否在新浏览器窗口/标签页中打开。默认：

false

。

yaml

is_new_window: true

是否在新浏览器窗口/标签页中打开，默认值：

false

。

是否在新浏览器窗口/标签页中打开。默认：

false

。

yaml

is_new_window: true

is_use_iframe (Boolean)

Whether to render the content in an iframe within the app. Default:

false

. Typically used with URL tabs.

是否在应用内使用 iframe 渲染内容。默认：

false

。通常与 URL 标签页配合使用。

yaml

is_use_iframe: true

是否在应用内使用iframe渲染内容，默认值：

false

，通常与URL标签页配合使用。

是否在应用内使用 iframe 渲染内容。默认：

false

。通常与 URL 标签页配合使用。

yaml

is_use_iframe: true

locked (Boolean)

Whether the tab configuration is locked from editing in the UI.

yaml

locked: false

标签页配置是否在UI中被锁定无法编辑。

yaml

locked: false

license (Array)

License tiers required to access this tab.

访问此标签页所需的许可证级别。

yaml

license:
  - platform-professional
  - platform-enterprise

访问此标签页所需的许可证级别。

yaml

license:
  - platform-professional
  - platform-enterprise

Permissions | 权限

Control tab visibility per permission set. Each entry has

permission

(⚠️ MUST be
'on'
or
'off'
, no other values) and

permission_set

按权限集控制标签页可见性。每个条目有

permission

（⚠️ 必须为
'on'
或
'off'
）和

permission_set

。

yaml

permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'on'
    permission_set: user
  - permission: 'off'
    permission_set: customer
  - permission: 'off'
    permission_set: supplier
  - permission: 'off'
    permission_set: organization_admin
  - permission: 'off'
    permission_set: workflow_admin

An empty

permissions: []

means the tab is visible to all users.

空的

permissions: []

表示标签页对所有用户可见。

按权限集控制标签页可见性。每个条目包含

permission

（⚠️ 必须为
'on'
或
'off'
，不允许其他值）和

permission_set

。

按权限集控制标签页可见性。每个条目有

permission

（⚠️ 必须为
'on'
或
'off'
）和

permission_set

。

yaml

permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'on'
    permission_set: user
  - permission: 'off'
    permission_set: customer
  - permission: 'off'
    permission_set: supplier
  - permission: 'off'
    permission_set: organization_admin
  - permission: 'off'
    permission_set: workflow_admin

空的

permissions: []

表示标签页对所有用户可见。

空的

permissions: []

表示标签页对所有用户可见。

Complete Examples | 完整示例

Object Tab — Business Object | 对象标签页 — 业务对象

yaml

name: object_pepsico_material
desktop: true
icon: contact_list
label: 材料素材
mobile: true
object: pepsico_material
permissions: []
type: object

yaml

name: object_pepsico_material
desktop: true
icon: contact_list
label: 材料素材
mobile: true
object: pepsico_material
permissions: []
type: object

Object Tab — Admin Only | 对象标签页 — 仅管理员

yaml

name: admin_apps
desktop: true
icon: apps
is_new_window: false
label: 应用程序
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user
  - permission: 'off'
    permission_set: customer
  - permission: 'off'
    permission_set: supplier
  - permission: 'off'
    permission_set: organization_admin
  - permission: 'off'
    permission_set: workflow_admin
type: object
object: apps

yaml

name: admin_apps
desktop: true
icon: apps
is_new_window: false
label: 应用程序
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user
  - permission: 'off'
    permission_set: customer
  - permission: 'off'
    permission_set: supplier
  - permission: 'off'
    permission_set: organization_admin
  - permission: 'off'
    permission_set: workflow_admin
type: object
object: apps

Page Tab — Dashboard | 页面标签页 — 仪表板

yaml

name: page_app_store
desktop: true
icon: product_consumed
is_new_window: false
is_use_iframe: false
label: App Store
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user
type: page
page: app_store

yaml

name: page_app_store
desktop: true
icon: product_consumed
is_new_window: false
is_use_iframe: false
label: App Store
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user
type: page
page: app_store

URL Tab — External Tool | URL 标签页 — 外部工具

URL Tab — External Tool | URL标签页 — 外部工具

yaml

name: nodered
desktop: true
icon: incident
is_new_window: true
is_use_iframe: false
label: Node-RED
locked: false
mobile: true
permissions:
  - permission: 'off'
    permission_set: user
type: url
url: /flows

yaml

name: nodered
desktop: true
icon: incident
is_new_window: true
is_use_iframe: false
label: Node-RED
locked: false
mobile: true
permissions:
  - permission: 'off'
    permission_set: user
type: url
url: /flows

URL Tab — Embedded Dashboard | URL 标签页 — 嵌入仪表板

URL Tab — Embedded Dashboard | URL标签页 — 嵌入仪表板

yaml

name: material_kanban
desktop: true
icon: app
is_new_window: false
is_use_iframe: true
label: 看板
locked: false
mobile: false
permissions: []
type: url
url: /analytics/embed/dashboard/6788be6a41162b06257df7a9#titled=false&bordered=false

yaml

name: material_kanban
desktop: true
icon: app
is_new_window: false
is_use_iframe: true
label: 看板
locked: false
mobile: false
permissions: []
type: url
url: /analytics/embed/dashboard/6788be6a41162b06257df7a9#titled=false&bordered=false

URL Tab — Dynamic URL with Context | URL 标签页 — 带上下文的动态 URL

URL Tab — Dynamic URL with Context | URL标签页 — 带上下文的动态URL

yaml

name: admin_personal_information
desktop: true
icon: user_role
is_new_window: false
label: 个人资料
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'on'
    permission_set: user
type: url
url: /app/admin/space_users/view/${context.user.spaceUserId}

yaml

name: admin_personal_information
desktop: true
icon: user_role
is_new_window: false
label: 个人资料
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'on'
    permission_set: user
type: url
url: /app/admin/space_users/view/${context.user.spaceUserId}

Tab with License Restriction | 带许可证限制的标签页

yaml

name: admin_ai_chatbots
desktop: true
icon: live_chat
is_new_window: false
label: Chatbots
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user
type: object
object: ai_chatbots
license:
  - platform-professional
  - platform-enterprise

yaml

name: admin_ai_chatbots
desktop: true
icon: live_chat
is_new_window: false
label: Chatbots
mobile: true
permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user
type: object
object: ai_chatbots
license:
  - platform-professional
  - platform-enterprise

Relationship with Applications | 与应用程序的关系

Tabs are referenced in

.app.yml

files via the

tabs

array. The tab

name

is used as the reference key.

标签页通过

tabs

数组在

.app.yml

文件中引用。标签页的

name

作为引用键。

yaml

undefined

标签页通过

tabs

数组在

.app.yml

文件中引用，标签页的

name

作为引用键。

标签页通过

tabs

数组在

.app.yml

文件中引用。标签页的

name

作为引用键。

yaml

undefined

In application .app.yml

tabs:

page_app_launcher
core_announcements
core_tasks

tab_items: page_app_launcher: group: '' index: 1 core_announcements: group: 协作 index: 2 core_tasks: group: 协作 index: 3

tab_groups:

group_name: 协作 default_open: true


When an application's `tabs` array includes a name that matches no `.tab.yml` file, the system treats it as an implicit object tab (directly using the name as the object API name).

当应用程序的 `tabs` 数组包含的名称没有匹配的 `.tab.yml` 文件时，系统将其视为隐式对象标签页（直接将名称作为对象 API 名称）。

tabs:

page_app_launcher
core_announcements
core_tasks

tab_items: page_app_launcher: group: '' index: 1 core_announcements: group: 协作 index: 2 core_tasks: group: 协作 index: 3

tab_groups:

group_name: 协作 default_open: true


当应用程序的`tabs`数组包含的名称没有匹配的`.tab.yml`文件时，系统将其视为隐式对象标签页（直接将名称作为对象API名称）。

当应用程序的 `tabs` 数组包含的名称没有匹配的 `.tab.yml` 文件时，系统将其视为隐式对象标签页（直接将名称作为对象 API 名称）。

File Location | 文件位置

steedos-packages/
└── my-package/
    └── main/
        └── default/
            ├── tabs/
            │   ├── object_contract.tab.yml
            │   ├── page_dashboard.tab.yml
            │   └── admin_settings.tab.yml
            └── applications/
                └── my_app.app.yml

steedos-packages/
└── my-package/
    └── main/
        └── default/
            ├── tabs/
            │   ├── object_contract.tab.yml
            │   ├── page_dashboard.tab.yml
            │   └── admin_settings.tab.yml
            └── applications/
                └── my_app.app.yml

Naming Conventions | 命名约定

Pattern	Use Case	Example
`object_{name}`	Object tabs for business objects	`object_contract`
`admin_{name}`	Admin-only tabs	`admin_apps`
`page_{name}`	Page tabs	`page_app_launcher`
`core_{name}`	Core platform tabs	`core_tasks`

命名模式	使用场景	示例
`object_{name}`	业务对象的对象标签页	`object_contract`
`admin_{name}`	仅管理员可见的标签页	`admin_apps`
`page_{name}`	页面标签页	`page_app_launcher`
`core_{name}`	平台核心标签页	`core_tasks`

Best Practices | 最佳实践

1. Permission Configuration

Always explicitly set permissions for admin-only tabs:

始终为仅管理员标签页明确设置权限：

yaml

permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user

For tabs visible to all users, use empty permissions:

对所有用户可见的标签页，使用空权限：

yaml

permissions: []

始终为仅管理员可见的标签页明确设置权限：

始终为仅管理员标签页明确设置权限：

yaml

permissions:
  - permission: 'on'
    permission_set: admin
  - permission: 'off'
    permission_set: user

对所有用户可见的标签页，使用空权限配置：

对所有用户可见的标签页，使用空权限：

yaml

permissions: []

2. iframe vs New Window

Use
```
is_use_iframe: true
```
for embedded dashboards and tools that should stay within the app
Use
```
is_new_window: true
```
for external tools like Node-RED that need their own window
Don't combine both — choose one approach
使用
```
is_use_iframe: true
```
嵌入仪表板和需要留在应用内的工具
使用
```
is_new_window: true
```
用于像 Node-RED 这样需要独立窗口的外部工具
不要同时使用两者 — 选择一种方式

对于需要留在应用内的嵌入仪表板和工具，使用
```
is_use_iframe: true
```
对于像Node-RED这样需要独立窗口的外部工具，使用
```
is_new_window: true
```
不要同时使用两者——选择一种方式
使用
```
is_use_iframe: true
```
嵌入仪表板和需要留在应用内的工具
使用
```
is_new_window: true
```
用于像 Node-RED 这样需要独立窗口的外部工具
不要同时使用两者 — 选择一种方式

3. Mobile Visibility

Set

mobile: false

for tabs that don't work well on mobile (e.g., complex dashboards, iframe embeds):

对不适合移动端的标签页设置

mobile: false

（如复杂仪表板、iframe 嵌入）：

yaml

desktop: true
mobile: false

对不适合移动端的标签页（如复杂仪表板、iframe嵌入）设置

mobile: false

：

对不适合移动端的标签页设置

mobile: false

（如复杂仪表板、iframe 嵌入）：

yaml

desktop: true
mobile: false

Troubleshooting | 故障排除

Issue: Tab not appearing in sidebar

Solutions:

Verify the tab
```
name
```
is listed in the application's
```
tabs
```
array
Check
```
permissions
```
— user must have
```
permission: 'on'
```
for their permission_set
Ensure
```
desktop: true
```
(or
```
mobile: true
```
for mobile)
Check
```
license
```
restrictions if present

解决方案:

确认标签页
```
name
```
已在应用程序的
```
tabs
```
数组中列出
检查
```
permissions
```
配置——用户所属的permission_set必须设置为
```
permission: 'on'
```
确保
```
desktop: true
```
（移动端需确保
```
mobile: true
```
）
如果有配置
```
license
```
，检查许可证限制

Issue: URL tab showing blank

Solutions:

For iframe embeds, ensure
```
is_use_iframe: true
```
Check the target URL allows iframe embedding (X-Frame-Options)
Verify the URL path is correct and accessible

解决方案:

对于iframe嵌入，确保
```
is_use_iframe: true
```
检查目标URL是否允许iframe嵌入（X-Frame-Options设置）
验证URL路径是否正确且可访问

Issue: Page tab not rendering

Solutions:

Verify the
```
page
```
value matches an existing micro page name
Ensure the micro page
```
.page.yml
```
and
```
.page.amis.json
```
files exist
Check page permissions

解决方案:

确认
```
page
```
值与现有微页面名称匹配
确保微页面的
```
.page.yml
```
和
```
.page.amis.json
```
文件存在
检查页面权限配置

References | 参考资料

Applications — how tabs are used in app configuration
Micro Pages — creating pages for page tabs
Object Permissions — permission sets referenced in tab permissions
Salesforce Lightning Icons

Applications — 标签页在应用配置中的使用方式
Micro Pages — 为页面标签页创建微页面
Object Permissions — 标签页权限中引用的权限集
Salesforce Lightning Icons

tabs

Original

Translation

Steedos Tabs | Steedos 标签页

Steedos Tabs | Steedos 标签页

Overview | 概述

Overview | 概述

File Format | 文件格式

File Format | 文件格式

Tab Types | 标签页类型

Tab Types | 标签页类型

1. Object Tab | 对象标签页

1. Object Tab | 对象标签页

2. Page Tab | 页面标签页

2. Page Tab | 页面标签页

3. URL Tab | URL 标签页

3. URL Tab | URL标签页

Field Reference | 字段参考

Field Reference | 字段参考

Required Fields | 必需字段

Required Fields | 必需字段

name (String)

name (String)

type (String)

type (String)

label (String)

label (String)

Type-Specific Fields | 类型特定字段

Type-Specific Fields | 类型特定字段

object (String) — for type: object

object (String) — 适用于type: object

page (String) — for type: page

page (String) — 适用于type: page

url (String) — for type: url

url (String) — 适用于type: url

Optional Fields | 可选字段

Optional Fields | 可选字段

desktop (Boolean)

desktop (Boolean)

mobile (Boolean)

mobile (Boolean)

icon (String)

icon (String)

is_new_window (Boolean)

is_new_window (Boolean)

is_use_iframe (Boolean)

is_use_iframe (Boolean)

locked (Boolean)

locked (Boolean)

license (Array)

license (Array)

Permissions | 权限

Permissions | 权限

Complete Examples | 完整示例

Complete Examples | 完整示例

Object Tab — Business Object | 对象标签页 — 业务对象

Object Tab — Business Object | 对象标签页 — 业务对象

Object Tab — Admin Only | 对象标签页 — 仅管理员

Object Tab — Admin Only | 对象标签页 — 仅管理员

Page Tab — Dashboard | 页面标签页 — 仪表板

Page Tab — Dashboard | 页面标签页 — 仪表板

URL Tab — External Tool | URL 标签页 — 外部工具

URL Tab — External Tool | URL标签页 — 外部工具

URL Tab — Embedded Dashboard | URL 标签页 — 嵌入仪表板

URL Tab — Embedded Dashboard | URL标签页 — 嵌入仪表板

URL Tab — Dynamic URL with Context | URL 标签页 — 带上下文的动态 URL

URL Tab — Dynamic URL with Context | URL标签页 — 带上下文的动态URL

Tab with License Restriction | 带许可证限制的标签页

Tab with License Restriction | 带许可证限制的标签页

Relationship with Applications | 与应用程序的关系

Relationship with Applications | 与应用程序的关系

In application .app.yml

In application .app.yml

File Location | 文件位置

File Location | 文件位置

Naming Conventions | 命名约定

Naming Conventions | 命名约定

Best Practices | 最佳实践

Best Practices | 最佳实践

1. Permission Configuration

object (String) — for
`type: object`

object (String) — 适用于
`type: object`

page (String) — for
`type: page`

page (String) — 适用于
`type: page`

url (String) — for
`type: url`

url (String) — 适用于
`type: url`