perf(ui): use select API in RelationshipProvider to speed up load times in RelationshipCell

[jhb-dev]

What?

Optimize the RelationshipProvider to only select the useAsTitle field when fetching documents via the REST API. This reduces payload size and speeds up loading of the related document title in theRelationshipCell in the table view.

Why?

Previously, when a document had a relationship field, the full document data was requested in the table view, even though the relationship cell only shows the title in the UI. On large collections, this caused unnecessary overhead and slower UI performance.

How?

Applies a select to the REST API request made in the RelationshipProvider, limiting the responses to the useAsTitle field only.

Notes

• I’m not entirely sure whether this introduces a breaking change. If it does, could you suggest a way to make this behavior opt-in?
• For upload enabled collections, the full document must be requested, because the relationship cell needs access to fields like mimeType, thumbailURL etc.
• I hope we can find a way to get this merged. In the Payload projects I work on, this change has significantly improved list view performance.

Similar to #13228

[jacobsfletch]

I’m not entirely sure whether this introduces a breaking change. If it does, could you suggest a way to make this behavior opt-in?

This would be a breaking change if someone were using the useListRelationships hook, e.g. #8568 — but we can just make this conditional based on the new enableListViewSelectAPI property.

[jacobsfletch]

Also quick response here:

For upload enabled collections, the full document must be requested, because the relationship cell needs access to fields like mimeType, thumbailURL etc.

There might be a way to determine upload-specific fields and only select those. Worth exploring.

[jhb-dev]

Thanks for the prompt response, @jacobsfletch. I just made the requested changes!

[JarrodMFlesch]

@jhb-dev we could remove this line (L78), the helper util already checks this condition internally.