Skip to content

Commit 54a2633

Browse files
committed
docs(objectstack-ui): document detail.hidePath status-stepper opt-out
Set detail: { hidePath: true } to suppress the auto record:path status stepper when the detected status picklist isn't a linear pipeline (e.g. a field that folds a risk gradient into the status). Mirrors objectui#2062.
1 parent 8ea1f4f commit 54a2633

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

skills/objectstack-ui/SKILL.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,27 @@ regression. Use `tabs` when a record has several substantial child tables that
168168
each deserve first-class navigation; keep `stack` when related lists are
169169
secondary to the main record body.
170170

171+
**Status stepper opt-out — `detail.hidePath`.** The record detail page
172+
auto-detects a "status/stage" field and renders it as a Salesforce Lightning
173+
Path-style stepper at the top, marking every option *before* the current value
174+
as completed. Detection is name/type based (a field named
175+
`status`/`stage`/`state`/`phase`, or typed `status`/`stage`, or the object's
176+
explicit `stageField`) — a plain `select` is **not** auto-promoted.
177+
178+
That stepper is right for a genuine linear pipeline, but wrong when the picklist
179+
isn't one — e.g. a status that folds a **risk gradient** into its options
180+
(`已完成 / 进行中-正常 / … / 进行中-特高风险 / 已逾期`), where "earlier option =
181+
done ✓" misrepresents the record. Suppress it per object:
182+
183+
```typescript
184+
detail: { hidePath: true } // no top status stepper; status shows as a normal field
185+
```
186+
187+
Default (unset) keeps the stepper — zero regression. Prefer fixing the data
188+
model first (split lifecycle vs. risk into two fields, or point `stageField` at
189+
the real pipeline field); reach for `hidePath` when the picklist genuinely
190+
isn't a sequence.
191+
171192
### Field Conditional Rules in Forms
172193

173194
For conditions that belong to a field's lifecycle, declare the rule on the

0 commit comments

Comments
 (0)