Как использовать символ @ в JSDoc?

Question

[Алексей Ярков]

Пытаюсь написать документацию к Vue компоненту. Пишу вот так:

/**
   * <ComponentName value="name"
   *            :getter="objectName"
   *            mode="text"
   *            @active="(mode, name, val) => activeFlag = mode"
   *            @input="(name, val) => objectName[name] = v"
   *            @save="Save"/>
*/

После генерации все что ниже строки * mode="text" отсутствует.
Как экранировать символ @?

Comments

[Сергей delphinpro]

почему не написать v-on:active ?

[Алексей Ярков]

Сергей: Я в курсе что использовать ))) Вопрос в другом.
Ну вот так хочется записать.

[Сергей delphinpro]

Алексей Ярков: так не получится)

[Evgeny Kulakov]

Это не ответ на вопрос) но посмотрите на возможность создания кастомных тегов в файле и потом извлечения инфы из них, как раз про документацию пример: https://vue-loader.vuejs.org/ru/configurations/cus...

[Алексей Ярков]

Evgeny Kulakov: я про это знаю прекрасно, но спасибо за отклик. Вопрос не об этом ))

Answer 1

[Антон Антон]

Использовать v-on и v-bind

Ну, или добавить плагин https://www.npmjs.com/package/jsdoc-escape-at в массив плагинов конфига jsdoc и экранировать обратным слешем

Comments

[Алексей Ярков]

Я в курсе что использовать ))) Вопрос в другом.

[Антон Антон]

Алексей Ярков: ну, в jsdoc @ - служебный символ, обозначающий начало "тега", причем в документации про экранирование ничего не сказано (только про экранирование { и }), так что либо терпеть, либо самому допиливать парсер при наличии компетенции

[Антон Антон]

хотя есть какая-то штука https://www.npmjs.com/package/jsdoc-escape-at (нашел по запросу "jsdoc escape @" ;))

[Алексей Ярков]

Антон Антон: спасибо