nullable ref field

[schmurfy]

Since nullable is now deprecated (and never worked for $ref anyway) I am trying to find how to show a field as nullable.
I found that oneOf with a null type should work but the result shown is not that great, it literally show (with a $ref):

ONE OF
1  NULL 
1 {
    name: string
   }

I was looking a way to show some kind of icon like readonly, is there a better way to do nullable fields ?

[mrin9]

OpenAPI v3.0

  type: string
  nullable: true

in openapi 3.1 types can take multiple values
OpenAPI v3.1

type:
- "string"
- "null" 

check the phone field below which can take null or string

here is the example of this https://mrin9.github.io/RapiDoc/examples/data-types.html#post-/nested-object-in-request-body

all the examples and their spec can be found at docs/examples and docs/specs folder

[schmurfy]

Thanks for the reply but that did not fully answer my question for $ref fields,
I tried the following with no luck:

"user": {
  "$ref": "#/components/schemas/User",
  "type": ["object", "null"]
}

after digging a bit more I realized that the way openapi seems to handle this, and this makes it really useless for me is to add null as an allowed type in the ref:

components:
  schemas:
    User:
      properties:
        ...
      type:
        - object
        - null

I thought that the ref was a bit more clever than that but maybe I should just stop using it altogether since my code is generated anyway... My real problem is more general: OAI/OpenAPI-Specification#2026

and btw when using type array as you shown the way it is displayed is still not that great but that's a nitpick ;)

PS: love the project :)